POST
/
api
/
v1
/
payments
/
create

Authorizations

Authorization
string
headerrequired

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

Body

application/json
cashTag
string
required

The cash tag for the payment

amount
number
required

The amount of the payment

isWhiteLabel
boolean
default: false

Whether the payment is white-labeled

callbackUrl
string

The URL to call back after payment processing

returnUrl
string

The URL to return to after payment

Response

200 - application/json
id
string

The ID of the payment invoice

userId
string

The ID of the user / merchant who created the payment invoice

cashTag
string

The CashTag of the payment recipient

note
string

The required note associated with the payment

amount
number

The amount invoiced

isWhiteLabel
boolean

Whether the payment is white-labeled

receiptId
string | null

The ID of the web receipt for the payment

paidAmount
number | null

The amount paid

cashpayFee
number | null

The CashPay service fee

status
enum<string>
Available options:
PENDING,
UNDER_PAID,
PAID,
FAILED,
EXPIRED
paymentUrl
string

The URL where the user can make the payment

callbackUrl
string | null

The URL to call back on payment status changes

returnUrl
string | null

The URL where the user will be redirected after the payment

expiresAt
string

The date and time when the payment expires

createdAt
string

The date and time when the payment was created

updatedAt
string

The date and time when the payment was last updated