Documentação/Referência da API

API REFERENCE

Cancelar uma divisão de pagamentos

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

Cancelar uma divisão de pagamentos

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

Request parameters4

Required fields first

取消分账

commandRequiredstringdata.commandCancelSplitPayment
nonce_stringRequiredstringdata.nonce_string随机字符串,不长于32位
reference_idRequiredstringdata.reference_id商户方的分账id,不长于32位
split_idRequiredstringdata.split_id创建分账后的分账单号

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

Parâmetros

ParameterTypeDescriçãoObrigatório
data.commandstringCancelSplitPayment✓
data.nonce_stringstring随机字符串,不长于32位✓
data.reference_idstring商户方的分账id,不长于32位✓
data.split_idstring创建分账后的分账单号✓

Esta API cancela um pedido de divisão de pagamentos da YabandPay cujo status seja Processing.

ParâmetroTipoDescriçãoObrigatório
userStringUID da conta de superadministradorObrigatório
signStringSignatureObrigatório
methodStringv3.SplitPaymentObrigatório
timeLongTimestampObrigatório
  • Parameters
ParâmetroTipoDescriçãoObrigatório
commandStringCancelSplitPaymentObrigatório
nonce_stringStringCadeia aleatória com no máximo 32 caracteresObrigatório
reference_idStringID de divisão de pagamentos do estabelecimento, no máximo 32 caracteresObrigatório
split_idStringNúmero do pedido de divisão gerado quando a divisão é criadaObrigatório

Signature example:

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

"command=cancelSplitPayment&method=v3.SplitPayment&nonce_string=0y9nydkzlmivuhs5xz&reference_id=123456&split_id=20231229110618372777&time=1703832252&user=9212776037"

Sign stringA using secret_key

A assinatura resultante é:

"YOUR_SIGNATURE"

Request example:

{
    "user": "9212776037",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.SplitPayment",
    "time": 1703832252,
    "data": {
        "command": "cancelSplitPayment",
        "nonce_string": "0y9nydkzlmivuhs5xz",
        "split_id": "20231229110618372777",
        "reference_id": "123456"
    }
}

Response example:

{
    "status": true,
    "code": "200",
    "data": {
        "split_id": "20231229110618372777",
        "reference_id": "123456",
        "state": "Cancelled"},
    "message": ""
}
  • Response parameters
ParâmetroTipoDescrição
split_idStringNúmero do pedido de divisão gerado quando a divisão é criada
stateStringStatus: Cancelled ou Failed
reference_idStringID de divisão de pagamentos do estabelecimento, no máximo 32 caracteres
referenceStringDescrição, no máximo 128 caracteres