Guías
Seguir tus pagos
Consulta en qué quedó cada payin (lo que te pagan tus clientes) y cada payout (lo que tú pagas), en Chile y Perú. Solo lectura: estas herramientas no crean, cancelan ni mueven pagos.
Qué herramienta usar
| Quieres saber | Herramienta | Con |
|---|---|---|
| Si un cliente pagó en Chile | pagos.payin_cl.consultar | payment_token |
| Si un cliente pagó en Perú | pagos.payin_pe.consultar | payment_token |
| Si se pagó una transferencia tuya en Chile | pagos.payout_cl.consultar | payout_caseid |
| De quién es una cuenta en Perú, antes de pagarle | pagos.cuenta_pe.validar | CCI y moneda |
El payment_token y el payout_caseid los entrega Floid al crear el pago y llegan también en el webhook.
No se piden credenciales del titular: basta el token Floid de tu empresa, y cada empresa ve solo sus pagos.
Cómo leer un payin de Chile
El pagador avanza por pasos (step): LANDING, ENTER_CREDENTIALS, SELECT_ACCOUNT, AUTH_METHOD, VALIDATION y FINISHED.
Si el pago no terminó, el paso dice dónde se quedó.
| status | Qué significa | Qué hacer |
|---|---|---|
NOT_STARTED | El pagador aún no abre el link. | Esperar o recordarle. |
PENDING | El pagador está en el flujo. | Esperar el webhook o volver a consultar. |
SUCCESS | Pagado. | Entregar el producto. |
FAILED o CLOSED | Terminó sin pago. error_code dice por qué. | Ofrecer pagar de nuevo. |
EXPIRED | Venció el plazo del link. | Crear un pago nuevo. |
CONFIRMATION_FAILED | El banco no confirmó la transferencia, pero el dinero pudo moverse igual. | Revisar la cartola antes de pedir que pague de nuevo. |
Perú
Un payin de Perú termina en SUCCESS, EXPIRED o CANCELED. Si fue por transferencia,
SUCCESS_OVERPAID y SUCCESS_UNDERPAID avisan que pagó de más o de menos.
Antes de un payout, valida la cuenta: con documento o nombre, la respuesta trae
validation en true o false. Para cuentas BCP envía también numero_cuenta.
Payouts de Chile
status SUCCESSFUL significa pagado. ERROR significa que no se pagó, y el motivo viene en data.error_message.
En sandbox
Por https://mcp.floid.app/sandbox se consultan los pagos creados como pagos de prueba. Mira la guía de sandbox.