Payment Request
Web-to-Web Request
Method : POST
Content Type: application/x-www-form-urlencoded
Staging URL : https://api-staging.pay.asia/api/PaymentForm.aspx
NOTE
To Create a unified payment checkout page for your website and Mobile.
Request Parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
version |
String | Yes |
Version number. Constant string: ‘1.5.5’. |
1.5.5 |
CID |
String | Yes | Merchant ID | M102-U-999 |
v_cartid |
String | Yes | Unique Referece ID(Order ID from Merchant) Special Character Supported: Hyphen(-), underscore(_), full stop(.) |
GkashPO-12345 |
v_currency |
String | Yes |
Currency notation (currently only support MYR) ISO 4217 currency code, e.g. MYR |
MYR |
v_amount |
String | Yes | Payment amount | 100.00 |
signature |
String | Yes | Refer to SHA512 Signature | abcdefghijsdf123131234124 |
returnurl |
String | Optional |
This is URL to redirect after payment is done. Direct back to merchant URL/merchant application. |
https://www.testing.com/api/Return |
callbackurl |
String | Optional | This is a notify URL or callback URL to inform merchant on transaction status after payment is done. | https://www.testing.com/api/Callback |
v_firstname |
String | Optional | Buyer's First Name | Jay |
v_lastname |
String | Optional | Buyer's Last Name | Chow |
v_billemail |
String | Optional | Buyer's email address | GkashUser@gkash.com |
v_billstreet |
String | Optional | Buyer's address | Tower 3, Avenue 3, The Horizon Bangsar South |
v_billpost |
String | Optional | Buyer's postcode | 57000 |
v_billcity |
String | Optional | Buyer's city | Kuala Lumpur |
v_billstate |
String | Optional | Buyer's state | Wilayah Persekutuan |
v_billcountry |
String | Optional |
Buyer's country (ISO 3166-1 Alpha-2 country code, e.g. MY) |
MY |
v_billphone |
String | Optional | Buyer's contact number (only integer) | 01234567890 |
v_shipstreet |
String | Optional | Buyer's shipping address | Tower 3, Avenue 3, The Horizon Bangsar South |
v_shippost |
String | Optional | Buyer's shipping postcode | 57000 |
v_shipcity |
String | Optional | Buyer's shipping city | Kuala Lumpur |
v_shipstate |
String | Optional | Buyer's shipping state | Wilayah Persekutuan |
v_shipcountry |
String | Optional |
Buyer's shipping country (ISO 3166-1 Alpha-2 country code, e.g. MY) |
MY |
clientip |
String | Optional | User client ip address | 127.0.0.1 |
v_productdesc |
String | Optional | Product Description | IPhone 100 Max |
preselection |
String | Optional |
Pre-select payment method tab Merchant can allow the first tab to be display on the Gunified Payment Page. ECOMM - For Credit/Debit Card tab EBANKING - For Internet Banking tab EWALLET - For Ewallet tab |
ECOMM |
paymentmethod |
String | Optional |
To control the payment method shown to payers, use comma to split if multiple option
ECOMM - For Credit/Debit Card tab EBANKING - For Internet Banking tab EWALLET - For Ewallet tab |
EWALLET,ECOMM |
Recurring Payment | ||||
recurringtype |
String | Conditional | Recurring payment type |
“MONTHLY” “ANNUAL” |
subscriptioncount |
String | Conditional | Subscription Count | “3” |
Pre-Auth Payment | ||||
v_preauth |
String | Conditional | Preauth payment token | PREAUTH |
Example Request
<form method=
"post"
action=
"https://api-staging.pay.asia/api/paymentform.aspx"
>
<input name=
"version"
type=
"text"
value=
"1.5.5"
>
<input name=
"CID"
type=
"text"
value=
"M102-U-999"
>
<input name=
"v_currency"
type=
"text"
value=
"MYR"
>
<input name=
"v_amount"
type=
"text"
value=
"100.00"
>
<input name=
"v_cartid"
type=
"text"
value=
"GkashPO-12345"
>
<input name=
"signature"
type=
"text"
value=
"adsffasdfef"
>
<input name=
"returnurl"
type=
"text"
value=
"https://www.testing.com/api/Return"
>
<input name=
"callbackurl"
type=
"text"
value=
"https://www.testing.com/api/Callback"
>
<input type=
"submit"
value=
"Submit"
>
</form >