Skip to main content
POST
Créer un lien de paiement
Aucun header Idempotency-Key requis sur cet endpoint (dette technique connue) — un double-clic ou un retry réseau côté intégrateur peut créer deux liens distincts.
Aucune validation croisée serveur entre amount_type et amount : rien n’empêche de créer un lien FIXED sans amount. Vérifiez cette cohérence côté intégrateur.

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

Body

application/json
name
string
required
Maximum string length: 150
Example:

"Facture boutique"

currency
string
required
Required string length: 3
Example:

"XOF"

description
string
Maximum string length: 255
Example:

"Paiement en ligne"

amount_type
enum<string>
default:FIXED

FIXED : montant imposé (amount). FREE : le client choisit (min_amount optionnel comme plancher). Aucune validation croisée serveur — un lien FIXED sans amount est accepté.

Available options:
FIXED,
FREE
amount
string<decimal>
Example:

"15000.00"

min_amount
string<decimal>

Pertinent si amount_type=FREE

is_active
boolean
default:true
expires_at
string<date-time>
usage_limit
integer
Required range: x >= 1
Example:

100

Response

Lien créé