Confirmar un payout por QR (Bolivia, Brasil)
Paso 2 del payout por QR (Bolivia y Brasil/PIX), cobrado exactamente igual que un payout normal: el monto local se convierte a la tasa de tu cuenta y se debita usdt_amount + comisión fija. El resultado es síncrono — la respuesta trae el estado final (completed, o failed con reembolso automático). Requiere una llave de idempotencia como toda operación que mueve dinero. En Bolivia la referencia escaneada es de un solo uso (un QR = un pago); en Brasil un QR PIX estático es reutilizable por diseño — págalo de nuevo con una llave distinta, y un intento fallido jamás inutiliza el QR. amount es siempre obligatorio; en Brasil, si el QR PIX trae monto fijo debe coincidir exacto — un mismatch responde 422 con el payout en status: failed y el reembolso ya aplicado (los QR de monto abierto pagan lo que envíes).
Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Encabezados
Alternativa al campo idempotency_key del body.
Cuerpo
Del paso de escaneo.
Monto local como string decimal positivo.
BO, BR BOB, USD, BRL Saldo virtual a debitar para esta operación. Omítelo para usar el asset de settlement predeterminado de tu cuenta.
USDT, USDC, BTC, GOLD Respuesta
Respuesta idempotente de un payout por QR existente.
La tasa de tu cuenta al momento de la ejecución (unidades locales por 1 USDT).
Saldo virtual desde el que realmente se debitó la operación.
USDT, USDC, BTC, GOLD Monto exacto debitado del saldo del asset de settlement (en unidades de ese asset). Es igual a total_debit cuando el asset es USDT. Si el payout falla se reembolsa este monto exacto — nunca se re-cotiza.
Precio USD efectivo por unidad del asset de settlement usado para convertir el total en USDT ("1" para USDT/USDC).
pending, processing, completed, failed Presente (true) cuando la respuesta es una repetición idempotente.