Skip to main content
POST
/
api
/
v3
/
cross-boarder
/
invoice
Generate Invoice
curl --request POST \
  --url https://sandbox-api.kotanipay.com/api/v3/cross-boarder/invoice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "KES",
  "amount": 1000,
  "bank": {
    "accountName": "John Doe",
    "address": "123 Main St",
    "phoneNumber": "+254712345678",
    "bankCode": 123456,
    "accountNumber": "1234567890",
    "country": "Kenya"
  },
  "referenceId": "1e476673-0931-4eba-8373-37b368ce59f7",
  "userReference": "1e476673-0931-4eba-8373-37b368ce59f7"
}
'
{
  "success": true,
  "message": "Invoice has been successfully created",
  "data": {
    "id": "<string>",
    "message": "<string>",
    "reference_id": "<string>",
    "reference_number": 123,
    "customer_key": "<string>",
    "redirect_url": "<string>"
  }
}
Generate an invoice for cross-border payments between different fiat currencies.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
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"

​
amount
number
required

The amount of the invoice

Example:

1000

​
bank
object
required

The bank details of the invoice

Example:
{
  "accountName": "John Doe",
  "address": "123 Main St",
  "phoneNumber": "+254712345678",
  "bankCode": 123456,
  "accountNumber": "1234567890",
  "country": "Kenya"
}
​
referenceId
string
required

The reference id of the invoice

Example:

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

​
userReference
string

The user reference of the invoice

Example:

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

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Invoice has been successfully created"

​
data
object