Introdução à integração Paychain

Bem-vindo à documentação de integração do Paychain, gateway de pagamento com USDT e USDC na Solana (e redes adicionais conforme configuração).

Este site segue o estilo de guias passo a passo (como em soluções de checkout e adquirência): primeiro a visão geral da API, depois guias por fluxo e, por fim, a referência de endpoints.

O que você pode fazer

• Criar ordens de pagamento via API (POST /orders).
• Obter link e QR para o cliente pagar na carteira.
• Receber webhooks quando o status da ordem mudar.
• Consultar histórico, auditoria e entregas de webhook por ordem.

Base URL e ambiente

• API em produção (documentada aqui): https://paychain-api.onrender.com
• Nos cURLs, {{BASE_URL}} significa esse endereço (sem barra no final). O painel (Configurações → Integração) pode exibir a mesma URL.

Autenticação

• JWT: header Authorization: Bearer <token> obtido com POST /auth/login.
• Rotas públicas do fluxo de pagamento (/pay/...) não exigem token.

Próximos passos

1. cURL e variáveis ({{BASE_URL}}, {{TOKEN}})
2. Autenticação — conceitos
3. Cadastrar carteiras → depois criar cobrança (POST /orders)
4. Fluxo de pagamento na Solana e webhooks / auditoria
5. Referência completa com exemplos cURL — saúde, auth, perfil, carteiras, ordens, /pay público, dashboard

Ticker de preços no site público

O site de marketing pode exibir cotações de criptoativos (ex.: via Binance) apenas para exibição. A conversão BRL/EUR → USDT ou USDC na criação da ordem (conforme o campo token) usa o feed configurado no servidor; não confunda as duas fontes ao suportar clientes.

USDC na API

Cobranças em USDC usam o mesmo POST /orders que USDT: "network": "SOLANA", "token": "USDC", "amount": "…". Veja exemplos em destaque em API — Ordens.