Documentatie/API-referentie

API REFERENCE

Betaalmethode ophalen

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

Betaalmethode ophalen

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters1

Required fields first

获取sub pay method

auth_codeRequiredstringdata.auth_code通过扫描用户钱包的二维码获得

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

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.

ParameterTypeBeschrijvingVerplicht
userStringKassiersaccount UIDVerplicht
signStringSignatureVerplicht
methodStringv3.GetSubPayVerplicht
timeLongTimestampVerplicht
  • Parameters
ParameterTypeBeschrijvingVerplicht
auth_codeStringVerkregen door de wallet-QR-code van de klant te scannenVerplicht

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)

TypeRules
Alipay+ 19-digit codeBegint met 28. Het derde cijfer is altijd 9 en het zesde cijfer vanaf het einde is altijd 6. Voorbeeld: 2893612204263667830.
CGCP codeBegint 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 codeLengte: 16 tot 24 cijfers. Begint met 25, 26, 27, 28, 29 of 30. Voorbeeld: 28024456785672301.
AlipayHK codeLengte: 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=