Obter Token (integração direta)

Aplica-se a estabelecimentos e instituições certificados pelo PCI DSS

Use esta API para concluir um pagamento de ponta a ponta (a verificação 3DS é obrigatória). A YabandPay converte os dados confidenciais do titular do cartão em uma cadeia 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. Depois que o usuário conclui a verificação 3DS nesse url, 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 for bem-sucedida, a YabandPay processará o pagamento. Se falhar, a YabandPay retornará um erro. Nesse caso, recomendamos repetir este fluxo 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=0.1&cardinfo={"card_holder":"John Smith","email":"JohnSmith@gmail.com","card_number":"4356789012345670","expiration_month":"01","expiration_year":"2023","cvc":"123"}&currency=EUR&description=test&method=v3.CreateCardPayments&notify_url=https://www.yabandpay.com/notify&operation=11&order_id=1756878556&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=a7z1lox4l6z6mdx1udgn5gtezasze1x0&sca_exemption=LowValue&sub_pay_method=Card&time=1756878556&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": 1756878556,
	"data": {
		"description": "test",
		"3ds_initiate": "01",
		"timeout": "0",
		"pay_method": "online",
		"sub_pay_method": "Card",
		"operation": "11",
		"order_id": 1756878556,
		"cardinfo": "{\"card_holder\":\"John Smith\",\"card_number\":\"4356789012345670\",\"expiration_month\":\"01\",\"expiration_year\":\"2023\",\"cvc\":\"123\"}",
		"sca_exemption": "LowValue",
		"amount": "0.1",
		"currency": "EUR",
		"email": "JohnSmith@gmail.com",
        "redirect_url": "https://www.yabandpay.com/redirect_url",
        "notify_url": "https://www.yabandpay.com/notify",
		"request_id": "a7z1lox4l6z6mdx1udgn5gtezasze1x0"
	}
}

Exemplo de resposta:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "2b2aa1af-6e97-4c01-8c52-86200bf66c82",
        "amount": "0.1",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/pay_method/Y3JlZGl0Y2FyZA==/MmIyYWExYWYtNmU5Ny00YzAxLThjNTItODYyMDBiZjY2Yzgy",
        "state": "processing"
    },
    "message": "",
    "response_id": "202409091749500451314672"
}

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.

Payment result:

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

2. Uma solicitação malsucedida retorna "status": false.

Redirecione o cliente para url, que foi retornado. Depois de inserir os dados do cartão e concluir o pagamento nesse url, o cliente será redirecionado para redirect_url. Recomendamos fortemente usar Query Order e Asynchronous Notifications para manter os status de pagamento corretos e atualizados.

Returned Token:

1. Depois que o cliente concede a autorização e o pagamento é aprovado, a YabandPay retorna payment_token_object por meio de uma notificação assíncrona.

2. Se o cliente não conceder a autorização ou não concluir o pagamento, a notificação assíncrona não retornará payment_token_object.

3DS low-value exemption:

As 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 de transação 02 (isenção para baixo valor) poderá ser usado mediante aprovação.

Códigos de resposta: