The document summarizes StarPay's Online Payment Gateway API, which allows merchants to accept payments from multiple international QR payment brands through a single connection. It describes the merchant-presented mode in which merchants generate dynamic QR codes for products/orders that users scan using wallet apps to pay. The payment flow involves the user scanning the QR code, confirming payment on their wallet app, and receiving a success notification, while the merchant receives a callback notification to complete orders. Data transmission uses HTTPS POST with JSON format and UTF-8 encoding, and includes digital signatures for authentication and integrity.
The document summarizes StarPay's Online Payment Gateway API, which allows merchants to accept payments from multiple international QR payment brands through a single connection. It describes the merchant-presented mode in which merchants generate dynamic QR codes for products/orders that users scan using wallet apps to pay. The payment flow involves the user scanning the QR code, confirming payment on their wallet app, and receiving a success notification, while the merchant receives a callback notification to complete orders. Data transmission uses HTTPS POST with JSON format and UTF-8 encoding, and includes digital signatures for authentication and integrity.
The document summarizes StarPay's Online Payment Gateway API, which allows merchants to accept payments from multiple international QR payment brands through a single connection. It describes the merchant-presented mode in which merchants generate dynamic QR codes for products/orders that users scan using wallet apps to pay. The payment flow involves the user scanning the QR code, confirming payment on their wallet app, and receiving a success notification, while the merchant receives a callback notification to complete orders. Data transmission uses HTTPS POST with JSON format and UTF-8 encoding, and includes digital signatures for authentication and integrity.
The document summarizes StarPay's Online Payment Gateway API, which allows merchants to accept payments from multiple international QR payment brands through a single connection. It describes the merchant-presented mode in which merchants generate dynamic QR codes for products/orders that users scan using wallet apps to pay. The payment flow involves the user scanning the QR code, confirming payment on their wallet app, and receiving a success notification, while the merchant receives a callback notification to complete orders. Data transmission uses HTTPS POST with JSON format and UTF-8 encoding, and includes digital signatures for authentication and integrity.
1 StarPay Online Payment API Introduction: Using StarPay's Online Payment Gateway, Merchants can activate payment acceptance of multi International QR payment brands with one single connection.
Mode: Merchant Presented Mode is a mode in which the merchant system generates a payment QR code according to the interface protocol, and the user scans the code using the corresponding payment software or QR code reader to complete the payment.
Use cases: This mode is suitable for scenarios such as Online Website Payments, Mobile Website Payments, Self-service Vending Machines, All-in-one Game Machines, All-in-one printers, Fully Automatic Internet-Connected Washing Machines with screen payment equipment, Physical Store Items or Order Payments.
User scanning dynamic QR code on machine screens
Examples of machines with screens for QR payment
2 StarPay Online Payment API Description: Step 1: After the Merchant WebShop’s Shopping Cart System calls the rules according to the interface, after obtaining accurate data, it generates different two-dimensional codes for different products or orders and displays them in various scenarios, such as Online Merchant Webshops or Physical Machine Screens, for users to scan and purchase.
Step 2: Depending on which Wallet is used, the operation interface might be slightly different. After User scans the displayed dynamic QR code with their Wallet’s Mobile App, User is guided to confirmation page on their Wallet Mobile App to complete the payment.
Step 3: User confirms the payment on their Wallet Mobile App and enters the payment password. Some Wallets require Users to entire the payment password first before they are directed to the QR code scanning screen on their Wallet Mobile App.
Step 3 – User enters password Step 4 – User Wallet’s Payment Successful Page
Step 4: After payment is completed, User will be notified on their Wallet Mobile App that the payment is successful. The Merchant Webshop’s Shopping Cart System back end will be then notified of the successful payment for the order to be shipped or delivered.
3 StarPay Online Payment API Online Payment Flow:
This is the logic flow of a payment transaction on a Merchant Webshop:
(1) User opens Merchant's Webshop to purchase goods, initiates payment, calls the getBrandWCPayRequest interface via JavaScript on the webpage, initiates a WeChat payment request, and the user enters the payment process.
(2) After User successfully pays and clicks the Finish button, Merchant Webshop’s front page will receive the return value of JavaScript. Merchant’s Webshop should then display Successful Payment Page.
(3) Merchant Webshop’s back end receives a notification of a successful payment callback from Wallet’s open platform, indicating that the payment of the order was successful.
Note: The triggers of (2) and (3) are not guaranteed to follow strict timing. The return value of JSAPI is used as a sign to trigger the redirection of the Merchant's Webshop, but the Merchant Webshop Shopping Cart system should only process the real successful payment only after receiving the notification of the payment success callback from Wallet.
4 StarPay Online Payment API Data Transmission: Transfer Method: HTTPS POST Data Format Sent and Received: JSON Data Encoding: UTF-8
Application Environment: 1. Client Support SNI (Server Name Indication) 2. Transport Protocol Support TLS1.2
Digital Signature: In order to ensure the authenticity and integrity of the data during data transmission, the data needs to be digitally signed. The StarPay Server performs signature verification when receiving or sending.
