Floid Developers Contáctanos

pagos.payin_pe.consultar

Estado de un payin (pago entrante) en Perú, por transferencia, Yape o pago de servicios (CIP).

Lectura Sin credenciales del titular Ver ficha en JSON

Antes de usarla

  • Estados: PENDING, SUCCESS, SUCCESS_OVERPAID y SUCCESS_UNDERPAID (pagó de más o de menos, solo transferencia), EXPIRED y CANCELED.

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_pe.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_pe.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_pe.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.