Skip to main content
POST
Create checkout session
Walkthrough: Checkout guide.

Authorizations

Authorization
string
header
required

Token from Generate bearer token.

Body

application/json
amount
integer
required

Amount to charge in KES.

Example:

1500

chargeCurrency
enum<string>
required

ISO 4217 currency code. Tanda supports KES.

Available options:
KES
Example:

"KES"

walletCurrency
enum<string>
required

Wallet to credit. Use KES.

Available options:
KES
Example:

"KES"

externalReference
string
required

Your unique ID for this transaction. Must be unique per attempt; reuse returns 409 DUPLICATE_EXTERNAL_REFERENCE.

Example:

"order_10045"

method
enum<string>

Restricts checkout to one method. Omit to let the customer choose.

Available options:
momo,
bank
customerId
string

Your own ID for the customer. Returned on the transaction so you can match it.

Example:

"customer_123"

prefillData
object

Customer details to prefill. The customer can't edit prefilled values during payment.

successRedirectUrl
string<uri>

Where to send the customer after a successful payment.

failureRedirectUrl
string<uri>

Where to send the customer after a failed payment.

cancelRedirectUrl
string<uri>

Where to send the customer if they cancel.

Response

Session created.

success
boolean
message
string
data
object