Xpress
Faspay Xpress is another way to integrate with Faspay business services, the difference is the payment channel option is on the Faspay page.
The basic integration process of Faspay Xpress will be explained below.
Integration Step
Post Data Transaction
Callback/return URL (for one-step transaction)
Payment Notification
1. POST Data Transaction
Endpoint URL Post Data
The endpoint URL is used as a feedback URL that will process the data in the post from the merchant system. For the implementation of the testing UAT can use the URL development.
Parameter | Data Type | M/O/C | Description |
---|---|---|---|
merchant_id | Numeric (5) | Mandatory | Merchant code from faspay |
merchant_name | AlphaNumeric (32) | Mandatory | Merchant Name |
order_id | AlphaNumeric (32) | Mandatory | Order Number |
order_reff | AlphaNumeric (32) | Optional | Booking Number/reffrence (can fill same with order no) |
bill_date | Datetime | Mandatory | Transaction/Order Date |
bill_expired | Datetime | Mandatory | Transaction/Order Expiry Date |
bill_desc | AlphaNumeric (128) | Mandatory | Transaction Description |
bill_gross | Numeric (15) | Optional | Order Nominal |
bill_miscfee | Numeric (15) | Optional | Miscellaneous fee |
bill_total | Numeric (15) | Mandatory | Total Nominal |
custNo | AlphaNumeric (32) | Mandatory | Customer Number |
return_url | AlphaNumeric (32) | Mandatory | url using to return to merchant website (*channel credit card) |
custName | AlphaNumeric (32) | Optional | Customer Name |
custPhone | Numeric (128) | Optional | Customer Mobile Phone |
custEmail | AlphaNumeric (128) | Mandatory | Customer Email |
billingAddress | AlphaNumeric (200) | Optional | Billing Address |
billingCity | AlphaNumeric (50) | Optional | Billing City |
billingRegion | AlphaNumeric (100) | Optional | Billing Addres Region |
billingState | AlphaNumeric (100) | Optional | Billing Address State |
billingPoscode | AlphaNumeric (10) | Optional | Billing Address PosCode |
billingCountryCode | AlphaNumeric (10) | Optional | Billing Address Country Code |
receiver_name | AlphaNumeric (100) | Optional | Receiver Name |
shippingAddress | AlphaNumeric (200) | Optional | Shipping Address |
shippingCity | AlphaNumeric (50) | Optional | Shipping Address City |
shippingRegion | AlphaNumeric (100) | Optional | Shipping Address Region |
shippingState | AlphaNumeric (100) | Optional | Shipping Address State |
shippingPostcode | AlphaNumeric (10) | Optional | Shipping AddressPosCode |
products | AlphaNumeric (50) | Mandatory | Items |
signature | AlphaNumeric (100) | Mandatory | sha1(md5(user_id merchant + password merchant + bill_no + bill_total)) |
term_condition | Numeric (1) | Mandatory | Active Term and Conditions (1=True , 0=False) |
For every valid post data will get results like the example below :
2. Callback/Return URL
After the customer completes the payment via the bank's website, the bank website automatically redirects the customer to the Callback/Return URL. Please provide the URL and make sure it's registered on the Faspay system. For the detailed reference can be found Here
3. Payment Notification
Payment notification from Faspay to the Merchant backend will also be triggered in the event of transaction status getting updated, to ensure the merchant is securely informed. Please provide the URL and make sure it's already registered on the Faspay system
The detailed API reference can be found here
Last updated