Hosted payment

Payment Steps

1. The merchant initiates a transaction request. Using the HTTPS protocol, it is redirected to the payment system via a browser.
2. The payment system processes the transaction request and submits it to the bank for a consumption/pre - authorization transaction.
3. After the transaction is completed, the payment system redirects the parameters related to the payment result to the online store's payment result page.
4. On the payment result page, obtain the payment result, modify the order status of the online store, and display the payment result on the page to inform the cardholder of the transaction result of this order.

Authorize

The next table describes the request parameters to perform an Authorize.

Name	Type	Max Length	Required	Description
Merchant Info
merNo	String	5	Yes	This value is provided by and is used to authenticate a merchant.
gatewayNo	String	8	Yes	This value is provided by and is used to authenticate a merchant.
orderNo	String	50	Yes	This value is the order number or tracking code, it can contain any alphanumeric value with a maximum length of 50 chars. The value must be unique.
orderCurrency	String	3	Yes	ISO 4217 Currency code that indicates the currency of the transaction. detailed in the appendix：List of ISO 4217 Currencies
orderAmount	String	10	Yes	Transaction amount. The decimal separator must be a point “.”
returnUrl	String	500	Yes	Payment result will be posted to this URL provided by merchant.
notifyUrl	String	200	No	return the abnormal trade to this address by server asynchronous (POST method). Please return "OK" after receiving the request.
signInfo	String	64	Yes	Digital signature on the payment of the results of key fields. signInfo=sha256(merNo + gatewayNo + orderNo + orderCurrency + orderAmount + returnUrl + signkey); detailed in the appendix：SHA256 encryption
Customer Info
firstName	String	100	Yes	Customer’s first name.
lastName	String	50	Yes	Customer’s last name.
email	String	200	Yes	Customer's email address.
phone	String	50	Yes	Customer’s billing phone.
country	String	100	Yes	Customer’s billing country.
city	String	100	Yes	Customer’s billing city.
address	String	500	Yes	Customer’s billing address
zip	String	100	Yes	Customer’s billing zipCode
state	String	100	NO	Customer's billing state.
shipFee	String	100	No	【Ship Fee】 Only for the digital, and only two decimal places after the decimal point..
discount	String	100	No	【Discount】 Default negative discount only for digital, and only two decimal places after the decimal point.
goodsInfo	String	5000	No	【Goods Info】 Including goods name, ID, unit price, number of specific detailed in the appendix：Goods Info
Receiving information (optional)
shipFirstName	String	100	No	【Delivery First Name】
shipLastName	String	100	No	【Delivery Last Name】
shipEmail	String	100	No	【Delivery Email】
shipPhone	String	100	No	【Delivery Phone】
shipCountry	String	100	No	【Delivery Country】short name. Such as the United States：US
shipState	String	100	No	【Delivery State】full name.
shipCity	String	100	No	【Delivery City】full name.
shipAddress	String	500	No	【Delivery Address】
shipZip	String	100	No	【Delivery Zip】
Other
remark	String	1000	No	EG: order Info

Please submit more paramters in order to avoid chanrgback. See: Risk parameters list .

Operation Responses

The next table describes the fields returned in all the responses.

Name	Type	Description
merNo	String	This value is provided by and is used to authenticate a merchant.
gatewayNo	String	This value is provided by and is used to authenticate a merchant.
tradeNo	String	Unique identifier allocated by fastcloudpay.
orderNo	String	Customer’s order number
orderCurrency	String	Customer’s order currency.
orderAmount	String	Customer’s order amount.
orderStatus	String	Transaction status: -2: To be confirmed -1: Pending 0: Failure 1: Success
orderInfo	String	Transaction result code + the result of a transaction information
billAddress	String	Bill Address Billing address pay return trading success. It returns null payment failure.
signInfo	String	Digital signature on the payment of the results of key fields. signInfo=sha256(merNo + gatewayNo + tradeNo + orderNo + orderCurrency + orderAmount + orderStatus + orderInfo + signkey);
remark	String	Remark The self-defined message for merchant. It will be returned exactly as the original one.