A tokenização permite que você salve um cartão de crédito de forma segura e reutilize esse cartão em cobranças futuras sem precisar enviar os dados sensíveis novamente.Na prática, o número completo do cartão (PAN) fica armazenado exclusivamente na adquirente. A Bestfy guarda apenas uma referência opaca ao cartão, junto com informações não sensíveis como BIN, últimos quatro dígitos, bandeira e nome do titular que é suficiente para executar cobranças sem expor o dado real.Como funciona?#
O fluxo acontece em três etapas:1.
Obter o identificador do cliente: Ao criar qualquer transação (Pix, boleto ou cartão), a resposta devolve um customerId que identifica o comprador dentro da sua empresa.
2.
Tokenizar o cartão: Com o customerId em mãos, a rota POST /payment/credit-card-token recebe os dados do cartão, cria esse cartão na adquirente e devolve um cardId.
3.
Cobrar com o token: A partir daí, basta enviar customerId e cardId na rota POST /payment para cobrar o cartão salvo, sem precisar informar os dados do cartão nem os dados do cliente novamente.
cardId pode ser usado em quantas cobranças forem necessárias, ideal para recorrências, renovações ou experiências de compra com um clique. Modified at 2026-09-17 15:54:14
