Tokenização de Cartão com SmartForm

A tokenização permite solicitar o registro de um cartão sem efetuar uma cobrança de valor positivo, por meio do SmartForm. Esse fluxo usa o tipo de Venda TOKENIZATION.

Iniciar a tokenização

Envie POST /v1/charges a partir do servidor:

{
  "type": "TOKENIZATION",
  "order_id": "REGISTRO-CARTAO-0001",
  "amount": 0,
  "currency": "BRL",
  "payments": [
    {
      "payment_method": "smartform",
      "amount": 0
    }
  ],
  "customer": {
    "name": "Cliente Exemplo",
    "email": "[email protected]"
  }
}

A API prepara o formulário usando o fluxo de tokenização da PayZen (Charge/CreateToken). A resposta inicial do Gateway contém os dados do smart_form para renderização, desde que a geração tenha sido concluída com sucesso.

Apresentar o formulário

Use smart_form.public_key e smart_form.token com o script e o HTML explicados em Exibir o Formulário. O comprador fornece os dados do cartão ao componente PayZen, não à sua aplicação.

Recuperar o resultado

A resposta inicial do formulário não é, por si só, o token definitivo para pagamentos futuros. Consulte o resultado da operação e os dados efetivamente retornados pela API/webhook, incluindo o estado da Transação e os campos de token quando presentes.

📘

Sobre o campo create_token

A API também reconhece esse campo booleano em pagamentos. Não o utilize isoladamente para substituir o fluxo TOKENIZATION: no SmartForm, a operação sem cobrança é identificada pelo tipo da Venda.

Cuidados

Não armazene o número completo do cartão nem o código de segurança. Guarde identificadores de token apenas nos sistemas autorizados pela sua política de segurança.

Iniciar Venda · Segurança e Webhooks.