# Informações gerais

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

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](https://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](/docs/authentication) para aprender a assinar requisições
5. Faça sua primeira chamada de [Create Payment](/docs/payments)

## URL base

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

```
https://api.2328.io/api
```

> **WARNING:** 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.