Singapore Payment Integration

Before reading this API documentation, please make sure to check API Description Guide

Limits

Transaction Type	Limits
Collection	USD: 1-3000, SGD: 1-3000

Amount Decimal Places: SGD — 2 decimal places | USD — 2 decimal places

Collection API

Collection Request

Description:

Create a collection order

URL: SGD: /sgd/collect/apply Note: appId SGD, amount SGD, settlement SGD USD: /usd/collect/apply Note: appId USD, amount USD, settlement USD HKD: /hkd/collect/apply Note: appId HKD, amount HKD, settlement HKD Parameters:

Parameter	Required	Type	Description
appId	Yes	Long	Business ID (retrieved from backend; must use the corresponding business ID based on the currency in the URL)
orderId	Yes	String	Merchant order number (must be unique, maximum length 48)
name	Yes	String	User’s full name, recommended to use real name. Format: firstName + lastName separated by a space, e.g. `John Doe`
phone	Yes	String	Valid phone number (see Phone Number Format)
email	Yes	String	Valid email address
amount	Yes	String	Transaction amount, up to 2 decimal places
payType	Yes	String	Transaction type
inBankCode	Yes	String	Payment Method
callBackUrl	Yes	String	Redirect URL after successful payment
callBackFailUrl	Yes	String	Redirect URL after failed payment
cancelUrl	No	String	If provided, the payment page displays a Back button that redirects the user to this URL when clicked.
notifyUrl	No	String	Callback URL
subject	No	String	Payment note
body	No	String	Additional description
partnerUserId	Yes	String	Unique user identifier (e.g., userId). Must be valid for risk control; otherwise transactions may be affected. Allowed format: numbers, letters, or symbols `-~!@#$%&*()_`.
sign	Yes	String	Signature

Return Data Parameters

Parameter	Type	Description
orderId	String	Merchant order number (must be unique)
orderNo	String	Platform order number
payUrl	String	Payment URL
sign	String	Signature

Collection Query

Description:

Query collection order

URL: SGD: /sgd/collect/query USD: /usd/collect/query HKD: /hkd/collect/query Parameters:

Parameter	Required	Type	Description
appId	Yes	Long	Business ID (retrieved from backend; must use the corresponding business ID)
orderId	Yes	String	Merchant order number
orderNo	No	String	Platform order number (faster response)
sign	Yes	String	Signature

Return Data Parameters

Parameter	Type	Description
orderId	String	Merchant order number (must be unique)
orderNo	String	Platform order number
amount	String	Transaction amount
actualAmount	String	Received amount
fee	String	Fee
status	Integer	Status (0 Not started, 1 In progress, 2 Success [final], 3 Failed [final], -1 Exception pending confirmation)
payTime	String	Payment success time (available when status=2) (currency local time), format: yyyy-MM-dd HH:mm:ss
errorMsg	String	Failure reason (available when status=3)
sign	String	Signature

Payment Methods

Currency	Payment Type (payType)	Payment Code (inBankCode)	Limit	Status	Description
SGD	QR	PAYNOW_SGD	1-3000	Available	PayNow QR Code Payment
USD	QR	PAYNOW_USD	1-3000	Available	PayNow QR Code Payment

Quick start

Merchant Guide

Common Payment

Global Payment

Unified API

Appendix

Merchant FAQ

Singapore Payment Integration

Limits

Collection API

Collection Request

Collection Query

Payment Methods

​Limits

​Collection API

​Collection Request

​Collection Query

​Payment Methods

​Related Topics

Limits

Collection API

Collection Request

Collection Query

Payment Methods

Related Topics