SopagueDocs
v3

Visão geral do cofre de cartões

O Cofre de Cartões permite armazenar com segurança os dados de cartões de crédito e débito para pagamentos futuros e compras com 1 clique (One-Click Buy), sem que o comprador precise reinserir os dados do cartão a cada transação.

Ao armazenar um cartão, a API retorna um vaultId, que identifica o cartão salvo. Utilize esse identificador no campo cardInfo.vaultId ao criar um pagamento. O vaultId identifica o cartão; o paymentId identifica uma transação realizada com ele.

O que você pode fazer

  • Armazenar um cartão — Envie o cartão criptografado ao cofre e obtenha o vaultId.
  • Pagar com um cartão salvo — Utilize o vaultId em vez de reenviar os dados do cartão em compras futuras.

Fluxo de integração

  1. Autentique-se no Gateway para obter o token de acesso.
  2. Obtenha a chave pública do mesmo cliente autenticado, configure a biblioteca e criptografe o cartão. Envie o resultado em encryptCard, na raiz do JSON, junto de expiryDate e customerId ao endpoint de Armazenar Cartão e obtenha o vaultId. Gere um novo conteúdo para cada operação e envie-o imediatamente: a validade é de cinco minutos.
  3. Consulte Criar Pagamento para montar a cobrança utilizando cardInfo.vaultId.

O cofre V2 está disponível para Fiserv. Tokenização prévia não é necessária; criptografia prévia é obrigatória. customerId identifica o pagador e não seleciona a chave de descriptografia.