Retail Payment Integration Guide

One of the payment methods 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 notifications when the customer completes the payment.

At this moment, Faspay has integrated 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 detailed API reference can be found here

Every Retail Payment channel will use the same API request, the difference is only on payment_channelvalue for each retail payment channel.

This is an example of post data transaction for the Retail Payment channel

Payment Point Indomaret

{
   "request": "Post Data Transaction",
   "merchant_id": "99999",
   "merchant": "Sophia Store",
   "bill_no": "20201222113632",
   "bill_reff": "20200324_02-2286704_336",
   "bill_date": "2020-12-19 06:04:29",
   "bill_expired": "2020-12-19 07:04:29",
   "bill_desc": "Payment Online Via Faspay",
   "bill_currency": "IDR",
   "bill_gross": "100000",
   "bill_miscfee": "100000",
   "bill_total": "200000",
   "cust_no": "01",
   "cust_name": "John Doe",
   "payment_channel": "706",
   "pay_type": "01",
   "msisdn": "8562927907",
   "email": "[e-mail]",
   "terminal": "10",
   "billing_address": "Jl Sabang 37",
   "billing_address_city": "Jakarta",
   "billing_address_region": "DKI Jakarta",
   "billing_address_state": "Indonesia",
   "billing_address_poscode": "10170",
   "billing_address_country_code": "ID",
   "receiver_name_for_shipping": "John Doe",
   "shipping_address": "Jl. Sabang 37",
   "shipping_address_city": "Jakarta",
   "shipping_address_region": "DKI Jakarta",
   "shipping_address_state": "Indonesia",
   "shipping_address_poscode": "10170",
   "item": {
      "id": "A001",
      "product": "Invoice #2286704",
      "qty": "1",
      "amount": "100000",
      "payment_plan": "01",
      "merchant_id":"99999",
      "tenor": "00"
   },
   "reserve1": "",
   "reserve2": "",
   "signature": "b8e8b132d1fba3b958fd427b22b88349b7b4c16d"
}

Alfagroup

{
   "request": "Post Data Transaction",
   "merchant_id": "99999",
   "merchant": "Sophia Store",
   "bill_no": "20201222113850",
   "bill_reff": "20200324_02-2286704_336",
   "bill_date": "2020-12-19 06:04:29",
   "bill_expired": "2020-12-19 07:04:29",
   "bill_desc": "Payment Online Via Faspay",
   "bill_currency": "IDR",
   "bill_gross": "100000",
   "bill_miscfee": "100000",
   "bill_total": "200000",
   "cust_no": "01",
   "cust_name": "John Doe",
   "payment_channel": "707",
   "pay_type": "01",
   "msisdn": "8562927907",
   "email": "[e-mail]",
   "terminal": "10",
   "billing_address": "Jl Sabang 37",
   "billing_address_city": "Jakarta",
   "billing_address_region": "DKI Jakarta",
   "billing_address_state": "Indonesia",
   "billing_address_poscode": "10170",
   "billing_address_country_code": "ID",
   "receiver_name_for_shipping": "John Doe",
   "shipping_address": "Jl. Sabang 37",
   "shipping_address_city": "Jakarta",
   "shipping_address_region": "DKI Jakarta",
   "shipping_address_state": "Indonesia",
   "shipping_address_poscode": "10170",
   "item": {
      "id": "A001",
      "product": "Invoice #2286704",
      "qty": "1",
      "amount": "100000",
      "payment_plan": "01",
      "merchant_id":"99999",
      "tenor": "00"
   },
   "reserve1": "",
   "reserve2": "",
   "signature": "5fefe2c250f029d18db15396c430a7c4aec9e5aa"
}

You will get the post data response like the following

Payment Point Indomaret

{
   "response": "Transmission of Purchase Detail Info",
   "trx_id": "9999970000081018",
   "merchant_id": "99999",
   "merchant": "Sophia Store",
   "bill_no": "20201222113632",
   "bill_items": {
      "id": "A001",
      "product": "Invoice #2286704",
      "qty": "1",
      "amount": "100000",
      "payment_plan": "01",
      "merchant_id": "99999",
      "tenor": "00"
   },
   "response_code": "00",
   "response_desc": "Success",
   "redirect_url" : "https://dev.faspay.co.id/pws/100003/0830000010100000/b8e8b132d1fba3b958fd427b22b88349b7b4c16d?trx_id=9999970000081018&merchant_id=99999&bill_no=20201222113632"
}

Alfagroup

{
   "response": "Transmission of Purchase Detail Info",
   "trx_id": "3245070700122879",
   "merchant_id": "99999",
   "merchant": "Sophia Store",
   "bill_no": "20201222113850",
   "bill_items": {
      "id": "A001",
      "product": "Invoice #2286704",
      "qty": "1",
      "amount": "100000",
      "payment_plan": "01",
      "merchant_id": "99999",
      "tenor": "00"
   },
   "response_code": "00",
   "response_desc": "Success",
   "redirect_url" : "https://dev.faspay.co.id/pws/100003/0830000010100000/5fefe2c250f029d18db15396c430a7c4aec9e5aa?trx_id=3245070700122879&merchant_id=99999&bill_no=20201222113850"
}

2. Displaying Payment Code

There are display the payment code there are two options:

1. Displaying payment code on merchant's web page

2. Redirect to Faspay's page to display the payment code, expired time, and how to pay instructions. Read the detailed API reference here or just simply use redirect_url that retrieved from Post Data Transaction Response (for JSON Format).

To display the payment code on the merchant's webpage use the trx_id response from Post Data Transaction as Payment Code

Don't forget to display the expiration time and how to pay instructions too.

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 Faspay system

The detailed API reference can be found here