Dynamic QR code (Dynamic QR)

A dynamic QR code is the optimal payment solution for transactions that require absolute accuracy. Each QR code is generated separately for each order and contains the payment information or a reference code that lets the system identify the transaction.

Before you start

• Base URL: https://uat-open-api.tingee.vn (UAT) · https://open-api.tingee.vn (PROD)
• Authentication: Every request must include the x-client-id and x-request-timestamp headers and the x-signature signature (HMAC SHA512). See Getting an API Key & generating the signature.
• Result: The API always returns HTTP 200; check the code field (00 = success). See Error codes.

🆔 Unique identification

Each QR is tied to a billId, so the system can automatically identify and settle the bill.

⌛ Flexible validity

Supports configuring an expiry time (Expire) to keep fast payment transactions safe.

💯 Automatic reconciliation

Independent of what the customer types in, the system matches payments automatically based on the QR data.

---

Detailed flow diagram

Dynamic QR code flow (Dynamic QR)

← Swipe to see more →

---

Related APIs

Function	Method	Endpoint
Create dynamic QR code	POST	/v1/generate-dynamic-qr
Dynamic QR code status	POST	/v1/get-status-dynamic-qr
Delete dynamic QR code	POST	/v1/delete-dynamic-qr