Visão geral da documentação
O objetivo desta documentação é mostrar como integrar qualquer projeto com a Trybit e começar a aceitar pagamentos em criptomoeda.
Esta documentação destina-se ao especialista responsável por ligar a Trybit do lado do negócio: um programador, um especialista técnico ou um proprietário de projeto que configure a integração por conta própria. Descreve métodos da API, formatos de pedido e resposta, notificações de pagamento e ferramentas no-code prontas a usar. As definições do painel e os cenários de utilizador são abordados em detalhe na Base de Conhecimento.
O que é a Trybit
Trybit é um gateway de pagamentos cripto para negócios online que precisam de aceitação de pagamentos estável e pagamentos atempados sob qualquer carga. O serviço aceita pagamentos em criptomoedas e stablecoins populares — Bitcoin, Ethereum, Litecoin, USDT e outras — de clientes de todo o mundo, sem barreiras bancárias.
Cada transação recebida passa por uma verificação AML/KYT: os depósitos suspeitos são assinalados e bloqueados antes de serem creditados no saldo, o que reduz o risco de os fundos ficarem congelados quando levantados para uma exchange. Para projetos com um fluxo de pagamentos estável, estão disponíveis conversão automática para stablecoins, levantamentos via API, carteiras estáticas e aceitação de pagamentos white-label sem redirecionamento (H2H).
Que método de integração escolher
Método
Desenvolvedor necessário
Quando se adequa
Saiba mais
API
Sim
Necessita de controlo total sobre o fluxo de pagamento: criação de faturas, verificação de estados, levantamento de fundos do seu sistema
Host2Host (H2H)
Sim
O cliente paga no seu site, sem ser redirecionado para a página de pagamento da Trybit
Plugins CMS
Não / mínimo
O seu site corre num CMS popular: WooCommerce, OpenCart, Tilda, GetCourse e outros
Widget HTML
Não
Precisa de colocar um formulário ou botão de pagamento no seu site sem programação
Para um projeto "bot do Telegram", apenas a integração por API está disponível. As notificações de estado de pagamento via POSTBACK podem ser recebidas com qualquer método exceto "widget HTML (sem postback)". Está disponível uma comparação detalhada dos métodos na página Métodos de Integração na Base de Conhecimento.
Como começar a aceitar pagamentos
Registe-se. Criar uma conta no painel do Trybit. → Registo e Acesso à Conta
Adicione um projeto. Na secção "Adicionar projeto", selecione o tipo de projeto — "Site" ou "bot do Telegram", preencha os detalhes do projeto e confirme a propriedade do domínio ou bot. O tipo de projeto, o domínio e o link do bot não podem ser alterados após a criação. → Adicionar um projeto
Escolha um método de integração. O método é selecionado na etapa "Integração e API" do processo de adição do projeto. Determina o conjunto de campos e se é necessária uma verificação POSTBACK.
Obtenha as suas chaves. Na etapa "Chaves e pagamentos de teste", é atribuído ao projeto uma API KEY, SHOP ID e SECRET KEY. → Obtenção das chaves da API
Configure a integração e as notificações. Ligue o método selecionado, especifique o URL de notificação e o formato POSTBACK. → Como a integração funciona, POSTBACK automático
Teste a integração. Crie uma fatura da mesma forma que um cliente faria, confirme-a sem pagamento e certifique-se de que o POSTBACK é entregue ao seu servidor. → Testando a Integração
Submeta um pedido para sair do modo de teste. O pedido é submetido na etapa "Revisar e enviar". A análise demora até 24 horas; o estado do pedido é apresentado no painel, e o resultado é enviado por email. → Requisitos e restrições
Aceite pagamentos reais. Assim que o pedido é aprovado, as faturas são confirmadas apenas pelo pagamento real, e os fundos são creditados no saldo.
Capacidades da API
A API V2 cobre o ciclo completo de pagamento — desde a emissão de uma fatura até ao levantamento de fundos:
Criar fatura — emita uma fatura a um cliente e obtenha um link de pagamento ou dados de pagamento.
Cancelar fatura — cancele uma fatura criada.
Lista de faturas — obtenha todas as faturas de um projeto.
Informação da fatura — estado e detalhes das faturas por número INV.
Saldo — saldos da conta.
Estatísticas — estatísticas de pagamento.
Levantamentos — crie um pedido de levantamento.
POSTBACK automático — notificações de pagamento de faturas enviadas para o seu servidor.
Carteiras estáticas — um endereço permanente para pagamentos sem criar uma nova fatura.
Integração H2H — apresente os detalhes de pagamento na sua própria interface.
Informação básica da API
URL base: https://api.trybit.com/v2/
Os pedidos são enviados usando o método POST.
Autorização: a API KEY é enviada no cabeçalho Authorization de cada pedido; não é necessário um pedido de autorização separado.
Estão disponíveis exemplos de pedidos em cURL, Python, JavaScript e PHP na página Autorização de Pedidos. Um arquivo pronto a usar para trabalhar com a API está disponível na secção SDK para a API.
Conceitos principais
Termo
Significado
Projeto
Um ponto separado de aceitação de pagamentos — um site ou um bot do Telegram — com as suas próprias chaves, definições e estatísticas
CHAVE DA API
Chave para autorizar pedidos de API
SHOP ID
Identificador do projeto; passado ao criar uma fatura e no código do widget
CHAVE SECRETA
Chave para verificar a autenticidade das notificações POSTBACK
Fatura (INV)
Um pedido de pagamento com um número único no formato INV-XXXXXXXX
TXID
Hash da transação na blockchain
POSTBACK
Uma notificação que a Trybit envia para o URL de notificação depois de uma fatura ser paga
Modo de teste
Modo de teste da integração: as faturas são confirmadas sem pagamento e não afetam o saldo
Moedas suportadas
É apresentada a lista de criptomoedas e redes disponíveis para pagamento na página Moedas, Redes e Limites na Base de Conhecimento. A moeda do montante da fatura é passada no parâmetro currency — consulte a lista de códigos na página Criar Fatura.
Onde obter ajuda
Última atualização
Isto foi útil?
