Create a checkout session
checkouts:writeLa clé API doit porter cette portée, sinon Kivoo répond 403 insufficient_scope./v1/checkoutsA 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 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"}