Request Parameters

Hosted Integration Request Parameters

Variable	Type Format / Max Length	Description / Example
merchant_id	optional, alphanumeric	Merchant ID provided and it is on the request URL, otherwise need to pass this as parameter
amount	mandatory, integer or up to 2 decimal points numeric value	The total amount to be paid in one purchase order. Configurable to lock this field (Read-only). E.g. 500, 168.99, comma( , ) is not allowed
orderid	mandatory, alphanumeric up to 32 characters	Invoice or order number from merchant system. Can be set to Read-only field. E.g. BH2018-09rev
bill_name	mandatory, alphanumeric, 128 chars	Buyer’s full name. (Please do not pass in dummy data if you want to use the saved cards feature, as this info will be used to identify the ownership of the card’s token. If you need to use dummy data, kindly refer to guest_checkout.)
bill_email	mandatory, email, 128 chars	Buyer’s email address. Must be a valid email. (Please do not pass in dummy data if you want to use the saved cards feature, as this info will be used to identify the ownership of the card’s token. If you need to use dummy data, kindly refer to guest_checkout.)
bill_desc	mandatory, alphanumeric, 64kB	Purchase itemized list or order description. Try to avoid special characters so that the payment request is not blocked by the web application firewall.
country	mandatory, 2 chars of ISO-3166 country code (Alpha-2)	Buyer’s country E.g. ID for Indonesia.
vcode	conditional if accept open amount or order payment, such as virtual terminal is optional otherwise is mandatory. 32 chars hexadecimal string	This is the data integrity protection hash string. Refer vcode section for details.
cur / currency	optional, 3 chars ISO-4217 currency code	Default payment currency from merchant site. E.g. MYR, USD, EUR, AUD, SGD, CNY, IDR
channel	optional, predefined string. Refer to the channel column in the Channel Lists.	Default payment page will be displayed without channel specified.
langcode	optional, predefined string. Currently only en for English & cn for Simplified Chinese.	Default language, i.e. English, will be displayed without the langcode specified.
returnurl	optional, URL	For selected merchants only. Used for multiple return URLs. All URLs must be registered beforehand with PG. This will slow down your payment request.
callbackurl	optional, URL	Used for both multiple callback URL and Notify URL. All URL endpoints must be registered beforehand with PG.
cancelurl	optional, URL	Buyer will redirect to this URL if the buyer clicks the “Cancel” button to abandon payment before proceeding. No transaction will be created.
tcctype	optional, for card type transaction	Available value is: SALS = Capture Transaction (Default) AUTH = Authorize Transaction (Please inform Fiuu before starting using pre-auth)
token	optional	Token value for 1-click payment to show the selected card
installmonth	optional, mandatory for installment payment	Total month of installment. E.g: 0, 3, 6, 12, 24
cash_waittime	optional, integer	To overwrite the allowed waiting time for cash payment in hour(s), values greater than “Payment Expiry Time” in merchant profile will be capped.
waittime	optional, integer	When the payment page will be expired in second(s)