3D Secure, Parcelamento e Captura Manual

Os parâmetros de autenticação, parcelamento e captura ficam no item de pagamento enviado pelo servidor em POST /v1/charges.

Solicitar autenticação 3D Secure

Envie enable_3ds: true:

{
  "type": "PAYMENT",
  "order_id": "PEDIDO-3DS-0001",
  "amount": 3000,
  "currency": "BRL",
  "payments": [{
    "payment_method": "smartform",
    "amount": 3000,
    "enable_3ds": true
  }],
  "customer": {
    "name": "Cliente Exemplo",
    "email": "[email protected]"
  }
}

O Gateway solicita autenticação conforme as regras do provedor. A exibição de um desafio não é garantida: ela depende da transação e das regras de autenticação aplicadas.

Informar parcelamento

Se o estabelecimento oferecer parcelamento, utilize installments no pagamento. Exemplo parcial:

{
  "payment_method": "smartform",
  "amount": 3000,
  "installments": 3
}

A quantidade de parcelas precisa respeitar as condições configuradas no estabelecimento e aceitas pelo provedor. Não presuma um limite universal para todos os contratos SmartForm.

Solicitar captura manual

O Gateway disponibiliza na sua documentação pública somente a configuração manual para o campo capture:

{
  "payment_method": "smartform",
  "amount": 3000,
  "capture": "manual"
}

Quando não precisar solicitar captura manual, omita o campo capture.

🚧

Autorização não é liquidação

Em fluxos com captura manual, a operação autorizada ainda pode depender de captura para concluir sua liquidação. Consulte o estado atualizado da Transação e a documentação de captura do Gateway antes de informar a conclusão ao comprador.

Conferência do resultado

Confirme pela consulta à Venda/Transação ou webhook. O estado da Venda não equivale necessariamente ao da Transação ou ao seu estado detalhado.

Iniciar Venda · Resultado e Comprovante.