QRIS Integration & Testing

13 min

QRIS use in the integration and testing process originates from ShopeePay. However, QRIS ShopeePay also can receive payment from other Partners, such as OVO, DANA, LinkAja, and Mobile Banking that support QR payment.

Integration Steps and API Used

Perform API Order Registration integration.

SNAP: Registration - API QRIS SNAP.

Redirect: QRIS - API Checkout.

Receive NICEPAY callback and push notification.

Perform API Inquiry Status integration.

SNAP: Check Status Transaction - API QRIS SNAP.

Redirect: Status Inquiry - API Checkout.

Optional: perform API Cancel integration to cancel transaction.

SNAP: Refund Transaction - API QRIS SNAP.

Redirect: Cancel - API Checkout.

Credential for Testing QRIS

QRIS Name	Description
ShopeePay	APK Shopee \| APK ShopeePay Username: nicepaytest01 Password: NicepayTest01 ShopeePay PIN: 142536

Merchants must whitelist the IP address of the device used for testing through the ShopeePay or Shopee application.

Please contact the NICEPAY Integration Team for further information.

QRIS Testing Guide

QRIS Name	Test Step	Rules and Condition
ShopeePay	Use real iMid or Sandbox with iMid = IONPAYTEST. Download a specific ShopeePay application for testing on the Development Environment or real Shopee application for testing on the Staging/Production Environment. Scan the QR code and perform payment authentication. Collect information and proceed transaction until transaction successful.	For QR code: Default time limit rules for paymentExpTm = 5 minutes. Time period setting for paymentExpTm start from 5 minutes to 20 minutes. For transaction cancellation conditions, which are: Cancellation before the transaction will show expired or invalid with status 5. Online refund can only perform before the transaction reached 365 days since its created. Transaction cancellation can't be processed during the time 00:00 - 05:00 WIB. Off-Us transaction only performs online refund before the transaction reached 7 days time limit. If the transaction have already passed 7 days but still haven't reached 365 days, will turn into a Manual Refund.

Failed Transaction Possible Reason

Scan wrong QR code on ShopeePay application.

Order does not match.

Transaction already expired.

Integration Checklist & Test Case

Implement inquiry status after receiving the callback.

Implement inquiry status after receiving the notification inside dbProcessUrl.

Review payment log.

Review firewall setting (eg. cloudflare for dbprocessUrl setting).

Check merchantToken implementation.

Execute test scenarios in Development Environment.

Execute test scenarios in Production Environment. Get Sample Scenario

Review Error Handling (Timeout, Failed, Negative Case).

Best Practice

For Merchant testing, can use iMid = IONPAYTEST and set shopId = NICEPAY parameter.

Support for fully QRIS cancellation can use cancelType link code.

When notification is received on your dbProcessUrl, NICEPAY strongly recommend Merchant to verify the notification using the Inquiry API.

Notification Handling is helpful to minimalize Fraud actions, NICEPAY strongly recommends Merchant to verify the Notification Handling.