Faspay
Search…
LinkAja Integration Guide
Basic integration process of LinkAja channel will be explained below.
Integration Step
  1. 1.
    Post Data Transaction to Faspay
  2. 2.
    Redirect customer to LinkAja's website
  3. 3.
    Callback/Return URL
  4. 4.
    Payment Notification

1. Post Data Transaction

Post data transaction should be done from merchant backend, the detail API reference can be find Here
This is example of post data transaction for LinkAja channel
1
{
2
"request": "Post Data Transaksi",
3
"merchant_id": "99999",
4
"merchant": "FASPAY STORE",
5
"bill_no": "20201222023429",
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": "302",
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": "0feb4628b79905f7bfdbf72085031e9f94235ade"
45
}
Copied!
Post Data Transaction response
You will get the post data response like the following
1
{
2
"response": "Transmisi Info Detil Pembelian",
3
"trx_id": "9999930200008946",
4
"merchant_id": "99999",
5
"merchant": "FASPAY STORE",
6
"bill_no": "20201222023429",
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/0feb4628b79905f7bfdbf72085031e9f94235ade?trx_id=9999930200008946&merchant_id=99999&bill_no=20201222023429"
19
}
Copied!

2. Redirect customer to LinkAja's website

To redirect customer to LinkAja's Website, use redirect_url that retrieved from Post Data Transaction response (JSON Format) or follow the detail API reference Here

3. Callback/Return URL

After the customer completes the payment via LinkAja's website, the LinkAja website automatically redirect customer to Callback/Return URL. Please provide the URL and make sure it's already register on Faspay system. For the detail reference can be find Here

4. 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

Refund LinkAja

Refund Transaction is a transaction that has been successful and then the customer requests a full refund from the merchant, in this case the parameters used in the LinkAja refund are different from the other refund payment channel parameters. Checking is done by POST xml/JSON to the Faspay system
The XML/JSON request parameter refund transaction is the parameters that must be provided by the merchant system to be able to make refund transaction to the Faspay system.
Request
Sample XML Request
Sample JSON Request
Parameter
Data Type
M/O/C
Description
merchant_id
Numeric (5)
M
Merchant Code
Merchant
Alfanumeric (32)
O
Merchant Name
trx_id
Numeric (16)
M
Transaction ID generated by Faspay (Media Indonusa) to be used when making payments in payment channel note: Unique Transaction ID for 1 day or as long as it has not been paid and has not been expired
bill_no
Alfanumeric (32)
M
Order Number
payment_reff
Alfanumeric
M
Payment Reff (from Payment Channel)
payment_channel_uid
Numeric
M
Kode Channel
cancellation_reason
Alfanumeric
M
Cancelation Reason
cancelled_by
Alfanumeric
M
Cancelled By
cancellation_type
Alfanumeric
M
Cancellation Type
Signature
Alfanumeric
M
sha1(md5(user_id+passwd+bill_no))
1
<faspay>
2
<request>Pembatalan Pembelian LinkAja</request>
3
<merchant_id>99999</merchant_id>
4
<merchant>Mi Test</merchant>
5
<trx_id>9999930200000042</trx_id>
6
<bill_no>32434324999999</bill_no>
7
<payment_reff>testi20033111205969884</payment_reff
8
<payment_channel_uid>302</payment_channel_uid
9
<cancellation_reason>Out of stock</cancellation_reason>
10
<cancelled_by>Agus</cancelled_by>
11
<cancellation_type>FULL</cancellation_type>
12
<signature>edf842c4e55d7259b1936d060d2b2adc61f6688c</signature>
13
</faspay>
Copied!
1
{
2
"request" : "Pembatalan Pembelian LinkAja",
3
"merchant_id" : "99999",
4
"merchant" : "Mi Test",
5
"trx_id" : "999993020000004",
6
"bill_no" : "32434324999999",
7
"payment_reff" : "testi20033111205969884",
8
"payment_channel_uid": "302",
9
"cancellation_reason" : "Out of stock",
10
"cancelled_by" : "Agus",
11
"cancellation_type" : "FULL",
12
"signature" : "edf842c4e55d7259b1936d060d2b2adc61f6688c"
13
}
Copied!
Response Refund Full Transaction
Response parameters are parameters that will be sent by the Faspay system in response to parameter requests that have been sent by the merchant system. If there are parameters that do not match / the value is wrong then the transaction will be rejected in the Faspay system.
Response
Sample XML Response
Sample JSON Response
1
<?xml version="1.0" encoding="UTF-8"?>
2
<faspay>
3
<response>Refund Transaksi LinkAja</response>
4
<merchant_id>99999</merchant_id>
5
<merchant>MI Test</merchant>
6
<trx_id>9999930200000042</trx_id>
7
<bill_no>32434324999999</bill_no>
8
<bill_total>0</bill_total>
9
<response_code>00</response_code>
10
<response_desc>Success</response_desc>
11
</faspay>
Copied!
1
{
2
"request" : "Pembatalan Pembelian LinkAja",
3
"merchant_id" : "99999",
4
"merchant" : "Mi Test",
5
"trx_id" : "999993020000004",
6
"bill_no" : "32434324999999",
7
"payment_reff" : "testi20033111205969884",
8
"payment_channel_uid": "302",
9
"cancellation_reason" : "Out of stock",
10
"cancelled_by" : "Agus",
11
"cancellation_type" : "FULL",
12
"signature" : "edf842c4e55d7259b1936d060d2b2adc61f6688c"
13
}
Copied!
Last modified 10mo ago
Copy link