ReferencePayment links
Create a payment link
Required scope
payment_links:writeThe API key must hold this scope, otherwise Kivoo answers 403 insufficient_scope.POST
/v1/payment-linksA fixed amount (pricing: FIXED with amount) or an amount the buyer chooses (OPEN with minAmount), in the currency of the store. Refused with 422 feature_disabled while payment links are closed to creators.
Authorization
apiKey AuthorizationBearer <token>
Clé API de la boutique, kv_live_…
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.kivoo.africa/v1/payment-links" \ -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000" \ -H "Content-Type: application/json" \ -d '{ "title": "Acompte robe bleue", "pricing": "FIXED", "amount": 15000, "maxPayments": 20 }'{ "id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b", "code": "ab23cd45", "url": "https://atelier-nour.kivoo.store/pay/ab23cd45", "title": "Acompte robe bleue", "description": "Pour réserver ta robe.", "coverUrl": null, "pricing": "FIXED", "amount": 15000, "minAmount": null, "currency": "XAF", "thankYouMessage": "Merci, à très vite !", "expiresAt": "2026-12-31T23:00:00.000Z", "maxPayments": 20, "disabledAt": null, "availability": "ACTIVE", "paidCount": 4, "paidAmount": 60000, "lastPaidAt": "2026-09-12T10:05:00.000Z", "createdAt": "2026-09-01T08:00:00.000Z", "updatedAt": "2026-09-01T08:00:00.000Z"}