# Astron Pay

## Docs

- [Lista fee tiers](https://docs.astronpay.co/api-reference/fee-tiers/get-fee-tiers.md): Retorna as taxas configuradas por faixa de volume para cada tipo de ordem (PAYIN e PAYOUT). Cada faixa inclui o percentual da plataforma (fixo) e o percentual do merchant (configurável). Use o query param `orderType` para filtrar.
- [Atualiza fee tiers](https://docs.astronpay.co/api-reference/fee-tiers/put-fee-tiers.md): Envia um array completo de faixas de volume para PAYIN ou PAYOUT. O `merchantFeePercentage` de cada faixa é atualizado; o `platformFeePercentage` da faixa correspondente é preservado. O array passado substitui todas as faixas existentes para aquele `orderType`.
- [Saldo de taxas](https://docs.astronpay.co/api-reference/ledger/fees-balance.md): Retorna o total de taxas merchant coletadas ainda não liquidadas.
- [Saldo do receiver](https://docs.astronpay.co/api-reference/ledger/receiver-balance.md)
- [Entries do receiver](https://docs.astronpay.co/api-reference/ledger/receiver-entries.md)
- [Liquidações](https://docs.astronpay.co/api-reference/ledger/settlements.md)
- [Assina transação (merchant)](https://docs.astronpay.co/api-reference/merchant-wallet/sign.md)
- [Assina e transmite (merchant)](https://docs.astronpay.co/api-reference/merchant-wallet/sign-and-send.md): Assina a transação com a wallet gerenciada do merchant e transmite à rede Solana. **O gas é patrocinado pela plataforma** — não mantenha SOL na wallet pra pagar fee, e não seta `feePayer` na transação (a plataforma substitui pela sua sponsor wallet). Não rode `simulateTransaction()` localmente: o RP…
- [Busca ordem](https://docs.astronpay.co/api-reference/orders/get.md)
- [Lista ordens](https://docs.astronpay.co/api-reference/orders/list.md)
- [Cotação rápida](https://docs.astronpay.co/api-reference/orders/quote.md): Alternativa de cotação via query params (útil para integrações client-side simples). Equivalente a `POST /quote/payin` ou `POST /quote/payout`.
- [Cria ordem de payin](https://docs.astronpay.co/api-reference/payin/create.md): Cria uma ordem de entrada (BRL → crypto). Requer `quoteId` de `/quote/payin` não expirado. Retorna o QR Code PIX e o copia-e-cola para o receiver pagar.
- [Busca ordem de payin](https://docs.astronpay.co/api-reference/payin/get.md)
- [Cria ordem de payout](https://docs.astronpay.co/api-reference/payout/create.md): Cria uma ordem de saída (crypto → BRL). Requer `quoteId` de `/quote/payout` não expirado. Após o receiver depositar o crypto no endereço fornecido (campo `depositAddress` na ordem), a plataforma executa a conversão e envia PIX para a chave configurada.
- [Busca ordem de payout](https://docs.astronpay.co/api-reference/payout/get.md)
- [Cotação payin](https://docs.astronpay.co/api-reference/quote/payin.md): Calcula quanto o receiver receberá em crypto ao pagar um valor em BRL. A cotação expira em ~30 segundos. Use o `quoteId` retornado ao criar a ordem de payin.
- [Cotação payout](https://docs.astronpay.co/api-reference/quote/payout.md): Calcula quanto o receiver receberá em BRL ao depositar um valor em crypto. A cotação expira em ~30 segundos. Use o `quoteId` retornado ao criar a ordem de payout.
- [Cria receiver](https://docs.astronpay.co/api-reference/receivers/create.md): Cria um receiver (usuário final do merchant). O receiver começa com `kycStatus: PENDING` e só pode transacionar após aprovação. Forneça `walletAddress` (endereço Solana existente) **ou** `createPrivyWallet: true` (a plataforma cria uma wallet gerenciada pra ele), nunca os dois.
- [Busca receiver](https://docs.astronpay.co/api-reference/receivers/get.md)
- [Submete KYC](https://docs.astronpay.co/api-reference/receivers/kyc-submit.md): Upload dos documentos para verificação de identidade. Sempre inclua `selfie`. Para PF com RG: `documentFront` + `documentBack`. Para PF com CNH: `documentPhoto` **ou** `documentDigital`. Para PJ (qualquer documentType): `cnpjCard` + `socialContract` + documentos pessoais do sócio. Tamanho máximo por…
- [Limites do receiver](https://docs.astronpay.co/api-reference/receivers/limits.md)
- [Lista receivers](https://docs.astronpay.co/api-reference/receivers/list.md)
- [Atualiza receiver](https://docs.astronpay.co/api-reference/receivers/update.md): Atualiza campos não-críticos do receiver. Pelo menos um campo deve ser fornecido. Documento e tipo são imutáveis.
- [Assina transação](https://docs.astronpay.co/api-reference/receivers/wallet-sign.md): Usa a wallet gerenciada do receiver para assinar uma transação Solana serializada. Retorna a transação assinada — o broadcast fica por sua conta. Use quando precisar construir e gerenciar a transmissão você mesmo (caso contrário, prefira `sign-and-send-transaction`, que assina, paga o gas e envia tu…
- [Assina e transmite](https://docs.astronpay.co/api-reference/receivers/wallet-sign-and-send.md): Assina a transação com a wallet gerenciada do receiver e transmite à rede Solana. **O gas é patrocinado pela plataforma** — não é necessário manter SOL na wallet pra pagar fee, e você não deve setar `feePayer` na transação (a plataforma substitui pela sua sponsor wallet ao enviar). Não rode `simulat…
- [Eventos disponíveis](https://docs.astronpay.co/api-reference/webhook-config/events.md): Retorna o catálogo estático de eventos que a plataforma emite, incluindo descrição e schema do payload de cada um.
- [Config de webhook](https://docs.astronpay.co/api-reference/webhook-config/get.md)
- [Atualiza config](https://docs.astronpay.co/api-reference/webhook-config/update.md): Atualiza `webhookUrl` e/ou `webhookSecret`. Passe `null` para remover um valor. Pelo menos um campo deve ser fornecido.
- [Autenticação](https://docs.astronpay.co/authentication.md): Autentique via API Key + API Secret nos headers x-api-key e x-api-secret.
- [Taxas](https://docs.astronpay.co/concepts/fees.md): Como funcionam as taxas de plataforma e do merchant.
- [Ledger e liquidações](https://docs.astronpay.co/concepts/ledger-settlements.md): Contabilidade de partidas dobradas e ciclos de liquidação.
- [Merchants e Receivers](https://docs.astronpay.co/concepts/merchants-receivers.md): Modelo de dois lados: como merchants integram e como receivers transacionam.
- [Ciclo de vida das ordens](https://docs.astronpay.co/concepts/orders-lifecycle.md): Estados e transições de ordens payin e payout.
- [Assinatura de transações](https://docs.astronpay.co/concepts/wallet-signing.md): Quando usar sign-transaction vs sign-and-send-transaction.
- [Erros](https://docs.astronpay.co/errors.md): Formato padrão de erro e catálogo de códigos.
- [Consultando saldos](https://docs.astronpay.co/guides/ledger-queries.md): Como consultar saldos, entries, taxas e liquidações.
- [Fluxo Payin (BRL → Crypto)](https://docs.astronpay.co/guides/payin-flow.md): Integração completa do fluxo payin.
- [Depósito de payout assinado pela Astron Pay](https://docs.astronpay.co/guides/payout-deposit-tx.md): Use POST /payout/build-transfer-tx + POST /merchant/wallet/sign-and-send-transaction para depositar USDC em payouts sem montar transações Solana no seu lado e sem ter SOL para gas.
- [Fluxo Payout (Crypto → BRL)](https://docs.astronpay.co/guides/payout-flow.md): Integração completa do fluxo payout.
- [Onboarding de receiver](https://docs.astronpay.co/guides/receiver-onboarding.md): Passo-a-passo para criar receivers e enviar KYC.
- [Configurando webhooks](https://docs.astronpay.co/guides/webhook-setup.md): Como configurar URL e secret de webhook.
- [Introdução](https://docs.astronpay.co/introduction.md): A Astron Pay é uma plataforma B2B de câmbio crypto ↔ BRL via PIX.
- [Quickstart](https://docs.astronpay.co/quickstart.md): Do zero ao primeiro payin em 10 minutos.
- [Eventos](https://docs.astronpay.co/webhooks/events.md): Catálogo de eventos de webhook e seus payloads.
- [Webhooks — visão geral](https://docs.astronpay.co/webhooks/overview.md): Eventos enviados pela Astron Pay ao seu backend.
- [Validação de assinatura](https://docs.astronpay.co/webhooks/validation.md): Como verificar a autenticidade de um webhook recebido.

## OpenAPI Specs

- [openapi](https://docs.astronpay.co/openapi.json)

## Optional

- [Status](https://status.astronpay.co)