Fluxo Payin (BRL → Crypto)

Payin é a conversão BRL → Crypto. O receiver paga via PIX e recebe crypto na carteira Solana indicada.

Etapas

Cotação — preço e taxas fixados por 30s.
Criação da ordem — gera o QR Code PIX.
Pagamento PIX — receiver paga.
Conversão — swap on-chain.
Entrega — crypto chega na wallet destino.
Webhook — order.completed.

Cotação

curl -X POST https://api.astronpay.co/api/v1/quote/payin \
  -H "x-api-key: $API_KEY" -H "x-api-secret: $API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "receiverId": "rcv_...", "amountBrl": 1000, "targetToken": "USDC" }'

O campo targetToken aceita "USDC" ou "SOL". O padrão é "USDC". Response inclui quoteId, amountToken (quanto o receiver receberá), commercialRate, ratePlatform, expiresAt. Use o quoteId ao criar a ordem dentro de 30s.

Criação da ordem

curl -X POST https://api.astronpay.co/api/v1/payin \
  -H "x-api-key: $API_KEY" -H "x-api-secret: $API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "receiverId": "rcv_...",
    "quoteId": "qt_...",
    "destinationWallet": "4k5d...",
    "externalId": "meu-pedido-123"
  }'

A resposta traz:

pixPaymentCode — código EMV copia-e-cola do PIX. Exiba ao receiver para que ele efetue o pagamento.

Status ao longo do tempo

Status	Quando
`PENDING`	Ordem criada, aguardando PIX.
`AWAITING_PAYMENT`	QR Code gerado, aguardando pagamento.
`PAYMENT_RECEIVED`	PIX confirmado; processamento iniciado.
`SWAPPING`	Swap on-chain em execução.
`TRANSFERRING`	Crypto sendo enviado para a wallet destino.
`COMPLETED`	Crypto entregue à `destinationWallet`.
`FAILED`	Algo falhou; ver `failureReason`.
`EXPIRED`	Receiver não pagou dentro do prazo PIX.
`REFUNDING`	Estorno PIX em andamento.
`REFUNDED`	Valor estornado ao receiver.

Para o ciclo de vida completo, veja Ciclo de vida das ordens.

Webhooks recebidos

order.payment_received
order.completed
order.failed
order.refunding
order.refunded

Payloads completos em Eventos de webhook.

Consultando uma ordem

curl https://api.astronpay.co/api/v1/payin/$ORDER_ID \
  -H "x-api-key: $API_KEY" -H "x-api-secret: $API_SECRET"

Ou use o endpoint genérico /orders/{id}.

Erros comuns

Erro	Causa
`QUOTE_EXPIRED`	Mais de 30 s entre cotação e criação. Regere a cotação.
`LIMIT_EXCEEDED`	Receiver já atingiu limite diário.
`KYC_NOT_APPROVED`	Receiver não aprovado. Complete o onboarding.

Introdução

Conceitos

Guias

Webhooks recebidos

Fluxo Payin (BRL → Crypto)

Etapas

Cotação

Criação da ordem

Status ao longo do tempo

Webhooks recebidos

Consultando uma ordem

Erros comuns

​Etapas

​Cotação

​Criação da ordem

​Status ao longo do tempo

​Webhooks recebidos

​Consultando uma ordem

​Erros comuns

Etapas

Cotação

Criação da ordem

Status ao longo do tempo

Webhooks recebidos

Consultando uma ordem

Erros comuns