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.
- 1.Post Data Transaction to Faspay
- 2.Display Payment Code
- 3.Payment Notification
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_channel
value for each retail payment channel.This is an example of post data transaction for the Retail Payment channel
Payment Point Indomaret
Alfagroup
{
"request": "Post Data Transaksi",
"merchant_id": "99999",
"merchant": "FASPAY 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": "tester",
"payment_channel": "706",
"pay_type": "01",
"msisdn": "8562927907",
"email": "[email protected]",
"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": "Tompi",
"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"
}
{
"request": "Post Data Transaksi",
"merchant_id": "99999",
"merchant": "FASPAY 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": "tester",
"payment_channel": "707",
"pay_type": "01",
"msisdn": "8562927907",
"email": "[email protected]",
"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": "Tompi",
"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
Alfagroup
{
"response": "Transmisi Info Detil Pembelian",
"trx_id": "9999970000081018",
"merchant_id": "99999",
"merchant": "FASPAY 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": "Sukses",
"redirect_url" : "https://dev.faspay.co.id/pws/100003/0830000010100000/b8e8b132d1fba3b958fd427b22b88349b7b4c16d?trx_id=9999970000081018&merchant_id=99999&bill_no=20201222113632"
}
{
"response": "Transmisi Info Detil Pembelian",
"trx_id": "3245070700122879",
"merchant_id": "99999",
"merchant": "FASPAY 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": "Sukses",
"redirect_url" : "https://dev.faspay.co.id/pws/100003/0830000010100000/5fefe2c250f029d18db15396c430a7c4aec9e5aa?trx_id=3245070700122879&merchant_id=99999&bill_no=20201222113850"
}
there areTo display the payment code there are two option:
- 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 payment code on merchant's webpage use the
trx_id
response from Post Data Transaction as Payment CodeDon't forget to display the expiration time and how to pay instructions too.
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
Last modified 2mo ago