# ShopeePay QRIS Integration Guide ## Integration Step: 1. Post Data Transaction to Faspay 2. Display QR Code 3. 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 for the ShopeePay QRIS channel** {% tabs %} {% tab title="Request Post Data (XML)" %} ```xml Purchased Info Detail Transmission 99999 FASPAY STORE 849389422312 Payment item 2023-10-10 09:19:00 2023-10-10 09:59:10 Payment #12345678 IDR 0 0 0 10000 1 Faspay Agus Priyono 711 1 081234567891 sanjayaegasanto@gmail.com 10 payment item faspay 0 jalan pintu air raya Jakarta Pusat DKI Jakarta Indonesia 10710 ID Faspay Agus Priyono 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="Request Post Data (JSON)" %} ```json { "request": "Purchased Info Detail Transmission", "merchant_id": 99999, "merchant": "FASPAY STORE", "bill_no": 849389422312, "bill_reff": "Payment item", "bill_date": "2023-10-10 09:19:00", "bill_expired": "2023-10-10 09:59: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": 711, "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 Priyono", "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 %} #### Post Data Response For the ShopeePay 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. You will get the post-data response like the following: {% tabs %} {% tab title="Parameter Body" %}
ParameterData TypeM/O/CDescription
responseAlphanumeric (50)MResponse Name
trx_idNumeric (16)MTransaction 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)MMerchant Code
merchantAlphanumeric (32)MMerchant Name
bill_noAlphanumeric (32)MOrder Number
bill_itemsArray
idNumericOID product
productAlphanumericOProduct name
amountNumericONominal product price
merchant_idNumeric (5)MMerchant Code
qtyNumericOQuantity of item
payment_planNumericOPayment code
1: Full Settlement
2: Installement
tenorNumericOInstallment Tenor
00: Full Payment
03: 3 months
06: 6 months
12: 12 months
typeAlphanumericOItem type
urlAlphanumericOItem Link
image_urlAlfaumericOImage item Link
response_codeNumeric (2)MResponse Code
00 Success
response_descAlphanumeric (32)MResponse Code Description
web_urlAlphanumericCOriginal image from channel
alt_urlAlphanumericCUsed if the transaction model uses direct type, displaying only QR code in the browser.
qr_contentAlphanumericC

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

Notes: Use this if the transaction is direct type.

redirect_urlAlphanumericMLink to Faspay landing page containing QR image
{% endtab %} {% tab title="Direct Type (XML)" %} {% code overflow="wrap" %} ```xml Purchased Details Transmission 1999971167165382 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://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=oVS1YffoM8BHY1b86hgqGcdPpkW4wpN4ExEuVWIJiZ https://debit-urgent-staging.faspay.co.id/__assets/qr/99999-1999971167165382.png 00020101021226560016ID.CO.SHOPEE.WWW011893600918000000026602032660303UBE5204123453033605406100.005802ID5912Faspay Store6015KOTA JAKARTA SE610512345622805241999971167165382-667171363041C94 ``` {% endcode %} {% endtab %} {% tab title="Direct Type (JSON)" %} ```json { "response": "Purchased Detail Transmission", "trx_id": 1999971167165382, "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://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=oVS1YffoM8BHY1b86hgqGcdPpkW4wpN4ExEuVWIJiZ", "alt_url": "https://debit-urgent-staging.faspay.co.id/__assets/qr/99999-1999971167165382.png", "qr_content": "00020101021226560016ID.CO.SHOPEE.WWW011893600918000000026602032660303UBE5204123453033605406100.005802ID5912Faspay Store6015KOTA JAKARTA SE610512345622805241999971167165382-667171363041C94" } ``` {% endtab %} {% tab title="Redirect Type (XML)" %} ```xml Purchase Details Transmission 9999971150758059 99999 FASPAY DEMO 163b4ef032520a7.07128111 01 Glass Plastic 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="Redirect Type (JSON)" %} {% code overflow="wrap" %} ```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", "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" } ``` {% endcode %} {% endtab %} {% endtabs %} ### 2. Display the QR Code There are two ways to display the QR Code :
Redirect Type Display the QR Code on Faspay's page, to do this just redirect the use `redirect_url` which is retrieved from the Post-Data Transaction response (JSON Format) or follows the detailed API reference [Here](https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/redirect-process)
Direct Type Display the QR Code on the merchant's page, if the frontend is HTML, put the `web_url` retrieved from post data transaction in the image tag ``, or display it on a similar component without downloading. If the front end does not support such a scenario, download the QR code image from that URL, then display it on the front end.
### 3. Payment Notification The payment notification from Faspay to the Merchant backend will also be triggered in the event of the transaction status being 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](https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/payment-notification)