Retail Payment Integration Guide

Search…
One of the payment method offered by Faspay is Retail Payment. By using this payment method, customers will have the option to make a payment via retail payment and Faspay will send real time notification when the customer complete the payment.
At this moment, Faspay has integrated with the following retail payment methods:
1.
Payment Point Indomaret
2.
Alfagroup
Basic integration process of retail payment will be explained below.
Integration Step
1.
Post Data Transaction to Faspay
2.
Display Payment Code
3.
Payment Notification
​
1. Post Data Transaction
Post data transaction should be done from merchant backend, the detail API reference can be find here​
Every Retail Payment  channel will use the same API request, the different is only on payment_channel value for each retail payment channel.
This is example of post data transaction for Retail Payment channel
Payment Point Indomaret
Alfagroup
1
{
2
   "request": "Post Data Transaksi",
3
   "merchant_id": "99999",
4
   "merchant": "FASPAY STORE",
5
   "bill_no": "20201222113632",
6
   "bill_reff": "20200324_02-2286704_336",
7
   "bill_date": "2020-12-19 06:04:29",
8
   "bill_expired": "2020-12-19 07:04:29",
9
   "bill_desc": "Payment Online Via Faspay",
10
   "bill_currency": "IDR",
11
   "bill_gross": "100000",
12
   "bill_miscfee": "100000",
13
   "bill_total": "200000",
14
   "cust_no": "01",
15
   "cust_name": "tester",
16
   "payment_channel": "706",
17
   "pay_type": "01",
18
   "msisdn": "8562927907",
19
   "email": "[email protected]",
20
   "terminal": "10",
21
   "billing_address": "Jl Sabang 37",
22
   "billing_address_city": "Jakarta",
23
   "billing_address_region": "DKI Jakarta",
24
   "billing_address_state": "Indonesia",
25
   "billing_address_poscode": "10170",
26
   "billing_address_country_code": "ID",
27
   "receiver_name_for_shipping": "Tompi",
28
   "shipping_address": "Jl. Sabang 37",
29
   "shipping_address_city": "Jakarta",
30
   "shipping_address_region": "DKI Jakarta",
31
   "shipping_address_state": "Indonesia",
32
   "shipping_address_poscode": "10170",
33
   "item": {
34
      "id": "A001",
35
      "product": "Invoice #2286704",
36
      "qty": "1",
37
      "amount": "100000",
38
      "payment_plan": "01",
39
      "merchant_id":"99999",
40
      "tenor": "00"
41
   },
42
   "reserve1": "",
43
   "reserve2": "",
44
   "signature": "b8e8b132d1fba3b958fd427b22b88349b7b4c16d"
45
}
Copied!
1
{
2
   "request": "Post Data Transaksi",
3
   "merchant_id": "99999",
4
   "merchant": "FASPAY STORE",
5
   "bill_no": "20201222113850",
6
   "bill_reff": "20200324_02-2286704_336",
7
   "bill_date": "2020-12-19 06:04:29",
8
   "bill_expired": "2020-12-19 07:04:29",
9
   "bill_desc": "Payment Online Via Faspay",
10
   "bill_currency": "IDR",
11
   "bill_gross": "100000",
12
   "bill_miscfee": "100000",
13
   "bill_total": "200000",
14
   "cust_no": "01",
15
   "cust_name": "tester",
16
   "payment_channel": "707",
17
   "pay_type": "01",
18
   "msisdn": "8562927907",
19
   "email": "[email protected]",
20
   "terminal": "10",
21
   "billing_address": "Jl Sabang 37",
22
   "billing_address_city": "Jakarta",
23
   "billing_address_region": "DKI Jakarta",
24
   "billing_address_state": "Indonesia",
25
   "billing_address_poscode": "10170",
26
   "billing_address_country_code": "ID",
27
   "receiver_name_for_shipping": "Tompi",
28
   "shipping_address": "Jl. Sabang 37",
29
   "shipping_address_city": "Jakarta",
30
   "shipping_address_region": "DKI Jakarta",
31
   "shipping_address_state": "Indonesia",
32
   "shipping_address_poscode": "10170",
33
   "item": {
34
      "id": "A001",
35
      "product": "Invoice #2286704",
36
      "qty": "1",
37
      "amount": "100000",
38
      "payment_plan": "01",
39
      "merchant_id":"99999",
40
      "tenor": "00"
41
   },
42
   "reserve1": "",
43
   "reserve2": "",
44
   "signature": "5fefe2c250f029d18db15396c430a7c4aec9e5aa"
45
}
Copied!
Post Data Transaction response
You will get the post data response like the following
Payment Point Indomaret
Alfagroup
1
{
2
   "response": "Transmisi Info Detil Pembelian",
3
   "trx_id": "9999970000081018",
4
   "merchant_id": "99999",
5
   "merchant": "FASPAY STORE",
6
   "bill_no": "20201222113632",
7
   "bill_items": {
8
      "id": "A001",
9
      "product": "Invoice #2286704",
10
      "qty": "1",
11
      "amount": "100000",
12
      "payment_plan": "01",
13
      "merchant_id": "99999",
14
      "tenor": "00"
15
   },
16
   "response_code": "00",
17
   "response_desc": "Sukses",
18
   "redirect_url" : "https://dev.faspay.co.id/pws/100003/0830000010100000/b8e8b132d1fba3b958fd427b22b88349b7b4c16d?trx_id=9999970000081018&merchant_id=99999&bill_no=20201222113632"
19
}
Copied!
1
{
2
   "response": "Transmisi Info Detil Pembelian",
3
   "trx_id": "3245070700122879",
4
   "merchant_id": "99999",
5
   "merchant": "FASPAY STORE",
6
   "bill_no": "20201222113850",
7
   "bill_items": {
8
      "id": "A001",
9
      "product": "Invoice #2286704",
10
      "qty": "1",
11
      "amount": "100000",
12
      "payment_plan": "01",
13
      "merchant_id": "99999",
14
      "tenor": "00"
15
   },
16
   "response_code": "00",
17
   "response_desc": "Sukses",
18
   "redirect_url" : "https://dev.faspay.co.id/pws/100003/0830000010100000/5fefe2c250f029d18db15396c430a7c4aec9e5aa?trx_id=3245070700122879&merchant_id=99999&bill_no=20201222113850"
19
}
Copied!
2. Displaying Payment Code
To display the payment code there's two option 
Displaying payment code at merchant's web page
Redirect to Faspay's page to display the payment code, expired time and how to pay instructions. Read the detail API reference here or just simply use redirect_url that retrieved from Post Data Transaction response (for JSON Format).
To display payment code at merchant's webpage use the trx_id respon from Post Data Transaction as Payment Code
Don't forget to display the expired time and how to pay instructions too.
3. Payment Notification
Payment notification from Faspay to Merchant backend will also be triggered on event of transacion status getting updated, to ensure merchant is securely informed. Please provide the URL and make sure it's already register on Faspay system
The detail API reference can be find here 
​
Internet Banking integration Guide
Online Debit Integration Guide
Last modified 9mo ago
Copy link