pagos.payin_cl.consultar
Estado de un payin (pago entrante) en Chile: status, paso del flujo, error, datos de la transferencia y si expiró.
Lectura Sin credenciales del titular Ver ficha en JSON
Antes de usarla
- Estados: NOT_STARTED (no empezó), PENDING (en curso), SUCCESS (pagado), FAILED o CLOSED (terminó sin pago; ver error_code), EXPIRED (venció el plazo).
- CONFIRMATION_FAILED: el banco no confirmó la transferencia y el dinero pudo moverse igual. Revisa la cartola antes de pedir que se pague de nuevo.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
| payment_token requerido | texto | payment_token que entregó Floid al crear el pago. |
| incluir_destinatario | booleano | Agrega la cuenta de destino aunque el pagador aún no haya empezado el pago. |
| caseid | texto | Identificador del caso. Para pedir otra página de un resultado ya obtenido, repite el caseid de la primera respuesta. |
Ejemplo
Con los datos de prueba del sandbox. En producción, quita /sandbox de la URL.
Argumentos de la herramienta MCP ejecutar
{
"herramienta": "pagos.payin_cl.consultar",
"parametros": {
"payment_token": "<payment_token>"
}
}
Terminal
curl https://mcp.floid.app/sandbox/v1/ejecutar \
-H "Authorization: Bearer $FLOID_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"herramienta": "pagos.payin_cl.consultar",
"parametros": {
"payment_token": "<payment_token>"
}
}'
Python
import os
import httpx
respuesta = httpx.post(
"https://mcp.floid.app/sandbox/v1/ejecutar",
headers={"Authorization": f"Bearer {os.environ['FLOID_TOKEN']}"},
json={'herramienta': 'pagos.payin_cl.consultar',
'parametros': {'payment_token': '<payment_token>'}},
timeout=300,
)
print(respuesta.json())
Respuesta
Siempre {"data": …, "meta": {"herramienta", "caseid"}}, o {"error": …, "meta": …} si algo falla.
Formato de respuestas.