Reference
API Reference
Une API REST prévisible : JSON en entrée et en sortie, montants en unités mineures, créations idempotentes et erreurs normalisées.
Base URL
Sandbox
https://api.validif.com/v1
L'URL de production est communiquée à votre société après approbation. Voir Request Production Access.
Conventions
| Champ | Type | Description |
|---|---|---|
| amount | integer | Toujours en unités mineures (250000 = 2 500,00). |
| currency | string | Code ISO 4217 en majuscules. |
| id | string | Identifiant opaque préfixé par type d'objet. |
| status | string | État issu d'une machine à états stricte. |
| created_at | string | Horodatage ISO 8601 en UTC. |
Idempotence
Envoyez un en-tête Idempotency-Key unique par opération métier sur chaque création. Rejouer le même appel avec la même clé renvoie l'objet initial ; réutiliser la clé avec un autre payload renvoie idempotency_conflict (409).
Pagination
Les endpoints de liste renvoient les objets les plus récents d'abord et acceptent limit. Les résultats sont toujours limités à votre propre société.
Endpoints
| Champ | Type | Description |
|---|---|---|
| POST /v1/payment_intents | Payments | Créer une intention de paiement. |
| POST /v1/payment_intents/:id/authorize | Payments | Autoriser le paiement. |
| POST /v1/payment_intents/:id/capture | Payments | Capturer un paiement autorisé. |
| POST /v1/payment_intents/:id/cancel | Payments | Annuler un paiement non capturé. |
| GET /v1/payment_intents/:id | Payments | Lire une intention de paiement. |
| GET /v1/payment_intents | Payments | Lister les intentions de paiement. |
| POST /v1/payouts | Payouts | Créer un payout vers une destination éligible. |
| GET /v1/payouts/:id | Payouts | Lire un payout. |
| GET /v1/payouts | Payouts | Lister les payouts. |
Détail des paramètres et des transitions : Payments, Payouts, Webhooks et Errors.