Skip to main content
POST
Initiate Payment

Authorizations

Authorization
string
header
required

Payaza {{Public API Key in Base 64}}

Body

application/json
amount
number
required

The amount to be charged.

Example:

2

first_name
string
required

The customer's first name.

Example:

"John"

last_name
string
required

The customer's last name..

Example:

"Doe"

email_address
string
required

The customer's email address.

Example:

"johndoe@email.com"

payment_option
string
required

APPLEPAY or GOOGLEPAY.

Example:

"GOOGLEPAY"

description
string
required

The description of this transaction.

Example:

"Support"

transaction_reference
string
required

The unique identifier of this transaction.

Example:

"TX20251109"

redirect_url
string<uri>
required

URL to redirect on successsful.

Example:

"https://redirect.url/success"

cancel_url
string<uri>
required

URL to redirect when user cancels.

Example:

"https://redirect.url/cancel"

error_url
string<uri>
required

URL to redirect on failed payment.

Example:

"https://redirect.url/error"

country_code
string
required

The country code. (ISO 3166-1 alpha-3).

Example:

"NGN"

currency_code
string
required

GBP, EUR and USD.

Example:

"USD"

Response

Initiate Payment Successful Response

status
boolean

Request status.

Example:

true

message
string

Response message.

Example:

"payment initiated successfully"

data
object

Payment initialization details.