Skip to main content
POST
Relancer un paiement échoué
Réutilise le même id de transaction — aucune nouvelle transaction n’est créée. Réservé aux paiements entrants (flow_direction: "INBOUND") ; un payout renvoie 400 invalid_flow.

Éviter un doublon en cas de coupure réseau

Le header Idempotency-Key est optionnel : sans lui, chaque appel relance le paiement — un simple retry réseau le relance donc une seconde fois. Avec lui, renvoyer la même clé après un timeout vous renvoie la réponse d’origine au lieu de rejouer l’opération. Un timeout n’est jamais la preuve qu’une requête a échoué : elle a pu aboutir côté serveur. C’est précisément ce cas que la clé couvre.
Générez une clé par intention (un UUID convient), et réutilisez-la pour chaque retry de cette même tentative. Réutiliser une clé avec un corps différent renvoie 409. Détails : Idempotence.

Authorizations

Authorization
string
header
required

Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx (ou sk_test_xxx en environnement de test).

Headers

Idempotency-Key
string

Identifiant unique que vous générez pour cette tentative (un UUID par exemple). Optionnel : sans lui, chaque appel est traité comme une nouvelle demande. Avec lui, si vous renvoyez la même clé — après un timeout ou une coupure réseau — AlphaPay renvoie la réponse d'origine au lieu de créer un second paiement. Réutilisez la même clé pour les retrys d'une même tentative, changez-en pour toute nouvelle intention. La même clé avec un corps de requête différent renvoie une erreur 409. Voir Idempotence.

Maximum string length: 255

Path Parameters

payment_id
string<uuid>
required

Body

application/json
methods
string[]

Codes réseau à essayer, dans l'ordre. Défaut : réseau d'origine de la transaction.

Example:
customer
object
preferred_gateway
string

Response

Paiement relancé (même id de transaction)