Skip to main content
O SDK JS do Therius é o complemento do lado do navegador para a API de pagamentos do Therius. Ele renderiza os campos de cartão dentro de iframes hospedados pelo Therius, então um PAN bruto nunca transita pelo seu servidor — você só recebe um nonce de uso único ou um PaymentResult final. A sua página de checkout controla o layout e o estilo; o Therius controla o que acontece dentro de cada campo.

​
Quando usar o SDK

Campos hospedados

Use campos hospedados ou o Widget de checkout ao aceitar cartões diretamente de um navegador. O seu DOM nunca contém um número de cartão bruto.

Botões de carteira

Use botões de carteira para Apple Pay e Google Pay. A folha de pagamento nativa trata a autenticação; o Therius descriptografa o resultado no lado do servidor.

Click to Pay

Use o Click to Pay para os cartões salvos em nível de rede da Visa e da Mastercard. Os titulares de cartão se autenticam sem digitar os dados novamente.

Redirecionamentos de APM

Use sdk.purchaseApm para métodos de pagamento alternativos baseados em redirecionamento, como iDEAL, Klarna e Pix.
Para integrações servidor a servidor — serviços de backend ou apps nativos móveis — use a API REST diretamente. O SDK JS é apenas para navegador.

​
Instalação

Ou carregue o SDK via CDN sem nenhum passo de build:

​
Inicialização

Importe e inicialize o SDK com um clientToken obtido do seu servidor. A sua chave de API privada nunca sai do backend.
TheriusSDK lança uma exceção de imediato se clientToken estiver ausente — não há um estado silencioso meio inicializado. Passe sempre um token válido antes de chamar qualquer método do SDK.

​
Fluxo de integração

1

O servidor cria a sessão do SDK

O seu servidor chama POST /sdk/session com a sua chave de API privada e recebe um clientToken de curta duração.
2

O navegador recebe o clientToken

Passe o token ao navegador — por exemplo, como JSON inline no seu template HTML ou como resposta JSON a uma requisição AJAX.
3

O SDK é inicializado

O navegador constrói new TheriusSDK({ clientToken }). O SDK já está pronto para renderizar campos e processar pagamentos.
4

O SDK renderiza os campos de cartão em iframes hospedados

Cada campo de cartão (número, validade, CVV) é renderizado dentro de um iframe hospedado pelo Therius. O seu JavaScript e o seu DOM nunca veem o PAN.
5

O usuário preenche o cartão — o SDK cria um nonce de uso único

Quando o comprador envia o formulário, chame sdk.createNonce(). O SDK devolve um nonce de curta duração que representa os dados de cartão.
6

O nonce é enviado ao seu servidor — o servidor cobra via API

A sua página faz um post do nonce para o seu backend. O seu servidor então chama POST /payment/purchase com o nonce para concluir a cobrança.

​
Próximos passos

Bootstrap de sessão

Aprenda como trocar a sua chave de API privada por um client token no seu servidor.

Campos hospedados

Construa um formulário de cartão totalmente personalizado mantendo os números de cartão brutos fora do seu DOM.

Widget de checkout

Insira um formulário de pagamento pronto com suporte a cartões salvos em duas linhas de código.

Botões de carteira

Adicione Apple Pay e Google Pay ao seu checkout com createWalletButton.