Pagamentos por token

Aplica-se a: iniciar pagamentos com Token — cartões de crédito

Depois que o pagador conclui uma transação padrão com cartão de crédito na página hospedada da YabandPay e dá seu consentimento, a YabandPay converte os dados confidenciais do titular do cartão em uma cadeia numérica aleatória (um Token) para remover informações de identificação. O Token pode ser usado nos seguintes pagamentos:

1. Os usuários podem pagar com um clique na página de checkout, sem inserir os dados do cartão de crédito.
2. Os estabelecimentos podem usar este Token para pagamentos recorrentes, cobranças de assinaturas e finalidades semelhantes.

[!TIP|style:flat] Fluxo de trabalho

1. Ative os pagamentos com Token. Entre em contato com seu gerente de conta para habilitar esse recurso.

2. Obtenha o consentimento do usuário. Ao habilitar pagamentos expressos (pagamentos com Token) para consumidores, informe-os claramente e obtenha seu consentimento para evitar possíveis disputas.

3. Obtenha um Token. Primeiro, inicie uma transação padrão com cartão de crédito. A YabandPay retorna um url de pagamento. Depois que o usuário conclui o pagamento nesse url e dá seu consentimento, a YabandPay retorna o Token em uma notificação assíncrona usando o parâmetro payment_token_object.

4. Inicie um pagamento com Token. Inclua o Token na variável payment_token_object. Se a validação do Token for bem-sucedida, a YabandPay processará o pagamento. Se falhar, a YabandPay retornará um erro. Nesse caso, recomendamos iniciar outra transação padrão com cartão de crédito para obter um Token e iniciar o pagamento novamente.

• Parâmetros

Exemplo de assinatura:

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

"3ds_initiate=01&amount=1&currency=EUR&description=test&method=v3.CreateCardPayments&notify_url=https://www.yabandpay.com/notify&operation=11&order_id=1725875543&pay_method=online&payment_token_object=VnXaRabcsedfsSlPFZXavcsdfasdEFDd&request_id=hjf5lv32i40lh7oh86j6az98tnscwv37&sub_pay_method=Token&time=1725875543&timeout=0&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.CreateCardPayments",
    "time": 1725875543,
    "data": {
        "3ds_initiate": "01",
        "description": "test",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "Token",
        "operation": "11",
        "order_id": 1725875543,
        "amount": "1",
        "currency": "EUR",
        "payment_token_object": "VnXaRabcsedfsSlPFZXavcsdfasdEFDd",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "hjf5lv32i40lh7oh86j6az98tnscwv37"
    }
}

Exemplo de resposta:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "109bb0e9-e1fb-49cb-c537-ec944f33c388",
        "amount": "1.00",
        "currency": "EUR",
        "state": "paid"
    },
    "message": "",
    "response_id": "202409091752241912726578"
}

Informações adicionais:

MIT & CIT :

MIT = transações subsequentes iniciadas pelo estabelecimento. Pagamentos com Token iniciados pelo estabelecimento.

CIT = transações subsequentes iniciadas pelo titular do cartão. Pagamentos com Token iniciados pelo cliente. Ao ativar os pagamentos, especifique se precisa de MIT ou CIT para que o modo apropriado seja configurado.

Resultado da resposta:

1. Uma solicitação bem-sucedida retorna "status": true.

2. Se a chamada falhar, "status": false é retornado. Se você receber Invalid Token, recomendamos chamar novamente HPP Token para obter um novo Token.

A API retorna o status do pagamento de forma síncrona. Recomendamos fortemente usar Order Query e Asynchronous Notifications para sincronizar e atualizar o status do pagamento e manter as informações corretas em tempo real. a) Se o status do pedido state for paid, o pagamento foi bem-sucedido; b) se o status do pedido state for authorized, a autorização foi bem-sucedida. Para capturar os fundos após a autorização bem-sucedida, chame a API de captura de autorização.

3DS low-value exemption:

Transações dentro dos limites a seguir podem se qualificar como transações de baixo valor. Se o valor do pedido for menor ou igual ao limite aplicável abaixo, o código 02 (isenção para baixo valor) poderá ser usado mediante aprovação.

Códigos de resposta: