> ## Documentation Index
> Fetch the complete documentation index at: https://docs.astronpay.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchants e Receivers

> Modelo de dois lados: como merchants integram e como receivers transacionam.

A Astron Pay é uma plataforma **B2B2C**. Há dois atores principais.

## Merchant

A empresa que integra a Astron Pay — nosso cliente direto. O merchant:

* Possui credenciais (`x-api-key` + `x-api-secret`).
* Cadastra seus receivers.
* Solicita cotações e cria ordens em nome deles.
* Recebe webhooks sobre o ciclo de vida das ordens.
* Acumula um saldo de taxas liquidadas periodicamente.

## Receiver

O usuário final do merchant (pessoa física ou jurídica). O receiver:

* Tem KYC próprio (aprovação obrigatória antes de transacionar).
* Possui limites diários (BRL + contagem de transações) e janela noturna configurável.
* Possui uma wallet Solana MPC gerenciada que pode ser usada para operações on-chain.
* Transaciona sempre dentro do contexto de um merchant.

## Responsabilidade

| Responsabilidade            | Merchant               | Receiver |
| --------------------------- | ---------------------- | -------- |
| Onboarding do receiver      | ✅                      | —        |
| KYC do receiver             | ✅ (submete documentos) | —        |
| Solicitação de cotação      | ✅                      | —        |
| Pagamento do PIX (payin)    | —                      | ✅        |
| Depósito de crypto (payout) | —                      | ✅        |
| Monitoramento via webhook   | ✅                      | —        |

## Hierarquia

```
Merchant
  ├── Receiver A
  │     ├── Ordem 1 (payin)
  │     └── Ordem 2 (payout)
  └── Receiver B
        └── Ordem 3 (payin)
```

Um receiver pertence a exatamente um merchant. A Astron Pay não expõe receivers entre merchants.