Error
A valid request URL is required to generate request examples{
"success": true,
"message": "Payment link created successfully",
"data": {
"id": "<string>",
"shortCode": "<string>",
"url": "<payment-link-url>/abc123",
"name": "<string>",
"type": "standard",
"pricing": {
"type": "fixed",
"currency": "KES",
"referenceCurrency": "KES",
"amount": 123,
"minAmount": 123,
"maxAmount": 123,
"packages": [
{
"id": "<string>",
"name": "<string>",
"amount": 123,
"currency": "KES",
"description": "<string>"
}
]
},
"enabledPaymentMethods": [
"mobile_money"
],
"usageType": "single_use",
"currentUses": 123,
"isActive": true,
"collectCustomerInfo": {
"email": "required",
"phone": "required",
"name": "required",
"address": "required"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"paymentMethodConfig": {
"mobileMoneyProviders": [
"<string>"
],
"mobileMoneyCurrencies": [
"KES",
"GHS"
],
"mobileMoneyCountries": [
"<string>"
],
"supportedCurrencies": [
"<string>"
],
"cryptoNetworks": [
"<string>"
],
"cryptoCurrencies": [
"USDT",
"USDC"
],
"cardCurrencies": [
"<string>"
],
"cardCountries": [
"<string>"
],
"bankCurrencies": [
"<string>"
],
"bankCountries": [
"<string>"
]
},
"maxUses": 123,
"expiresAt": "2023-11-07T05:31:56Z",
"afterPayment": {
"type": "message",
"message": "<string>",
"redirectUrl": "https://yourdomain.com/thank-you"
},
"branding": {
"logoUrl": "https://yourdomain.com/logo.png",
"primaryColor": "#0084FF",
"backgroundColor": "#FFFFFF"
},
"qrCodeUrl": "<string>",
"lastUsedAt": "2023-11-07T05:31:56Z"
}
}{
"success": false,
"message": "Invalid API Key",
"data": {}
}Payment Links
Create Payment Link
Creates a new payment link that can be shared with a customer to collect payment.
POST
/
api
/
v3
/
payment-links
Error
A valid request URL is required to generate request examples{
"success": true,
"message": "Payment link created successfully",
"data": {
"id": "<string>",
"shortCode": "<string>",
"url": "<payment-link-url>/abc123",
"name": "<string>",
"type": "standard",
"pricing": {
"type": "fixed",
"currency": "KES",
"referenceCurrency": "KES",
"amount": 123,
"minAmount": 123,
"maxAmount": 123,
"packages": [
{
"id": "<string>",
"name": "<string>",
"amount": 123,
"currency": "KES",
"description": "<string>"
}
]
},
"enabledPaymentMethods": [
"mobile_money"
],
"usageType": "single_use",
"currentUses": 123,
"isActive": true,
"collectCustomerInfo": {
"email": "required",
"phone": "required",
"name": "required",
"address": "required"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"paymentMethodConfig": {
"mobileMoneyProviders": [
"<string>"
],
"mobileMoneyCurrencies": [
"KES",
"GHS"
],
"mobileMoneyCountries": [
"<string>"
],
"supportedCurrencies": [
"<string>"
],
"cryptoNetworks": [
"<string>"
],
"cryptoCurrencies": [
"USDT",
"USDC"
],
"cardCurrencies": [
"<string>"
],
"cardCountries": [
"<string>"
],
"bankCurrencies": [
"<string>"
],
"bankCountries": [
"<string>"
]
},
"maxUses": 123,
"expiresAt": "2023-11-07T05:31:56Z",
"afterPayment": {
"type": "message",
"message": "<string>",
"redirectUrl": "https://yourdomain.com/thank-you"
},
"branding": {
"logoUrl": "https://yourdomain.com/logo.png",
"primaryColor": "#0084FF",
"backgroundColor": "#FFFFFF"
},
"qrCodeUrl": "<string>",
"lastUsedAt": "2023-11-07T05:31:56Z"
}
}{
"success": false,
"message": "Invalid API Key",
"data": {}
}Creates a new payment link that can be shared with a customer to collect payment. Returns a hosted checkout URL — no frontend required on your end.
pricing.type drives which of amount, minAmount/maxAmount, or packages you need to set: fixed needs amount, variable needs minAmount/maxAmount (or neither, for customer_choice), package needs packages.usageType: "limited_use" requires maxUses. single_use and multi_use ignore it.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Available options:
standard, invoice, donation Show child attributes
Show child attributes
Available options:
mobile_money, bank, card, crypto Available options:
single_use, multi_use, limited_use Whether email, phone, name, and address are required, optional, or not collected at checkout.
Show child attributes
Show child attributes
Restricts which providers/currencies/networks/countries are offered per payment method. All fields optional — omit to allow everything enabled on your account.
Show child attributes
Show child attributes
Used when usageType is limited_use.
Show child attributes
Show child attributes
Example:
"https://yourdomain.com/webhook"
Show child attributes
Show child attributes