Xpress Version 4🆕
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 a feedback URL that will process the data in the post from the merchant system. For the implementation of the testing or UAT can use URL development.
merchant_id
Numeric (5)
M
Merchant code from faspay
bill_no
Alphanumeric (32)
M
Order Number
bill_date
Datetime
M
Transaction/Order Date
bill_expired
Datetime
M
Transaction/Order Expiry
Date
bill_desc
Alphanumeric (128)
M
Transaction Description
bill_gross
Numeric (15)
O
Order Nominal
bill_miscfee
Numeric (15)
O
Miscellaneous fee
bill_total
Numeric (15)
M
Total Nominal
cust_no
Alphanumeric (32)
M
Customer Number
cust_name
Alphanumeric (32)
M
Customer Name
payment_channel
Array (128)
O
Payment channel code that will be displayed as payment method on Xpress page. Default will be referred to the current setting.
return_url
Alphanumeric (32)
M
url using to return to merchant website (*channel credit card)
msisdn
Numeric (128)
M
Customer Mobile Phone
Alphanumeric (128)
M
Customer Email
billing_address
Alphanumeric (200)
O
Billing Address
billing_address_city
Alphanumeric (50)
O
Billing City
billing_address_region
Alphanumeric (100)
O
Billing Address Region
billing_address_state
Alphanumeric (100)
O
Billing Address State
billing_address_poscode
Alphanumeric (10)
O
Billing Address Post Code
billing_address_country_code
Alphanumeric (10)
O
Billing Address Country
Code
receiver_name_for_shipping
Alphanumeric (100)
O
Receiver Name
shipping_address
Alphanumeric (200)
O
Shipping Address
shipping_address_city
Alphanumeric (50)
O
Shipping Address City
shipping_address_region
Alphanumeric (100)
O
Shipping Address Region
shipping_address_state
Alphanumeric (100)
O
Shipping Address State
shipping_address_poscode
Alphanumeric (10)
O
Shipping Address Post Code
shipping_address_country_code
Alphanumeric (10)
O
Shipping Address Country Code
item
Array of object
product
Alphanumeric (50)
M
Item Name
qty
Numeric (32)
M
Item Quantity
amount
Numeric (15)
M
Item Price
button_color
Numeric (6)
O
Hex color for button
background_color
Numeric (6)
O
Hex color for background
merchant_logo
Alphanumeric (255)
M
Merchant logo
signature
Alphanumeric (100)
M
sha1(md5(user_id merchant + password merchant + bill_no + bill_total))
Notes:
M = Mandatory
O = Optional
C = Conditional
bill_no
Alphanumeric(32)
M
Order No
merchant_id
Numeric (5)
M
Merchant code
merchant
Alphanumeric (32)
M
Merchant name
response_code
Numeric (2)
M
Response code
00 Success
response_desc
Alphanumeric (32)
M
Response Code Description
redirect_url
Alphanumeric
M
The redirect url for Xpress page (short version)
Notes:
M = Mandatory
O = Optional
C = Conditional
redirect_url must be hit via the client-side browser, then a channel list will appear.
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 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 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
