Skip to main content
Em breve. O pagamento com cartão de crédito ainda não está disponível na Bob. Esta referência descreve a estrutura que a API vai retornar quando lançar — por enquanto, use PIX.
Para aceitar cartão de crédito você não envia os dados do cartão para a API Bob. O número do cartão, CVV e validade são coletados e tokenizados no navegador pelo pacote de checkout da Bob (@bobpayments/checkout-sdk) — a sua aplicação e a API só recebem um token seguro.
Nunca envie cartão bruto (PAN, CVV ou validade) para a API Bob. Use o pacote de checkout JS da Bob para tokenizar o cartão no browser. Veja o SDK Checkout.

​
Estrutura

Uma transação de cartão de crédito é representada pela seguinte estrutura:

​
Atributos

​
string
Identificador único da transação no formato CUID.
​
string
Identificador da transação no seu sistema. Use para cruzar dados sem armazenar o id interno. Deve ser único por projeto.
​
integer
Valor da transação em centavos. Exemplo: 25000 = R$ 250,00.
​
string
Nome ou descrição do produto/serviço cobrado.
​
string
Método de pagamento da transação. Para cartão, o valor é credit_card. A Bob gerencia internamente o processamento da tentativa.
​
string
Status atual da transação.
Não considere apenas o HTTP 201 como confirmação de pagamento — use webhook e/ou consulta de status para confirmar o desfecho financeiro.
​
object | null
Dados de exibição do cartão, seguros para armazenar e mostrar ao comprador. brand é a bandeira e last4 são os quatro últimos dígitos. PAN, CVV e validade nunca são retornados — o cartão é tokenizado no browser pelo pacote de checkout da Bob.
​
string | null
E-mail do comprador. Atalho direto ao campo customer.email, disponível no nível raiz da transação.
​
string | null
Nome do comprador. Atalho direto ao campo customer.name, disponível no nível raiz da transação.
​
object
Dados do comprador vinculado à transação. Consulte a entidade Customer.
​
date-time
Data e hora de criação da transação.
​
date-time
Data e hora da última atualização.

​
Próximos passos

Cartão de crédito

Modos de integração, tokenização via SDK e configuração de rota.

SDK Checkout

Tokenize o cartão no navegador sem tocar em PAN ou CVV.