Closed Wallet Payment

Closed Wallet is a secure payment option that enables merchants to allow registered users to make purchases using their internal stored balance. Unlike open wallets or bank-linked payments, Closed Wallet only works within a specific merchant or ecosystem.

User can authorize the payment:

1. Using Pincode

   • The user provides their registered phone number and pincode.

   • The system verifies the identity and deducts the payment amount from their closed wallet balance.

Endpoint URL

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

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 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.	Compulsory	ClosedWallet
cashier_id	Unique cashier id to determine which cashier responsible for the payment	Optional
outlet_id	Unique outlet id to trace in which outlet the payment was made	Optional
card_payment	Determine whether the payment is using physical card or not	Optional	e.g: true or false