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.
- 1.Post Data Transaction
- 2.Callback/return URL (for one-step transaction)
- 3.Payment Notification
Endpoint URL is used as a feedback URL that will process the data in the post from the merchant system. There are two URLs that need to be used, namely Production and Development. For the implementation of the testing or UAT can use URL development.
Development | Production |
|---|---|
Request Parameter
Sample Code Request
Parameter | Data Type | M/O/C | Description |
|---|---|---|---|
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 |
email | 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 |
signature | Alphanumeric (100) | M | sha1(md5(user_id merchant + password merchant + bill_no + bill_total)) |
Notes:
M = Mandatory
O = Optional
C = Conditional
{
"merchant_id":"98765",
"bill_no":"98765123456789",
"bill_date":"2020-09-02 10:48:10",
"bill_expired":"2020-09-03 10:48:10",
"bill_gross":"0",
"bill_miscfee":"0",
"bill_total":"1000000",
"bill_desc":"Pembayaran #12345678",
"cust_no":"12",
"cust_name":"Nur Auliya",
"payment_channel":["409", "410", "411"]
"return_url":"https://alamatwebsite.com/response",
"msisdn":"628122131187",
"email":"[email protected]",
"billing_address":"jalan pintu air raya",
"billing_address_city":"Jakarta Pusat",
"billing_address_region":"DKI Jakarta",
"billing_address_state":"Indonesia",
"billing_address_poscode":"10710",
"billing_address_country_code":"ID",
"receiver_name_for_shipping":"Nur Auliya",
"shipping_address":"jalan pintu air raya",
"shipping_address_city":"Jakarta Pusat",
"shipping_address_region":"DKI Jakarta",
"shipping_address_state":"Indonesia",
"shipping_address_poscode":"10710",
"shipping_address_country_code":"ID",
"item":[
{
"product":"Invoice No. inv-985/2017-03/1234567891",
"qty":"1",
"amount":"1000000"
}
],
"button_color":"333333",
"background_color":"333333",
"signature":"5807a17ccd950904ec0a303725fa8a4b36c89e2f"
}
Response Parameter
Sample Code Response
Parameter | Data Type | M/O/C | Description |
|---|---|---|---|
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
{
"bill_no": "98765123456789",
"merchant_id": "98765",
"merchant": "Faspay sandbox",
"response_code": "00",
"response_desc": "Success",
"redirect_url":"https://dev.faspay.co.id/pws/100003/0830000010100000/5807a17ccd950904ec0a303725fa8a4b36c89e 2f?trx_id=9876530200004184&merchant_id=98765&bill_no=98765123456789"
}
redirect_url must be hit via the client-side browser, then a channel list will appear.
Transaction Order Detail
After the customer completes the payment via bank's website, the bank website automatically redirect customer to Callback/Return URL. Please provide the URL and make sure it's already registered on Faspay system. For detailed reference can be found here
Payment notification from Faspay to Merchant backend will also be triggered in event of transaction status getting updated, to ensure Merchant is securely informed. Please provide the URL and make sure it's already registered on Faspay system
Last modified 2mo ago