Merchant Presented Workflow
Below are the steps of the transaction itinerary in a merchant-presented QR Code payment.
- A customer approaches the Point-of-Sale (POS) manager presiding over a customer checkout within an in-store retail environment.
- Upon inquiry, the customer reveals that they want to make the payment for the purchased items via a digital wallet.
- The POS manager selects “Digital Wallet” as the tender type and the POS system calls Pockyt’s /create-trans-qrcode API to generate the QR Code.
- POST: https://mapi.yuansfer.com/app-instore/v3/create-trans-qrcode
curl -XPOST -H "Content-type: application/json" -d '{
"merchantNo": "200043",
"storeNo": "300014",
"verifySign": "45bfac0286debaf0c316c011d6842d2c",
"amount": "0.11",
"currency": "USD",
"settleCurrency": "USD",
"needQrcode" "true",
"reference": "test2020102023",
"ipnUrl": "http://zk-tys.yunkeguan.com/login/test",
"needQrcode": "true",
"vendor": "alipay",
"timeout": "120"
}' 'https://mapi.yuansfer.com/app-instore/v3/create-trans-qrcode'
- The Pockyt endpoint generates the QR Code along with a transaction no. that appears on a customer-facing display.
- The customer opens their digital wallet app and scans the merchant’s QR Code to make the payment. However, before the payment is processed, the customer encounters a UI prompting them to confirm (or cancel) the transaction.
- Upon confirmation, the digital wallet server processes the payment and alerts Pockyt with the transaction result along with a transaction number.
- Pockyt relays the processing results from the wallet service to the merchant’s Point- of-Sale via IPN callback.
See tutorial section attached on how to configure your IPN callback settings
- The Point-of-Sale generates a customer receipt marking the end of the transaction.
Last modified 6mo ago