Bem vindo a Documentação da API da TryploPay.
Estamos na Versão 4.0.2 e estamos em constante evolução.
PERIGO
Prezados,
Estamos atualizando nossos fluxos para uma versão mais robusta e eficiente, priorizando a redução do time response no processamento e tratamento das requisições. Durante este processo, alguns endpoints poderão apresentar versões superiores e respostas ainda não documentadas. Conforme forem validados em produção os exemplos de respostas serão atualizadas conforme necessário.
Entendemos que isso pode gerar desafios. Por esse motivo, solicitamos que concentrem a validação de sucesso e erro principalmente nos HTTP Codes, pois estes permanecerão inalterados.
CUIDADO
Não é permitido utilizar o mesmo CPF ou CNPJ em cobranças repetidas. Essa prática caracteriza uso indevido da conta e poderá resultar em bloqueio ou até no cancelamento imediato, com retenção dos fundos por até 180 dias, conforme nossos termos e políticas de uso.
Atualmente, aceitamos 6 tipos de métodos HTTP.
Os métodos HTTP aceitáveis para consumo são: GET, POST, PUT, PATCH e DELETE.
O método HTTP OPTIONS, é aceito apenas para validar eventos disparados para o seu servidor a fins de validação caso necessário.
| URL BASE |
|---|
| https://api.tryplopay.com |
Os Endpoints são:
| ENDPOINT | MÉTODOS HTTP ACEITOS | STATUS | VERSÃO API |
|---|---|---|---|
| /AUTH | GET | ATIVO | >= 4.0.0 |
| /STATUS | GET | ATIVO | >= 4.0.0 |
| /CUSTOMER | GET | ATIVO | <= 3.0.5 |
| /INVOICES | GET, POST, PUT, PATCH, DELETE | ATIVO | >= 4.0.0 |
| /INVOICES/QRCODE | GET | ATIVO | >= 4.0.0 |
| /INVOICES/TRACKING | POST | ATIVO | <= 3.0.5 |
| /INVOICES/MEDIATIONS | GET | ATIVO | >= 4.0.0 |
| /INVOICES/CHARGEBACKS | GET | ATIVO | >= 4.0.0 |
| /WEBHOOKS | OPTIONS | ATIVO | >= 4.0.0 |
| /BAAS/BALANCE | GET | ATIVO | >= 4.0.0 |
| /BAAS/DETAILS | GET | ATIVO | >= 4.0.0 |
| /BAAS/PIX-OUT | POST | ATIVO | >= 4.0.0 |
| /BAAS/STATEMENT | GET | ATIVO | >= 4.0.0 |
Caso precise de suporte, por favor, entre em contato com a nossa equipe pelo Chat ou WhatsApp (41) 3798-6803.
Abaixo, você confere todas as recentes atualizações da api.
| VERSÃO | DATA | DESCRIÇÃO | IMPACTO NA INTEGRAÇÃO REQUER ATENÇÃO NO CÓDIGO | DATA DO EFEITO |
|---|---|---|---|---|
| 4.0.2 | 12/12/2025 | Implementação de Regra de Escopo e Alteração do Formato do AccessToken para JWT. | TOTAL | APÓS 10/01/2026 |
| 4.0.1 | 31/10/2025 | Lançamento dos Endpoints: Extrato, Detalhes da Conta e Saldo. | NÃO | IMEDIATO. |
| 4.0.0 | 25/10/2025 | Lançamento da API BaaS | NÃO | IMEDIATO. |
| ATENÇÃO | COM AS MUDANÇAS E | MELHORIAS NO FLUXO DE API | A PARTIR DO DIA 25/10/25, A API | VIRA PARA A VERSÃO 4.0.0 |
| 3.0.5 | 21/10/2025 | Inclusão de novos data para Cartão de Crédito | APENAS SE USAR O MÉTODO. | IMEDIATO. |
| 3.0.5 | 15/10/2025 | Inclusão do endpoint de Mediações, Chargebacks e Saldo da Conta. | NÃO | IMEDIATO. |
| 3.0.4 | 29/09/2025 | Inclusão do endpoint Tracking Code. | SIM, APENAS SE USAR O RECURSO VIA API | IMEDIATO. |
| 3.0.3 | 16/09/2025 | Alterações no fluxo de reembolso. Consulte a seção de reembolso para conferir as mudanças. | SIM, APENAS SE USAR O RECURSO VIA API | IMEDIATO. |
| 3.0.2 | 06/05/2025 | Alterado o Fluxo de Geração do Token do Cartão de Crédito. Inclusão do array "invoice" no response de criação de fatura. Atendendo um prazo minimo necessário para readaptação, o array "fatura" será desativado em 01/09/2025. | SIM. | IMEDIATO. |
| 3.0.1 | 02/04/2025 | Adicionado Endpoint "/invoices/qrcode/" para obtenção do QRCODE PIX da fatura. | NÃO. | IMEDIATO. |
| 3.0.0 | 22/01/2025 | Na busca continua em melhorias, o endpoint INVOICES foi reformulado, trazendo mais velocidade no processamento da transação. DEPRECIAÇÃO** /customers (POST).** Usar apenas GET ** Limite de Uso: até 10/02/25** | SIM | 11/02 em diante. |
| 2.1 | 14/10/2024 | Melhoramos a otimização dos nossos serviços, e abrimos possibilidade de novos recursos. | NÃO. | IMEDIATO. |
| 2.0 | 07/10/2024 | Inclusão de novos parâmetros no body da requisição das faturas. Consulte a Seção "CRIAR FATURA". | NÃO. | IMEDIATO. |
| 1.9 | 05/10/2024 | Inclusão de novos parâmetros no retorno das credenciais. Consulte a Seção "Auth". ------------ Atualização na obrigatoriedade de envio de parâmetros. Consulte as Seções "CADASTRAR CONSUMIDOR" e "CRIAR FATURA". | NÃO | IMEDIATO. |
| 1.8 | 16/07/2024 | Inclusão de novos parâmetros no retorno das credenciais. Consulte a Seção "Auth". ------------ Inclusão de novo array na emissão de fatura. Consulte a Seção "Criar Fatura". | NÃO | IMEDIATO. |
| 1.7 | 02/06/2024 | Inclusão de novos parâmetros no array "address". Consulte a Seção "Criar Fatura". | NÃO | IMEDIATO. |
| 1.6 | 14/05/2024 | Novo Endpoint. Possibilita a Reemissão de uma Fatura já emitida. | NÃO | IMEDIATO. |
| 1.5 | 12/04/2024 | Inclusão de novos parâmetros no array "payment". Consulte a Seção "Criar Fatura". Inclusão de Novo Endpoint. Inclusão de novos parâmetros no array "payment". Consulte a Seção "Status Credencial" | SIM | IMEDIATO. |
| 1.4 | 04/04/2024 | Inclusão de novos parâmetros no array "payment". Consulte a Seção "Criar Fatura" | SIM | IMEDIATO. OBRIGATÓRIO APÓS 25/04/2024. |
| 1.3 | 03/04/2024 | Inclusão de novos parâmetros no array "products". Consulte a Seção "Criar Fatura" | NÃO | IMEDIATO |
| 1.2 | 15/03/2024 | Inclusão de novos parâmetros no array "products". Consulte a Seção "Criar Fatura" | NÃO | IMEDIATO |
| 1.1 | 28/12/2023 | Inclusão de novos parâmetros no array "cartao". Consulte a Seção "Criar Fatura" | SIM | IMEDIATO. OBRIGATÓRIO APÓS 15/01/2023. |
| 1.0 | 01/12/2023 | LANÇAMENTO DA API | IMEDIATO |