Iniciar una transferencia Pix
Usa este endpoint para iniciar un cash-out Pix creando un registro de iniciación. Este endpoint recupera y valida la información de destino sin mover fondos.
Notas:
-
Este endpoint admite tres tipos de iniciación: MANUAL (datos completos de la cuenta), KEY (usando una clave Pix) y QR_CODE (usando un código QR).
-
Para la iniciación KEY, el plugin consulta el servicio DICT para recuperar la información de la cuenta de destino.
-
Para la iniciación QR_CODE, el plugin decodifica el código QR y consulta el servicio DICT para recuperar la información de la cuenta de destino.
-
La iniciación no mueve fondos: solo valida y prepara la transferencia.
-
Tras una iniciación exitosa, usa el endpoint Process para completar la transferencia.
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).
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
Tipo de inicio.
MANUAL, KEY, QR_CODE "KEY"
Monto de la transferencia.
"100.00"
Clave Pix (obligatoria para el tipo KEY).
"john.doe@example.com"
Payload EMV del código QR (obligatorio para el tipo QR_CODE).
Descripción de la transferencia.
"Payment for services"
Respuesta
Iniciación del cash-out Pix creada 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.