Floid Developers Contáctanos

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

NombreTipoDescripció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.