API REFERENCE

Obter método de pagamento secundário

YabandPay documentation·Atualizado em 26 de out. de 2026

Parâmetros

Parameter	Type	Descrição	Obrigatório
data.auth_code	string	通过扫描用户钱包的二维码获得	✓

Use esta API com Quick Payment.

Dica

Observação: use a API Get sub_pay_method com auth_code para identificar se o cliente apresentou um código WeChat Pay ou Alipay+.

Parâmetro	Tipo	Descrição	Obrigatório
user	String	Conta de caixa UID	Obrigatório
sign	String	Signature	Obrigatório
method	String	v3.GetSubPay	Obrigatório
time	Long	Timestamp	Obrigatório

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório
auth_code	String	Obtido ao ler o código QR da carteira do cliente	Obrigatório

Exemplo de assinatura:

Parâmetros ordenados concatenados em uma cadeia de consulta no formato de URL

"auth_code=134443133735495918&method=v3.GetSubPay&time=1555499083&user=YOUR_CASHIER_UID"

Assine a stringA usando secret_key

A assinatura resultante é:

"YOUR_SIGNATURE"

Exemplo de solicitação:

{
	"user": "YOUR_CASHIER_UID",
	"sign": "YOUR_SIGNATURE",
	"method": "v3.GetSubPay",
	"time": 1555499083,
	"data": {
		"auth_code": "YOUR_AUTH_CODE"
	}
}

Exemplo de resposta:

{
    "status": true,
    "code": "200",
    "data": {
        "sub_paymethod": "Wechat Pay"},
    "message": ""}

Tipos de código e regras

Wechat Pay

Código dinâmico numérico de 18 dígitos que identifica um usuário do WeChat Pay. Começa com 10, 11, 12, 13, 14 ou 15 e deve ser lido em tempo real na carteira WeChat do cliente.

Alipay+

Os códigos de pagamento Alipay+ têm quatro tipos: códigos de 19 dígitos Alipay+, códigos CGCP, códigos AlipayCN e códigos AlipayHK. A tabela abaixo descreve cada tipo e suas regras.

QuickPass

Formato codificado em Base64 (cadeia padrão de código QR do App QuickPass)

Tipo	Regras
Código Alipay+ de 19 dígitos	Começa com 28. O terceiro dígito é sempre 9 e o sexto dígito a partir do final é sempre 6. Exemplo: 2893612204263667830.
Código CGCP	Começa com 25, 26, 27, 28, 29 ou 30, seguido por um ID de protocolo de 1 dígitos que identifica o MPP (1 por padrão) e um número de roteamento de 3 dígitos. Exemplo: 281010897274821897274821, em que o número de roteamento é 010.
Código AlipayCN	Comprimento: de 16 a 24 dígitos. Começa com 25, 26, 27, 28, 29 ou 30. Exemplo: 28024456785672301.
Código AlipayHK	Comprimento: de 17 a 19 dígitos. Começa com 25, 26, 27, 28, 29 ou 30. Exemplo: 280244567856723026.
Código Base64 do UnionPay (código de pagamento nativo do QuickPass)	Cadeia codificada em Base64, geralmente iniciada por hQVD, que contém letras maiúsculas e minúsculas, dígitos, +, / e preenchimento final com =. Não há comprimento fixo. Decodifique-a e valide o identificador de protocolo UnionPay. Exemplo: hQVDUFYwMWFWTwigAAADMwEBAlcRYlFkJZZFSTbVASIBUYcYCIljM4ICAACfEBEHAQEDoAAAAQgwMDI1MDAwMZ8mCFbpVlAj7RlynycBgJ82Ar/nnzcEPEEZil80AQE=

Obter método de pagamento secundário