Procesar una devolução Pix iniciada por el banco del beneficiario
Procesa una devolução Pix iniciada por el banco del beneficiario y enviada por el sistema upstream; este endpoint no inicia la devolución. Acredita al pagador original el monto devuelto, sujeto a un tope acumulativo sobre los montos devueltos, deduplica sobre el end-to-end id de retorno asignado por el upstream y devuelve el acuse de crédito del settlement-gateway.
Autorizaciones
Autenticación con token JWT Bearer. Obtén el token desde el endpoint /v1/login/oauth/access_token
usando credenciales de cliente (clientId y clientSecret).
Incluye el token en el encabezado Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
El token expira después de 3600 segundos (1 hora).
Cuerpo
Id de retorno asignado por el upstream (clave de idempotencia + deduplicación).
End-to-end id del CASH_OUT original.
Id de solicitud del upstream (GUID), reflejado en el acuse.
Monto de retorno en reales (un número JSON).
Código de motivo de retorno (eRefundCode).
Información entre clientes de texto libre.
Motivo de retorno de texto libre.
Respuesta
OK
Marca de tiempo del crédito del settlement-gateway (ISO-8601).
Marca de tiempo de la validación (ISO-8601).
Id de crédito del settlement-gateway.
Id de solicitud del upstream, reflejado.
Código de motivo (en un retorno rechazado).
Complemento del motivo.
Resultado de la validación (0=Inválido, 1=Válido).

