# LinkAja QRIS Integration Guide ## Integration Step 1. Post Data Transaction to Faspay 2. Display QR Code 3. Callback/Return URL 4. Payment Notification ### 1. Post Data Transaction Post-data transactions should be done from the merchant backend, the detailed API reference can be found [Here](https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/post-data-transaction) This is an example of a post-data transaction sample code for the LinkAja QRIS channel: **A. Post Data Transaction Request** {% tabs %} {% tab title="XML Sample Code" %} ```xml Purchased Details Transmission 99999 FASPAY STORE 849389422312 Payment 2023-10-10 09:19:00 2023-10-11 12:10:10 Payment #12345678 IDR 0 0 0 10000 1 Faspay Agus Priyono 715 1 081234567891 sanjayaegasanto@gmail.com 10 payment item faspay 0 jalan pintu air raya Jakarta Pusat DKI Jakarta Indonesia 10710 ID Faspay Agus jalan pintu air raya Jakarta Pusat DKI Jakarta Indonesia 10710 08766688686 ID 123 Glass Plastic 1 10000 01 99999 00 Furniture http://localhost:8088/index https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg 234 Plastic Bucket 1 10000 01 99999 00 Furniture http://localhost:8088/kredivo https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg 0 0d8a326853f3090251fb81b1a56f5c4d5b5f2639 ``` {% endtab %} {% tab title="JSON Sample Code" %} ```json { "request": "Purchased Details Transmission", "merchant_id": 99999, "merchant": "FASPAY STORE", "bill_no": 849389422312, "bill_reff": "Payment", "bill_date": "2023-10-10 09:19:00", "bill_expired": "2023-10-11 12:10:10", "bill_desc": "Payment #12345678", "bill_currency": "IDR", "bill_gross": 0, "bill_tax": 0, "bill_miscfee": 0, "bill_total": 10000, "cust_no": 1, "cust_name": "Faspay Agus Priyono", "cust_lastname": "", "payment_channel": 715, "pay_type": 1, "bank_userid": "", "msisdn": 81234567891, "email": "sanjayaegasanto@gmail.com", "terminal": 10, "billing_name": "payment item faspay", "billing_lastname": 0, "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_msisdn": "", "billing_address_country_code": "ID", "receiver_name_for_shipping": "Faspay Agus", "shipping_lastname": "", "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_msisdn": 8766688686, "shipping_address_country_code": "ID", "item": [ { "id": 123, "product": "Glass Plastic", "qty": 1, "amount": 10000, "payment_plan": 1, "merchant_id": 99999, "tenor": 0, "type": "Furniture", "url": "http://localhost:8088/index", "image_url": "https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg" }, { "id": 234, "product": "Plastic Bucket", "qty": 1, "amount": 10000, "payment_plan": 1, "merchant_id": 99999, "tenor": 0, "type": "Furniture", "url": "http://localhost:8088/kredivo", "image_url": "https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg" } ], "reserve1": 0, "reserve2": "", "signature": "0d8a326853f3090251fb81b1a56f5c4d5b5f2639" } ``` {% endtab %} {% endtabs %} **B. Post Data Transaction Response** Response parameters are the parameters sent by the Faspay system in response to requests made by the merchant system. If any of these parameters do not match or contain incorrect values, the transaction will be rejected by Faspay's system. For the LinkAja QRIS payment method, there are 2 types of transaction models: * Direct Type * Redirect Type Here below are 2 different responses based on the transaction type model.
ParameterData TypeM/O/CDescription
responseAlphanumeric (50)MandatoryResponse Name
trx_idNumeric (16)MandatoryTransaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired
merchant_idNumeric (5)MandatoryMerchant Code
merchantAlphanumeric (32)MandatoryMerchant Name
bill_noAlphanumeric (32)MandatoryOrder Number
bill_itemsArray
idNumericOptionalID product
productAlphanumericOptionalProduct name
amountNumericOptionalNominal product price
merchant_idNumeric (5)MandatoryMerchant Code
qtyNumericOptionalQuantity of item
payment_planNumericOptionalPayment code
1: Full Settlement
2: Installement
tenorNumericOptionalInstallment Tenor
00: Full Payment
03: 3 months
06: 6 months
12: 12 months
typeAlphanumericOptionalItem type
urlAlphanumericOptionalItem Link
image_urlAlfaumericOptionalImage item Link
response_codeNumeric (2)MandatoryResponse Code
00 Success
response_descAlphanumeric (32)MandatoryResponse Code Description
web_urlAlphanumericConditionalUsed if the transaction model uses direct type, displaying only QR code in the browser.
qr_contentAlphanumericConditional

Data will be encoded in a QR code generated or processed.

Notes: Use this if the transaction is direct type.

