API REFERENCE

Cancelamento de transação

YabandPay documentation·Atualizado em 26 de out. de 2026

Parâmetros

Parameter	Type	Descrição	Obrigatório
data.tid	string	设备的TID	✓
data.trade_id	string	YabandPay订单编号	✓
data.request_id	string	请求id需保持唯一，建议24以上位数字+字母	✓

Aplicável a pagamentos presenciais em POS

Esta API inicia, através da nuvem, o cancelamento de pedidos não pagos.

Isto fecha o ecrã de pagamento no terminal para que o sistema possa iniciar um novo pedido de transação.

API URL (production): https://mapi.yabandpay.com/Payments

API URL (test): https://acc-mapi.yabandpay.com/Payments

Parâmetro	Tipo	Descrição	Obrigatório
user	String	Device TID	Obrigatório
sign	String	Signature	Obrigatório
method	String	v3.POSCancel	Obrigatório
time	Long	Timestamp	Obrigatório

Parameters

Parâmetro	Tipo	Descrição	Obrigatório
tid	string	Device TID	Obrigatório
trade_id	String	Número do pedido YabandPay	Obrigatório
request_id	String	ID de pedido único; recomenda-se uma combinação de letras e números com pelo menos 24 caracteres	Obrigatório

Signature example:

Parâmetros ordenados e concatenados numa cadeia de consulta no formato de URL

 "method=v3.POSReversal&request_id=a7z1lox4l6z6mdx1udgn5gtezasze1x0&tid=T125119061&time=1555498137&trade_id=4a49ffb3-a30f-ba92-9422-1969afb6f121&user=T125119061"

Assine a stringA utilizando secret_key

A assinatura resultante é:

"YOUR_SIGNATURE"

Request example:

 {
  "user": "T125119061",
  "sign": "YOUR_SIGNATURE",
  "method": "v3.POSCancel",
  "time": 1555498137,
  "data": {
   "tid": "T125119061",
		"trade_id": "4a49ffb3-a30f-ba92-9422-1969afb6f121",
    "request_id": "a7z1lox4l6z6mdx1udgn5gtezasze1x0"

  }
}

Response example:

{
  "status": true,
  "code": "200",
  "data": {
        "type": "payment",
        "user": "T125119061",
        "amount": "0.10",
        "currency": "EUR",
        "trade_id": "4a49ffb3-a30f-ba92-9422-1969afb6f121",
        "description": "YabandPay test",
        "order_id": "YOUR_ORDER_ID",
        "createDate": "1706771212",
        "demo": "test",
        "transaction_id": "",
        "state": "cancelled"
  },
  "message": ""}

Additional information:

Response result:

Um pedido bem-sucedido devolve "status": true.
Um pedido mal-sucedido devolve "status": false.

Recomendamos vivamente utilizar tanto as consultas de pedidos como as notificações assíncronas para sincronizar e atualizar o estado do pagamento e manter as informações corretas em tempo real.

Response codes:

Status	Code	Message
true	200
false	-3001	Required field is missing
false	-3002	duplicate request_id
false	-4111	Exceed cancel window
false	-4112	The transaction has been cleared cannot be cancelled
false	-4114	The trade_id does not exist
false	-4115	The transaction cannot be cancelled
false	-4116	The transaction has been cancelled
false	-4117	The transaction has been Expired

Cancelamento de transação