Skip to main content
POST
Créer une session de checkout hébergé
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 sessions de checkout distinctes.

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
amount
string<decimal>
required
Example:

"5000.00"

currency
string
required
Required string length: 3
Example:

"XOF"

customer_email
string<email>
required
Example:

"client@example.com"

customer_name
string
required
Example:

"Awa Sossou"

description
string
Example:

"Facture #1042"

country
string

Code ISO2, optionnel — présélectionne le pays sur la page de paiement

Required string length: 2
Example:

"BJ"

customer_phone
string
Example:

""

return_url
string<uri>

URL vers laquelle rediriger le client une fois le paiement terminé

metadata
object
expires_at
string<date-time>

Response

Session de checkout créée