Concepts
Modèle mental des paiements FreeGate.
Cette section explique le modèle derrière l'API : les statuts d'une transaction, le cycle de vie de chaque opération, le settlement différé et le rôle des wallets.
Types de transaction
| Type | Sens de l'argent | Endpoint de création |
|---|---|---|
PAYIN | Du client vers votre wallet | POST /v1/payins |
PAYOUT | De votre wallet vers un bénéficiaire | POST /v1/payouts |
REFUND | Restitution d'un payin réussi | POST /v1/refunds |
Statuts d'une transaction
Cinq statuts couvrent toute la vie d'une transaction. Elle reste PENDING
pendant tout le traitement, même quand une action du payeur est attendue. Puis
elle atteint un statut terminal. Vous n'avez pas d'autre état à gérer.
| Statut | Signification |
|---|---|
PENDING | En cours de traitement |
SUCCESS | Terminé avec succès |
FAILED | Échec définitif |
REFUNDED | Remboursé intégralement |
PARTIALLY_REFUNDED | Remboursé partiellement |
Ces cinq statuts sont les seuls que vous rencontrerez : la ressource transaction et les webhooks utilisent le même vocabulaire. Voir Webhooks.
Poursuivez avec :
- Cycle de vie — les transitions payin / payout / refund.
- Traiter nextAction — quoi faire après un payin.
- Settlement différé —
settlesAt/settledAt. - Wallets — soldes réservés et disponibles.