Create Payment Session

A Payment Session represents a single checkout transaction — once created, you will receive a payment_url to redirect the customer to our hosted payment page.

POST https://{base_url}/v1/payment/intents

This endpoint initializes a new payment attempt. You may provide the transaction details (amount, currency, etc) and the API responds with a unique checkout_url where you redirect the customer for payment.

Key Attributes

Key
Description
Condition
Example

order_number

Unique order number generated by merchant end for reference.

Optional

1758620258

buyer_name

Valid buyer full name in one line.

Compulsory

AHMAD AMSYAR MOHD ALI

buyer_email

Valid buyer email address for status update

Compulsory

buyer_phone

Valid buyer phone number.

Compulsory

+60123121678

amount

Amount format: 100.20 , 1000.00, 7000.30

Compulsory

1540.40

amount_currency

Default currency is MYR.

Optional

description

Meaningful Product Description e.g.

● Payment for order number 123

● Payment for vintage table part #89782

Compulsory

Payment for order no. 20200425132755

callback_url

Server to server. Securepay platform will post the payment status.

Optional

redirect_url

Browser to browser, Securepay platform will post to the endpoint browser.

Optional

redirect

Auto redirect to payment page.

Optional

true

cancel_url

SecurePay page for bank selection. If set the cancel URL. Button cancel will appear.

Optional

e.g:

https://yourdom.com/securepay_cancel?order_number=123123

timeout_url

SecurePay page for bank selection. if set the timeout URL. The page will timeout within 3 minutes

Optional

e.g:

https://yourdom.com/securepay_timeout?order_number=123123

payment_method

Payment method that is available for the current payment session.

Optional

e.g: Fpx

SecurePay Payment Page

This page only shown when you set the redirect as true.

Last updated