Create a checkout session

Portée requisecheckouts:writeLa clé API doit porter cette portée, sinon Kivoo répond 403 insufficient_scope.
POST/v1/checkouts

A page where one of your users pays one license, open 24 hours and for one payment: create it when the user clicks, then send them to url. Two calls give two sessions, both payable. Once paid, the page sends the user back to returnUrl with ?checkoutId=…; activate their account on license_key.issued, never on that return. The creation is recorded in the activity journal of the store under the name of the key.

Autorisation

apiKey
AuthorizationBearer <clé API>

An API key of the store, kv_live_…

Dans: header

Corps de la requête

application/json

Définitions TypeScript

Utilise le type request body en TypeScript.

Corps de la réponse

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.kivoo.africa/v1/checkouts" \  -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000" \  -H "Content-Type: application/json" \  -d '{    "productId": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",    "externalReference": "42",    "returnUrl": "https://app.example.com/billing/return",    "metadata": {      "plan": "pro",      "workspace": "acme"    },    "customer": {      "email": "awa@example.com",      "lastName": "Diallo",      "firstName": "Awa"    },    "country": "GA"  }'
{  "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",  "url": "https://atelier-nour.kivoo.co/checkout/Xk2Lp9QwRt5vZb8NcY3mHs7JdF4gA6eU",  "status": "open",  "expiresAt": "2026-10-19T09:12:00.000Z",  "product": {    "id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",    "title": "Plan Pro — 30 jours"  },  "amount": 4500,  "currency": "XAF",  "externalReference": "42",  "metadata": {    "plan": "pro",    "workspace": "acme"  },  "returnUrl": "https://app.example.com/billing/return",  "customer": {    "email": "awa@example.com",    "lastName": "Diallo",    "firstName": "Awa"  },  "country": "GA",  "order": null,  "licenseKey": null,  "createdAt": "2026-10-18T09:12:00.000Z"}