1. Faturas
TryploPay
  • Começe por Aqui
  • Suporte
  • ChangeLog
  • Status
  • Autenticação
    • Auth
      GET
    • Status Credencial
      GET
  • Consumidores
    • Lista Consumidores
      GET
  • Faturas
    • Cartão de Crédito
    • [V1] Cartão de Crédito
    • Lista Faturas
      GET
    • Criar Fatura
      POST
    • Atualizar Vencimento
      PATCH
    • Cancelar Fatura
      DELETE
    • Estornar Fatura
      PUT
    • Adicionar Tracking Code
      POST
  • Contestações
    • Listar Mediações
      GET
    • Listar Chargebacks
      GET
  • Webhooks
    • Exemplos de Webhooks
    • Validar Webhook Recebido
      OPTIONS
    • Reenviar Webhook
      COPY
  • BAAS
  1. Faturas

Cartão de Crédito

Agora, vamos detalhar como você pode implementar nosso script no seu site para poder transacionar com cartão de crédito também.
Antes de seguirmos, tenha em mãos, o valor do parametro account retornado na geração do AccessToken, pois é ele que vai ser usado para obter os detalhes da configuração da sua conta para podermos realizar a tokenização do cartão de crédito.
No script abaixo, você vai substituir o valor de {{ACCOUNT}} para o valor obtido. É importante que o script seja carregado junto com a página de checkout, caso contrário, poderá apresentar erros e falhas no funcionamento. Ele pode ser implementado antes do fechamento da tag <head>.
Caso você já use nosso SKD na V1, não há problema em migrar, temos total compatibilidade na v2 também. No entanto recomendamos observar o funcionamento para que possa estudar a melhor forma dentro do seu checkout.
A Versão 2 do nosso SDK, foi pensada para melhorar o funcionamento, bem como, trazer mais transparência para os desenvolvedores, trazendo melhorias técnicas para o seu próprio ambiente técnico.
Se você já integrou a V1, você sabe que fazemos a maior parte do trabalho de integração para você, e continuamos dessa maneira, pois acreditamos que nesse fluxo, todas as atualizações que fizermos, não irá impactar na sua integração, pois ainda manteremos o suporte nativamente.
Entretanto, é importante se atentar as condições minimas para que isso aconteça, como consultar regularmente nosso changelog e este helper para verificar se há necessidade de algum ajuste técnico do seu lado, pois as vezes, é necessário.
Sem mais enrolação, vamos aos detalhes técnicos.
A versão 2 do nosso SDK, trás melhorias de controle e transparência onde você consegue definir os atributos que serão usados, sem precisar ficar adicionando novos atributos em seus inputs ou criar manipulações. Você também pode buscar a tokenização do cartão no método também, além de ativar e desativar o debug do nosso script, trazendo mais transparência no seu desenvolvimento.
Nosso script, ainda precisa de algumas classes no seu front-end para funcionar perfeitamente. Inclua as classes btn-buy tryplopay_btn_buy no botão de finalização de compra.
Implementamos também, um novo atributo que precisa ser inserido no seu botão de finalização de compra text_btn, esse atributo, você consegue determinar o conteúdo que irá retornar no botão após a tokenização/erro. Recomendamos usar o mesmo que já vem por padrão no botão.
Abaixo, vamos detalhar os cenários e métodos para utiliza-los.
Para ativar/desativar o Debug, basta informar o valor true no método abaixo:
Por padrão, este método é false.
Para desabilitar a inserção automática do nosso input de hash no seu checkout, basta informar false no método abaixo:
Por padrão, este método é true.
Para obter o Token/Hash gerado, basta fazer a chamada do método abaixo no seu script como desejado:
Para facilitar os retornos de erros, nosso script retorna a mensagem via TOAST, porém, você pode desativar usando o método abaixo:
Por padrão, este método é true.
Nos erros, você ainda pode obter com o seguinte método:
Um exemplo de retorno dos erros você confere abaixo:
{
    ok: false,
    stage: "tokenization",
    type: "gateway_error",
    code: "3500072",
    reason: "request_not_allowed",
    message: "Não foi possível finalizar sua solicitação. Por favor, entre em contato com o suporte.",
    timestamp: "2026-06-01T19:33:29.159Z"
}
Nesta versão, você também pode personalizar os input's que precisamos para obter os detalhes para tokenização. Visando uma integração sem erros, recomendamos a integração completa como no init abaixo, pois assim, você garante pleno suporte para Antifraude ou 3DS caso a funcionalidade seja ativada na sua conta.
Observação: o parametro methods tem suporte para input e select, no entanto, os valores aceitaveis são: credit_card ou debit_card
Em uma configuração completa, você pode usar assim:
Com o init acima, você vai poder usar os métodos com segurança e maior poder de controle.
Abaixo, você confere um exemplo de implementação do nosso SDK.
Página anterior
Faturas
Próxima página
[V1] Cartão de Crédito
Built with