Sign in
Introdução/Informações gerais

Informações gerais

Especificação técnica para integração de processamento de pagamentos e saques em criptomoedas com a 2328.io.

Ver como Markdown·llms.txt

Bem-vindo à documentação da API da 2328.io. Esta referência descreve como integrar o processamento de pagamentos e saques em criptomoedas em sua aplicação.

Primeiros passos

Para começar a integração:

  1. Crie uma conta de comerciante e um projeto em 2328.io
  2. Obtenha o UUID do projeto e a API key nas configurações do projeto
  3. Gere uma Payout API key separada caso pretenda usar saques
  4. Leia a seção Authentication para aprender a assinar requisições
  5. Faça sua primeira chamada de Create Payment

URL base

Todas as requisições de API em produção utilizam a seguinte URL base:

Text
https://api.2328.io/api

Todas as requisições devem ser feitas via HTTPS. Requisições sem HTTPS são bloqueadas.

O que você pode fazer

Com a API da 2328.io você pode:

  • Aceitar pagamentos em cripto — criar sessões de pagamento e redirecionar clientes para um checkout hospedado ou Telegram MiniApp
  • Sacar fundos — enviar saques programaticamente do saldo do comerciante para qualquer endereço blockchain
  • Consultar saldos — veja os saldos das contas do comerciante por moeda, equivalentes em USD e valores bloqueados por AML
  • Usar carteiras estáticas — gerar endereços de depósito permanentes vinculados a um usuário ou pedido
  • Consultar taxas de câmbio — obter taxas em tempo real para pares de moedas fiduciárias e criptomoedas
  • Receber webhooks — ser notificado instantaneamente quando o status de um pagamento muda

Limites de taxa

A API permite até 10 requisições por segundo por projeto. Requisições acima do limite recebem uma resposta HTTP 429 Too Many Requests — aguarde e tente novamente.