Skip to main content
POST
/
api
/
v3
/
deposit
/
bank
/
checkout
Deposit via bank checkout
curl --request POST \
  --url https://preview.kotanipay.com/api/v3/deposit/bank/checkout \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fullName": "John Doe",
  "phoneNumber": "+245XXXXXXXXX",
  "paymentMethod": "PAYBYBANK",
  "currency": "eg ZAR",
  "amount": 10,
  "country": "<string>",
  "referenceId": "5f9b2c7b9c9d6b0017b4e6b1",
  "callbackUrl": "https://example.com",
  "customerRedirectUrl": "https://example.com/success"
}
'
{
  "success": true,
  "message": "Checkout Created successfully created.",
  "data": {
    "fullName": "John Doe",
    "phoneNumber": "+245XXXXXXXXX",
    "paymentMethod": "PAYBYBANK",
    "currency": "eg ZAR",
    "amount": 10,
    "country": "<string>",
    "referenceId": "5f9b2c7b9c9d6b0017b4e6b1",
    "callbackUrl": "https://example.com",
    "customerRedirectUrl": "https://example.com/success"
  }
}
Customer completed transaction using checkout URL. This endpoint allows customers to deposit funds via bank checkout.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
fullName
string
required

full name

Example:

"John Doe"

​
phoneNumber
string
required

Customer Phone Number

Example:

"+245XXXXXXXXX"

​
paymentMethod
enum<string>
required

Payment Method

Available options:
PAYBYBANK,
CARD
Example:

"PAYBYBANK"

​
currency
enum<string>
required

Transaction currency

Available options:
KES,
GHS,
NGN,
ZAR,
ZAR,
USD,
XOF,
ZMW,
XAF,
SLE,
CDF,
TZS,
UGX,
EGP,
MWK,
RWF,
ETB,
MZN,
LSL,
GNF,
USDT,
BTC,
ETH,
USDC
Example:

"eg ZAR"

​
amount
number
required

amount to deposit

Example:

10

​
country
string

Country where the wallet is used (optional if derivable from currency) - Cards are accepted globally

​
referenceId
string

reference id

Example:

"5f9b2c7b9c9d6b0017b4e6b1"

​
callbackUrl
string

callback url

Example:

"https://example.com"

​
customerRedirectUrl
string

customer redirect url

Example:

"https://example.com/success"

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Checkout Created successfully created."

​
data
object