Skip to main content
POST
Initiate Payment Intent

Authorizations

Authorization
string
header
required

Provide the Bearer API Key generated for your brand.

Body

application/json
amount
string
required

Positive numeric string representing the transaction volume (2 decimal places).

Example:

"500.00"

currency
string
required

3-letter ISO currency code. Must be registered and supported by the platform (e.g. BDT, USD).

Example:

"BDT"

callback_url
string<uri>

Webhook payload URL where transaction completion callbacks are POSTed. Must use HTTP or HTTPS.

Example:

"https://my-store.com/webhooks/ownpay"

redirect_url
string<uri>

Redirection target URL where the user is returned after a successful checkout session.

Example:

"https://my-store.com/checkout/success"

cancel_url
string<uri>

Redirection target URL where the user is returned if they cancel the payment session.

Example:

"https://my-store.com/checkout/cancel"

customer_email
string<email>

Customer email address. Used for identity verification and mapping.

customer_name
string

Customer full name (max 150 characters).

Example:

"John Doe"

customer_phone
string

Customer phone number (max 30 characters).

Example:

"+8801700000000"

reference
string

Internal order reference or invoice identifier.

Example:

"INV-10029"

gateway
string

Request routing through a specific payment gateway slug (optional).

Example:

"bkash-merchant"

metadata
object

Key-value map for merchant custom details.

Example:

Response

Payment session initiated successfully.

success
boolean
Example:

true

data
object
Last modified on July 12, 2026