Obter configurações do 3DS

Use este endpoint para decidir, antes de cobrar, se o checkout precisa rodar a autenticação 3DS no navegador do comprador. A resposta traz a política que o POST /payment aplica à sua empresa: se o 3DS está ligado, o valor mínimo a partir do qual ele é exigido e qual SDK carregar.

A autenticação é feita pelo mesmo header x-api-key usado em POST /payment.

Quando chamar

A resposta só muda quando a Bestfy altera a política de risco da sua empresa. Chame uma vez ao carregar o checkout e reaproveite o resultado em todas as tentativas de pagamento daquela sessão.

Diferente do GET /payment/tds-token, este endpoint não gera token no autenticador. Pode ser chamado mesmo quando o 3DS está desligado.

Resposta

{
  "threeDsEnabled": true,
  "threeDsMinAmountInCents": 5000,
  "threeDsProvider": "STONE"
}

Campo	Tipo	Descrição
`threeDsEnabled`	`boolean`	`true` quando o pagamento com cartão da sua empresa exige 3DS.
`threeDsMinAmountInCents`	`number \| null`	Valor mínimo, em centavos, a partir do qual o 3DS é eabled: true` significa que o 3DS é exigido em qualquer valor.
`threeDsProvider`	`"STONE" \| "BRASPAG" \| null`	SDK que deve ser carregado no navegador.

Com o 3DS desligado, a resposta é sempre:

{
  "threeDsEnabled": false,
  "threeDsMinAmountInCents": null,
  "threeDsProvider": null
}

Como decidir se roda o 3DS

Rode a autenticação quando:

threeDsEnabled && (threeDsMinAmountInCents === null || valorTotal >= threeDsMinAmountInCents)

valorTotal é o total cobrado no POST /payment, em centavos.

Quando a regra for verdadeira:

Gere o token em GET /payment/tds-token.

Rode o SDK do provedor indicado em threeDsProvider.

Envie o resultado em creditCard.threeDsAuthentication no POST /payment.

Se o pagamento exigir 3DS e chegar sem a autenticação, o POST /payment responde 400 com COMPANY_E028.

O pagamento com creditCardToken (cartão já salvo) nunca exige 3DS.

Erros comuns

Código	Motivo
`401`	API key ausente ou inválida
`403`	API key revogada
`404`	`COMPANY_E002`: a empresa da API key não existe mais

Obter configurações do 3DS

Quando chamar

Resposta

Como decidir se roda o 3DS

Erros comuns

Request

Responses

Obter configurações do 3DS

Quando chamar#

Resposta#

Como decidir se roda o 3DS#

Erros comuns#

Request

Responses

Quando chamar

Resposta

Como decidir se roda o 3DS

Erros comuns