API REFERENCE

Transferência bancária

YabandPay documentation·Atualizado em 26 de out. de 2026

Parâmetros

Parameter	Type	Descrição	Obrigatório
data.request_id	string	请求id需保持唯一，建议24以上位数字+字母	✓
data.pay_method	string	online	✓
data.sub_pay_method	string	Bank Transfer	✓
data.order_id	string	商户的订单ID	✓
data.amount	string	金额数字。例如 € 24.99 应该写成24.99，欧元金额>=1	✓
data.currency	string	EUR	✓
data.description	string	订单描述	✓
data.email	string	用户邮箱	—
data.demo	string	自定义字段	—
data.timeout	string	过期时间单位分钟(0-1440)	✓
data.redirect_url	string	支付完成后跳转地址	—
data.notify_url	string	支付完成后异步通知地址	✓

Aplicável a: transferências bancárias do utilizador

Paybybank é um método seguro de pagamento por transferência bancária disponibilizado pela YabandPay. Os clientes pagam transferindo fundos diretamente das suas contas bancárias para a conta indicada pela YabandPay.

Esta solução é ideal para comerciantes que procuram custos mais baixos e transações fiáveis sem depender de redes de cartões. Assim que recebe a transferência, a YabandPay verifica automaticamente o pagamento e atualiza o estado da transação, proporcionando uma experiência de pagamento simples para comerciantes e clientes.

Dica

O Paybybank só aceita transferências através da rede SEPA (Área Única de Pagamentos em Euros). Não são aceites transferências SWIFT.

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

Parameters

Parâmetro	Tipo	Descrição	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
pay_method	String	online	Obrigatório
sub_pay_method	String	Bank Transfer	Obrigatório
order_id	String	ID do pedido do comerciante	Obrigatório
amount	String	Montante numérico. Por exemplo, € 24.99 deve ser indicado como 24.99; montante em euros >=1	Obrigatório
currency	String	EUR	Obrigatório
description	String	Descrição do pedido	Obrigatório
email	String	Endereço de e-mail do utilizador	Opcional
demo	String	Campo personalizado	Opcional
timeout	String	Tempo de expiração em minutos (0-1440)	Obrigatório
redirect_url	String	URL de redirecionamento após o pagamento	Opcional
notify_url	String	URL de notificação assíncrona após o pagamento	Obrigatório

Signature example:

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

"amount=0.1&currency=EUR&demo=test&description=Test&email=info@yabandmedia.com&method=v3.BankTransfer&notify_url=https://www.yabandpay.com/notify&order_id=12455555788&pay_method=online&redirect_url=https://www.yabandpay.com&request_id=001123456789&sub_pay_method=Bank Transfer&time=1653145918&timeout=0&user=YOUR_CASHIER_UID"

Assine a stringA utilizando secret_key

A assinatura resultante é:

"YOUR_SIGNATURE"

Request example:

{
    "user": "YOUR_CASHIER_UID",
    "method": "v3.BankTransfer",
    "time": "1653145918",
    "sign": "YOUR_SIGNATURE",
    "data": {
        "request_id": "001123456789",
        "order_id" : "YOUR_ORDER_ID",
        "pay_method": "online",
        "sub_pay_method": "Bank Transfer",
        "email": "info@yabandmedia.com",
        "description": "Test", 
        "timeout" : "0",
        "amount": "0.1",
        "currency": "EUR",
        "redirect_url": "https://www.yabandpay.com",
        "notify_url" : "https://www.yabandpay.com/notify",
        "demo": "test"
    }
}

Response example:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "d3a81009-2b3c-9f2c-8e33-45dc932ee757",
        "amount": "0.10",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/prod/bank_transfer/ZDNhODEwMDktMmIzYy05ZjJjLThlMzMtNDVkYzkzMmVlNzU3",
        "state": "processing"
    },
    "message": "",
    "response_id": "202505131817352897785689"
}

Additional information:

Response result:

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

Recomendamos utilizar Asynchronous Notifications para atualizar o estado do pagamento e manter as informações corretas em tempo real.

Response codes:

Status	Code	Message
true	200	Success
false	-1000	Internal error
false	-3001	Required field is missing
false	-403	The signature Error
false	-4011	Not support the payment method

Transferência bancária