Floid Developers Contáctanos

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 saberHerramientaCon
Si un cliente pagó en Chilepagos.payin_cl.consultarpayment_token
Si un cliente pagó en Perúpagos.payin_pe.consultarpayment_token
Si se pagó una transferencia tuya en Chilepagos.payout_cl.consultarpayout_caseid
De quién es una cuenta en Perú, antes de pagarlepagos.cuenta_pe.validarCCI 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ó.

statusQué significaQué hacer
NOT_STARTEDEl pagador aún no abre el link.Esperar o recordarle.
PENDINGEl pagador está en el flujo.Esperar el webhook o volver a consultar.
SUCCESSPagado.Entregar el producto.
FAILED o CLOSEDTerminó sin pago. error_code dice por qué.Ofrecer pagar de nuevo.
EXPIREDVenció el plazo del link.Crear un pago nuevo.
CONFIRMATION_FAILEDEl 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.