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

1. Post Data Transaction

2. Callback/return URL (for one-step transaction)

3. Payment Notification

1. Post Data Transaction

Endpoint URL Post Data

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
https://xpress-sandbox.faspay.co.id/v4/post	https://xpress.faspay.co.id/v4/post

Request Parameter

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

Sample Code Request

{
    "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":"[e-mail]", 
    "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

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

Sample Code Response

{
    "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.

For every valid post data will get results like the example below:

Transaction Order Detail

2. Callback/Return URL

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

3. Payment Notification

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

The detailed API reference can be found here