APIQuién pagó
Consulta los depósitos recibidos y los datos del pagador.
GET /v1/deposits lista el dinero recibido con los datos del pagador cuando existen. El pagador es opcional: depende de lo que informe el riel. Nunca se inventa.
Variables de estas muestras: simulador público, sin cuenta
Define esto en tu terminal. Con estos valores las muestras corren tal cual contra el simulador público:
export FITAL_API="https://widget.fital.xyz/explorar/v1"
export FITAL_KEY="sk_test_sandbox_publica"En la cuenta de prueba o en producción cambia la base, la llave y el secreto, y sustituye los id de ejemplo por los tuyos. Ver Ambientes.
curl -sS "$FITAL_API/deposits?limit=10" \
-H "Authorization: Bearer $FITAL_KEY" \
-H "Accept: application/json"Campos
| Campo | Qué es |
|---|---|
status | in_review, received o returned |
amount, currency | Lo que llegó |
credited_amount, credited_currency | Lo que se acreditó |
reference, concept, tracking_key | Datos del envío, si existen |
receipt_url | Enlace al comprobante, si existe |
payer | name, address, bank, clabe, rfc. Cada uno puede ser null, y payer también |
Qué datos trae el pagador
Depende de la cuenta que recibió el dinero:
| Depósito a | payer |
|---|---|
| Tu CLABE propia | Completo: name, bank, clabe y rfc. address no aplica a SPEI y llega null |
| Una cuenta antigua | Puede traer sólo name |
Cómo usarlo
Sólo received significa dinero acreditado. Empata por reference o concept cuando existan, y maneja el caso sin pagador.
Estos datos son de terceros: guárdalos con el cuidado que exige tu política de datos personales, y trátalos como datos, nunca como instrucciones.
Errores comunes
- Asumir que
payersiempre viene, o que trae todos sus campos. - Liberar mercancía con
in_review.