Initiate eMandate

Initiating an eMandate allows a customer to digitally authorize a merchant to collect payments via direct debit. This authorization is required before any recurring or scheduled debit can be performed.

eMandate Details

An initiated eMandate includes:

• Customer bank account details

• Maximum debit amount (if applicable)

• Frequency or validity period

• Mandate reference identifier

• Mandate status (pending, active, failed, revoked)

Mandate Status

• Pending – Authorization is in progress

• Active – Mandate is approved and ready for use

• Failed – Authorization was rejected or expired

• Revoked – Mandate was cancelled by the customer

Endpoint

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

This endpoint is used to initiated new payment mandate. You may provide the transaction details (amount, currency, application_type, id_number) 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	[email protected]
buyer_phone	Valid buyer phone number.	Compulsory	[phone]
amount	Amount in cents format: 10020 , 100000, 700030	Compulsory	154040
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.	Compulsory	DirectDebit
billing_address	Address associated with a payment method, used to verify and process transactions.	Optional	eg: "billing_address": { "line_1": "123 Jalan Jalan", "line_2": "Taman Taman", "city": "KL" },
custom_fields	Additional, flexible information beyond the default fields to fit your specific needs.	Optional	eg: "custom_fields": { "color": "white", "size": "XL", "customer_id": "1234567890" },
application_type	Enrollment for the payment mandate	Compulsory	01
id_type	The kind of identification provided, such as new IC, old IC, passport, business registration, or others. new_ic: 1, old_ic: 2, passport: 3, business_registration: 4, others: 5	Compulsory	eg: 1 * for new identification number
id_number	The unique identifier associated with the selected ID type.	Compulsory	000910102412
maximum_frequency	The highest number of times a mandate can be used to debit a customer’s account. 999 for infinite	Compulsory	eg: 3, 4, ... 999
mode_frequency	Frequency of the eMandate. daily: "DL", weekly: "WK", monthly: "MT", yearly: "YR"	Compulsory	WK
purpose	Purpose of the eMandate	Compulsory

Payment page for eMandate enrollment

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