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 >
An error has occurred. This application may no longer respond until reloaded. Reload 🗙