redirect_urlAlphanumericMandatoryLink to Faspay landing page containing QR image
**Sample Code for Direct Type** {% tabs %} {% tab title="Response Post Data (XML Code)" %} ```xml Purchase Details Transmission 9999971571609433 99999 FASPAY DEMO 849389422312 123 Glass Plastic 1 10000 01 99999 00 Furniture http://localhost:8088/index https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg 234 Plastic Bucket 1 10000 01 99999 00 Furniture http://localhost:8088/kredivo https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg 00 Success https://debit-urgent-staging.faspay.co.id/__assets/qr/linkaja/99999-9999971571609433.png 00020101021226660014ID.LINKAJA.WWW011893600911002140400102152106140914040010303UME51450015ID.OR.GPNQR.WWW02150000000000000000303UME520454995802ID5906Faspay6007Jakarta61051071062200116999997156141292153033605403100630497F4 ``` {% endtab %} {% tab title="Response Post Data (JSON Code)" %} ```json { "response": "Purchase Details Transmission", "trx_id": 9999971571609432, "merchant_id": 99999, "merchant": "FASPAY DEMO", "bill_no": 849389422312, "bill_items": [ { "id": 123, "product": "glass plastic", "qty": 1, "amount": 10000, "payment_plan": 1, "merchant_id": 99999, "tenor": 0, "type": "Furniture", "url": "http://localhost:8088/index", "image_url": "https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg" }, { "id": 234, "product": "plastic bucket", "qty": 1, "amount": 10000, "payment_plan": 1, "merchant_id": 99999, "tenor": 0, "type": "Furniture", "url": "http://localhost:8088/kredivo", "image_url": "https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg" } ], "response_code": 0, "response_desc": "Success", "web_url": "https://debit-urgent-staging.faspay.co.id/__assets/qr/linkaja/99999-9999971571609433.png", "qr_content": "00020101021226660014ID.LINKAJA.WWW011893600911002140400102152106140914040010303UME51450015ID.OR.GPNQR.WWW02150000000000000000303UME520454995802ID5906Faspay6007Jakarta61051071062200116999997156141292153033605403100630497F4" } ``` {% endtab %} {% endtabs %} **Sample Code Response Post Data (Redirect Type)** {% tabs %} {% tab title="Response Post Data (XML)" %} ```xml Purchase Details Transmission 9999971150758059 99999 FASPAY DEMO 163b4ef032520a7.07128111 01 Glass Plastic Prem 1 1000000 01 99999 00 Furniture http://localhost https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg 00 Success https://web.faspay.co.id/pws/100003/2830000010100000/92fb23821115e920a979b3c28ea969d98ac76497?trx_id=9999971150758059&merchant_id=99999&bill_no=163b4ef032520a7.07128111 ``` {% endtab %} {% tab title="Response Post Data (JSON)" %} ```json { "response": " Purchase Details Transmission", "trx_id": "9999971150758059", "merchant_id": "99999", "merchant": "FASPAY DEMO", "bill_no": "163b4ef032520a7.07128111", "bill_items": [ { "id": "01", "product": "Glass Plastic Prem", "qty": "1", "amount": "1000000", "payment_plan": "01", "merchant_id": "99999", "tenor": "00", "type": "Furniture", "url": "http://localhost", "image_url": "https://cdn.mos.cms.futurecdn.net/Mffc35PH77Dq7USrHb4qNm-1200-80.jpg" } ], "response_code": "00", "response_desc": "Success", "redirect_url": "https://web.faspay.co.id/pws/100003/2830000010100000/92fb23821115e920a979b3c28ea969d98ac76497?trx_id=9999971150758059&merchant_id=99999&bill_no=163b4ef032520a7.07128111" } ``` {% endtab %} {% endtabs %} ### 2 Display QR Code Here are two ways to display the QR Code: * **Redirect Type**: To display the QR Code on Faspay's page, redirect using the `redirect_url` obtained from the Post Data Transaction Response (in JSON format), or refer to the detailed API reference for more information [Here](file:///merchant-integration/api-reference-1/debit-transaction/redirect-process) * **Direct Type:** To display the QR Code on the merchant's page, if the frontend is HTML, you can use the `web_url` retrieved from the post-data transaction within an image tag like this: ``. Alternatively, you can display it on a similar component without downloading. However, if the front end does not support this scenario, you should download and display the QR code image from that URL on the front end. ### 3 Callback/Return URL After the customer completes the payment via LinkAja's website, the LinkAja website automatically redirects the customer to the Callback/Return URL. Please provide the URL and make sure it's already registered on the Faspay system. For details, reference can be found [Here](file:///merchant-integration/api-reference-1/debit-transaction/url-callback-return-url) ### 4 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 the Faspay system The detailed API reference can be found [here](file:///merchant-integration/api-reference-1/debit-transaction/payment-notification)