Gerenciando Clientes

A Carteira de Clientes permite cadastrar clientes e associar tokens de cartão a eles. Com isso, você pode reutilizar o cartão salvo em cobranças recorrentes, assinaturas ou novos pedidos — sem que o cliente precise digitar os dados novamente.

Como funciona

Crie um cliente

Cadastre o cliente com nome, e-mail e documento. A API retorna um `customer_id` que identifica o cliente no sistema.

Tokenize um cartão vinculado ao cliente

Use o SDK Dom com o campo `customer_id` para criar um token associado ao perfil do cliente.

Use o `token_card` em transações futuras

Nas próximas cobranças, envie o `token_card` retornado — sem precisar dos dados do cartão novamente.

Consulte e atualize dados do cliente

Edite nome, e-mail ou telefone conforme necessário via API.

Passo 1 — Criar um cliente

curl --request POST \
  --url "{apiUrl}/customer" \
  --header "Authorization: Bearer {token}" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Maria Oliveira",
    "email": "maria@exemplo.com",
    "document": "11144477735",
    "phone": "11999990000"
  }'

Passo 2 — Tokenizar cartão vinculado ao cliente

Passe o customer_id ao tokenizar para que o token fique associado à carteira do cliente:

const { token: cardToken } = await DomCheckout.getTokenCard({
  publicKey: 'SUA_CHAVE_PUBLICA',
  number: '4111111111111111',
  holder_name: 'Maria Oliveira',
  exp_month: '12',
  exp_year: '2028',
  cvv: '123',
  document: '11144477735',
  customer_id: customerId, // vincula o token ao cliente
});

A API retorna um token_card permanente vinculado ao customer_id.

Passo 3 — Cobrar usando o token salvo

curl --request POST \
  --url "{apiUrl}/transactions" \
  --header "Authorization: Bearer {token}" \
  --header "Content-Type: application/json" \
  --data '{
    "amount": 9990,
    "payment_method": "credit_card",
    "card_token": "TOKEN_CARD_DO_CLIENTE",
    "customer_id": "ID_DO_CLIENTE",
    "installments": 1
  }'

Passo 4 — Consultar e editar cliente

curl --request GET \
  --url "{apiUrl}/customer/{id}" \
  --header "Authorization: Bearer {token}"

Gerenciando tokens de cartão

Um cliente pode ter múltiplos cartões associados. Para remover um token:

curl --request DELETE \
  --url "{apiUrl}/card-token/{token_id}" \
  --header "Authorization: Bearer {token}"

[!TIP] Armazene o token_card no seu banco de dados associado ao usuário. Na próxima compra, liste os cartões salvos do cliente e permita que ele escolha sem precisar digitar os dados novamente.

Próximos passos

Configurando Recorrência — use clientes em planos e assinaturas
Tokenizando Cartões — detalhes completos do SDK
Carteira de Clientes — referência completa da API