Auth

Para gerar um AccessToken, será necessário informar o Token e a Chave Secreta gerados no menu "API > Credenciais".
Você pode cadastrar até 50 Credenciais distintas para gerar novos AccessToken's.

❗️ A validade de cada AccessToken é de 12 meses, sem precisar ficar gerando um novo AccessToken a cada requisição. Para gerar um novo access token, basta fazer uma nova solicitação.

Antes de começar, os AccessToken's possuem escopos de permissão, e eles são separados por virgula.

Abaixo, você confere a lista de escopos permitidos.

Escopo	Descrição
invoice.write	Emite Faturas
invoice.read	Lista e Consulta as Faturas
invoice.refund	Realiza Reembolsos
invoice.update	Atualizar Faturas: Vencimento e Cancelar
disputes.read	Lista e Consulta as Mediações/Chargebacks
disputes.update	Atualiza as Mediações/Chargebacks
customer.read	Lista os Consumidores
baas.balance	Consulta o Saldo da Conta
baas.withdraw	Realiza Saques da Conta. Necessário Configuração do Certificado.
baas.statement	Consulta o Extrato da Conta
baas.details	Consulta os Detalhes da Conta

Abaixo, você confere o que cada parâmetro de retorno significa.

Para usar o Cartão de Crédito, lembre-se de salvar o valor do ACCOUNT, pois este será usado para tokenização dos cartões.

PARÂMETRO	DESCRIÇÃO	VALORES
account	ID da Conta/AccountID, será usado para a geração do Token do Cartão de Crédito
access_token	Token de Acesso para uso do fluxo transacional
token_type	Tipo do AccessToken gerado, Basic ou Bearer
scope	Scopos de permissões configuradas	invoice.write, customer.write
expires_in	validade do token em timestamp
companie	ID da Empresa na Tryplo
working	Ambiente de Uso.	PRODUCTION SANDBOX
details	Array com detalhes da conta
details > type	Tipo de Conta	1 - Pessoa Fisica 2 - Pessoa Juridica
details > document	CPF/CNPJ da Conta
details > name	Razão Social/Nome
details > owner	Array com os dados do Titular da Empresa
details > owner > document	CPF/CNPJ do Titular da Empresa
details > sac	Array com os dados de SAC da Empresa
details > sac > phone	Telefone/Celular de SAC
details > sac > email	Email de SAC

Envie suas requisições HTTP com um cabeçalho

Authorization

que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password

Exemplo:

Authorization: Basic *****************

{ "account": "a657c3ea-eed7-11ef-8ed9", "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXV....", "token_type": "Bearer", "scope": "invoice.write, customer.write, webhook.write", "expires_in": 1796846761, "working": "PRODUCTION", "companie": 1, "details": { "type": 1, "document": "0000000000", "name": "RAZAO", "social_name": "FANTASIA", "owner": [ { "name": "NOME DO SÓCIO", "document": "***000***00" } ], "sac": { "phone": "00000000", "email": "exemplo@gmail.com" }, "global": null, "softDesc": "TTPLY*TEST", "methods": { "pix": { "active": 1, "limits": { "amount": 25 } }, "card": { "threeds": false, "credit": { "active": 1, "limits": { "amount": null, "installment": 12 } }, "debit": { "active": false, "limits": { "amount": 0 } }, "prepaid": { "active": false, "limits": { "amount": 0 } } }, "billet": { "active": 1, "limits": { "amount": null } } }, "fees": { "warning": "These fees do not include the acquirer's fees and antecipations fees.", "percent": 0, "cents": 0, "billet": { "percent": 3.49, "cents": 1.8 }, "pix": { "percent": 3.49, "cents": 1.2 }, "card": { "percent": 4.99, "cents": 1.8, "installments": { "x1": 3, "x2": 4, "x3": 5, "x4": 6, "x5": 7.5, "x6": 8.5, "x7": 9.5, "x8": 10, "x9": 10, "x10": 10, "x11": 11, "x12": 12 } } } } }

Requisição

Respostas