Skip to main content
POST
Create a service

Authorizations

Authorization
string
header
required

Your secret API key: sk_live_… (real money) or sk_test_… (test mode).

Body

application/json
name
string
required

2 to 60 characters, unique among your services.

Example:

"Afroyamo"

category
string
required

A code from GET /mobile-money/categories.

Example:

"dating"

description
string
required

20 to 1,000 characters. What you sell and to whom.

Example:

"Dating app for the African diaspora. Premium subscriptions paid by mobile money."

url
string<uri>
required

The public address of your website or app.

Example:

"https://afroyamo.com"

support_email
string<email>
required

Where your customers can reach you.

Example:

"support@afroyamo.com"

support_phone
string
required

International format with the country code.

Example:

"+237670000000"

webhook_url
string<uri>
required

https address of your server that receives the payment results.

Example:

"https://api.afroyamo.com/kemypay/webhooks"

callback_url
string<uri>

Optional. Where your customer is sent back after paying.

Example:

"https://afroyamo.com/payment/done"

fee_bearer
enum<string>
default:merchant

Who pays the fee: merchant (deducted from what you receive) or customer (added to the price).

Available options:
merchant,
customer

Response

Service created, waiting for review

success
boolean
Example:

true

data
object
meta
object