Skip to main content
POST
/
api
/
v3
/
cross-boarder
/
invoice
/
pay
Pay Invoice
curl --request POST \
  --url https://sandbox-api.kotanipay.io/api/v3/cross-boarder/invoice/pay \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 1000,
  "currency": "KES",
  "referenceId": "1e476673-0931-4eba-8373-37b368ce59f7",
  "mobileMoney": {
    "accountName": "John Doe",
    "phoneNumber": "+254712345678",
    "providerNetwork": "MTN"
  }
}
'
{
  "success": true,
  "message": "Invoice successfully retrieved",
  "data": {
    "invoice": {
      "amount": 1000,
      "currency": "KES",
      "status": "PENDING"
    },
    "currency": "KES",
    "amount": 1000,
    "referenceId": "1e476673-0931-4eba-8373-37b368ce59f7",
    "status": "PENDING"
  }
}
Pay an invoice for cross-border payments.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
amount
number
required

The amount of the invoice

Example:

1000

​
currency
enum<string>
required

The currency of the invoice

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:

"KES"

​
referenceId
string
required

The reference id of the invoice

Example:

"1e476673-0931-4eba-8373-37b368ce59f7"

​
mobileMoney
object
required

The mobile money details of the invoice

Example:
{
  "accountName": "John Doe",
  "phoneNumber": "+254712345678",
  "providerNetwork": "MTN"
}

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Invoice successfully retrieved"

​
data
object