Pagamentos One-Click (CIT)

Os pagamentos one-click permitem que clientes recorrentes paguem com um único clique utilizando um cartão previamente armazenado. Este é um fluxo de Transação Iniciada pelo Cliente (CIT) que utiliza tokenização.

Como Funciona

O fluxo one-click tem duas fases:

1. Primeiro pagamento — O cliente paga normalmente e solicita-se um token para uso futuro
2. Pagamentos subsequentes — Utiliza-se o token armazenado para cobrar ao cliente com um clique

Fase 1: Primeiro Pagamento (Tokenização)

Crie uma encomenda com one_click_type: "first" na transação para solicitar a tokenização:

{
  "merchant_order_id": "first-order",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "one_click_type": "first"
    }
  ]
}

Após um pagamento bem-sucedido, a resposta incluirá um vault_token e first_transaction_id no objeto de transação. Guarde estes valores — vai precisar deles para futuros pagamentos one-click.

{
  "payment_method": "credit-card",
  "payment_method_details": {
    "vault_token": "abc123-stored-token",
    "first_authorised_transaction_id": "txn_def456"
  }
}

Fase 2: Pagamento One-Click

Utilize o vault_token armazenado para criar um pagamento one-click:

{
  "merchant_order_id": "oneclick-order",
  "currency": "EUR",
  "amount": 995,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "one_click_type": "one-click",
      "vault_token": "{vault_token from phase 1}"
    }
  ]
}

Tratamento do CVC

O CVC é opcional para pagamentos one-click. Se quiser recolher o CVC para segurança adicional, inclua-o na transação:

{
  "payment_method": "credit-card",
  "one_click_type": "one-click",
  "vault_token": "{vault_token}",
  "cvc": "123"
}

Endpoints Relacionados

• Criar Encomenda — utilize one_click_type na transação para iniciar a tokenização ou pagamentos one-click