Procesar una transferencia Pix
Usa este endpoint para procesar un cash-out Pix iniciado previamente y mover fondos entre cuentas.
Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Encabezados
Identificador único de la cuenta del Ledger de Midaz (formato UUID).
Propósito de la transacción para el cash-out. Su valor predeterminado es TRANSFER cuando se omite.
TRANSFER, CHANGE, WITHDRAWAL, REFUND_AUTOMATIC_PIX, INSTANT_PAYMENT_REFUND, INSTALLMENT_PIX Clave de idempotencia opcional para reintentos seguros. Reutiliza el mismo valor solo cuando reintentas la misma operación tras un resultado desconocido.
Consulta Reintentos e idempotencia para más detalles.
Tiempo de vida en segundos para la caché de la clave de idempotencia. Define cuánto tiempo el sistema recuerda una solicitud procesada.
Consulta Reintentos e idempotencia para más detalles.
Cuerpo
ID de inicio obtenido en el paso de inicio.
"019c96a0-0c82-7c3d-8dcc-c180868b45c4"
Monto de la transferencia en BRL (formato 0.00). Para códigos QR con
un monto fijo, este debe coincidir con el monto codificado en el código QR.
"100.50"
Descripción o mensaje opcional.
140"Payment for services"
Atributos personalizados de clave-valor para esta transferencia. Máximo 50 claves, clave de máximo 100 caracteres, valor de máximo 2000 caracteres.
Respuesta
Transferencia Pix procesada correctamente.
La respuesta incluye el encabezado X-Idempotency-Replayed.
Si el valor es false, la transacción se acaba de procesar. Si el valor es true, la respuesta es una repetición de una solicitud procesada anteriormente.
Consulta Reintentos e idempotencia para obtener más detalles.
Identificador único de la transferencia.
"019c96a0-0c21-71f9-a487-66a1258278a1"
Identificador de extremo a extremo.
"E123456789BR1234567890123456789"
Monto de la transferencia en BRL (formato 0.00).
"100.00"
Estado de la transferencia.
CREATED, PENDING, PROCESSING, COMPLETED, FAILED, REVERSED "COMPLETED"
Tipo de transferencia.
CASHOUT, CASHIN "CASHOUT"
Descripción o mensaje opcional.
140"Pix Cashout Transfer"
Información de la parte de la cuenta (origen o destino).
Información de la parte de la cuenta (origen o destino).
Tipo de pago.
IMMEDIATE, SCHEDULED "IMMEDIATE"
Tipo de iniciación.
MANUAL, KEY, QR_CODE "KEY"
Urgencia de la transferencia.
HIGH, NORMAL "HIGH"
Tipo de finalidad de la transacción. El valor predeterminado es TRANSFER.
TRANSFER, INSTANT_PAYMENT_REFUND "TRANSFER"
Identificador de la cuenta (UUID).
"01989f9e-6508-79f8-9540-835be49fbd0d"
Identificador del alias (UUID).
"01989f9e-6508-79f8-9540-835be49fbd0e"
Marca de tiempo de la iniciación (ISO 8601 UTC).
"2024-01-15T10:30:00Z"
"2024-01-15T10:30:00Z"
"2024-01-15T10:30:00Z"
Identificadores de transacción y operación del ledger de Midaz.
Atributos personalizados de clave-valor asociados con esta transferencia. Máximo 50 claves, clave de máximo 100 caracteres, valor de máximo 2000 caracteres.
Detalles del cálculo de tarifas (si corresponde).

