API REFERENCE
Betaalmethode ophalen
Gebruik deze API met Quick Payment.
Tip
Opmerking: gebruik de Get sub_pay_method-API met de auth_code om vast te stellen of de klant een WeChat Pay- of Alipay+-code heeft aangeboden.
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| user | String | Kassiersaccount UID | Verplicht |
| sign | String | Signature | Verplicht |
| method | String | v3.GetSubPay | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| auth_code | String | Verkregen door de wallet-QR-code van de klant te scannen | Verplicht |
Signature example:
Sorted parameters concatenated into a URL-style query string
"auth_code=134443133735495918&method=v3.GetSubPay&time=1555499083&user=YOUR_CASHIER_UID"
Sign stringA using secret_key
The resulting signature is:
"YOUR_SIGNATURE"
Request example:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetSubPay",
"time": 1555499083,
"data": {
"auth_code": "YOUR_AUTH_CODE"
}
}
Response example:
{
"status": true,
"code": "200",
"data": {
"sub_paymethod": "Wechat Pay"},
"message": ""}
Codetypen en regels
Wechat Pay
Een dynamische numerieke code van 18 cijfers die een WeChat Pay-gebruiker identificeert. De code begint met 10, 11, 12, 13, 14 of 15 en moet in realtime uit de WeChat-wallet van de klant worden gelezen.
Alipay+
Alipay+-betaalcodes zijn er in vier typen: Alipay+-codes van 19 cijfers, CGCP-codes, AlipayCN-codes en AlipayHK-codes. De onderstaande tabel beschrijft elk type en de bijbehorende regels.
QuickPass
Base64-gecodeerde indeling (standaard QR-codetekenreeks uit de QuickPass-app)
| Type | Rules |
|---|---|
| Alipay+ 19-digit code | Begint met 28. Het derde cijfer is altijd 9 en het zesde cijfer vanaf het einde is altijd 6. Voorbeeld: 2893612204263667830. |
| CGCP code | Begint met 25, 26, 27, 28, 29 of 30, gevolgd door een protocol-ID van 1 cijfers die de MPP identificeert (standaard 1), en een routeringsnummer van 3 cijfers. Voorbeeld: 281010897274821897274821, waarbij het routeringsnummer 010 is. |
| AlipayCN code | Lengte: 16 tot 24 cijfers. Begint met 25, 26, 27, 28, 29 of 30. Voorbeeld: 28024456785672301. |
| AlipayHK code | Lengte: 17 tot 19 cijfers. Begint met 25, 26, 27, 28, 29 of 30. Voorbeeld: 280244567856723026. |
| UnionPay Base64 code (native QuickPass payment code) | Een Base64-gecodeerde tekenreeks die meestal begint met hQVD en hoofdletters, kleine letters, cijfers, +, / en afsluitende opvultekens = bevat. De lengte staat niet vast. Decodeer de tekenreeks en controleer de protocol-ID van UnionPay. Voorbeeld: hQVDUFYwMWFWTwigAAADMwEBAlcRYlFkJZZFSTbVASIBUYcYCIljM4ICAACfEBEHAQEDoAAAAQgwMDI1MDAwMZ8mCFbpVlAj7RlynycBgJ82Ar/nnzcEPEEZil80AQE= |
