In-Store APIs

Enable point-of-sale (POS) payment acceptance through QR code-based workflows. Use these endpoints to create transactions, process payments, and manage QR codes for physical retail environments.

What You'll Find in This Section

Pockyt supports three QR code presentation modes, each suited to a different in-store setup:

  • Customer Presents QRC: The customer opens their payment app (Alipay, WeChat Pay, etc.) and displays a QR code. The merchant scans it using their POS system. Use Create New Transaction to initiate the payment and Process Payment to submit the scanned QR code for processing.

  • Merchant Presents QRC: The merchant generates a QR code tied to a specific transaction amount. The customer scans it with their payment app to complete the payment. Use the Create QR Code endpoint to generate the code.

  • Merchant Presents MixedQRC: A single QR code pre-configured to support multiple payment methods. The customer scans the code with any supported payment app — Alipay, WeChat Pay, or whichever methods have been enabled — and the payment is processed automatically through that app. Use Generate Mixed QR Code to create one, Query Mixed QR Code Transaction to check its status, and Cancel Mixed QR Code Transaction to void it.

  • Cancel Payment: Available across the Customer Presents and Merchant Presents flows. Use this endpoint to void a transaction before it settles. MixedQRC has its own dedicated cancel endpoint listed within that sub-section.

📘

Which mode to choose: Customer Presents QRC is the most common for high-volume retail. Merchant Presents QRC works well for fixed-amount payments or display-based setups. MixedQRC gives customers the most flexibility — they scan one code and pay with whichever app they prefer.

⚠️

Authentication: All endpoints require merchantNo, storeNo, and a verifySign parameter signature. See Authentication for details.