Description (Create Online Payment Checkout Link)

Action to create a checkout link for Online Payment.(POST)

End Point

Request Header

# Key Value Description
1 Authorization API-KEY {{api_key}} API Key
2 Content-Type application/x-www-form-urlencoded x-www-form-urlencoded


# Name Type Description
1 amount Numeric String Transaction Amount (Maximum 2 decimal places)
2 currency String(3) Transaction currency (HKD)
3 return_url String(255) Redirect url when transaction is done
4 notify_url String(255) Endpoint to notify the transaction
*Only allowed HTTP and HTTPS ports (80 and 443) for notify_url
5 custom_id String(36) Unique ID Send By Customer, only letters and numbers, underscore and dash are accepted. Maximum length: 36
6 subject String (optional) Product Name of the online payment
7 gateway_code String (optional) Gateway(s) show on the page.
Format: {{gateway_id}}_{{gateway_sub_id}}
Example: 4_1 or 4_2 (Alipay Online), 8_2 (WeChat Pay Online)
**Note: If this parameter is not present, the page will show all available gateways
8 wallet String (optional) (require if gateway_code = 4_1 or 4_2) Alipay Wallet to create the transaction
(Value: CN,HK)
9 expiry_time String (optional) Expiry Time of Online Payment in secords. (Range: 900 - 10800, i.e. 15 mins - 3 hours) (Default: 10800)


# Name Type Description
1 success Boolean Generate Online Payment Link Success or Fail
2 data Array Include all information (checkout_url etc...)

Success Response - data

# Name Type Description
1 token String Token of the online payment
2 expired_at String Expiry Time of the online payment link
3 checkout_url String Link of the online payment

Example Success Response

            "success": true,
            "data": {
                "token": "xxxxxx",
                "expired_at": "2019-03-12 16:39:26"
                "checkout_url": "xxxxxx"

Example Error Response

            "success": false,
            "message": "This action is unauthorized.",
            "status": 500

v1.36.0-20200706 © The Payment Cards Group Limited. All rights reserved.