ShopeePay QRIS Integration Guide
The basic integration process of the ShopeePay QRIS channel will be explained below.
Integration Step:
Post Data Transaction to Faspay
Display QR Code
Payment Notification
1. Post Data Transaction
Post-data transactions should be done from the merchant backend, the detailed API reference can be found Here
This is an example of a post-data transaction for the ShopeePay QRIS channel
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:
Parameter | Data Type | M/O/C | Description |
---|---|---|---|
response | Alphanumeric (50) | M | Response Name |
trx_id | Numeric (16) | M | Transaction 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_id | Numeric (5) | M | Merchant Code |
merchant | Alphanumeric (32) | M | Merchant Name |
bill_no | Alphanumeric (32) | M | Order Number |
bill_items | Array |
|
|
id | Numeric | O | ID product |
product | Alphanumeric | O | Product name |
amount | Numeric | O | Nominal product price |
merchant_id | Numeric (5) | M | Merchant Code |
qty | Numeric | O | Quantity of item |
payment_plan | Numeric | O | Payment code 1: Full Settlement 2: Installement |
tenor | Numeric | O | Installment Tenor 00: Full Payment 03: 3 months 06: 6 months 12: 12 months |
type | Alphanumeric | O | Item type |
url | Alphanumeric | O | Item Link |
image_url | Alfaumeric | O | Image item Link |
response_code | Numeric (2) | M | Response Code 00 Success |
response_desc | Alphanumeric (32) | M | Response Code Description |
web_url | Alphanumeric | C | Original image from channel |
alt_url | Alphanumeric | C | Used if the transaction model uses direct type, displaying only QR code in the browser. |
qr_content | Alphanumeric | C | Data to be encoded in a QR code that will be generated or processed. Notes: Use this if the transaction is direct type. |
redirect_url | Alphanumeric | M | Link to Faspay landing page containing QR image |
2. Display the QR Code
There are two ways to display the QR Code :
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
Last updated