Como integrar com a Astron Pay

O fluxo em 4 passos

1. 1

   Crie sua conta e pegue as chaves

   Crie a conta, conclua o onboarding e gere seu par de credenciais (x-api-key e x-api-secret). Toda chamada à API usa esses dois headers. Comece pelo ambiente de testes, isolado da produção.

2. 2

   Solicite uma cotação

   Antes de cada ordem você pede uma cotação e recebe o valor exato da conversão, travado por 30 segundos. Assim o preço não muda no meio do caminho.

   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_01hxy...",
       "amountBrl": 1000,
       "targetToken": "USDC"
     }'
   
   # 200 OK — cotação travada por 30s
   {
     "quoteId": "qt_01hxy...",
     "amountBrl": 1000,
     "amountToken": "195.69",
     "targetToken": "USDC",
     "expiresAt": "2026-04-17T18:30:30Z"
   }

3. 3

   Crie a ordem de pagamento

   Com a cotação em mãos, crie a ordem de payin. A resposta traz o código PIX (copia e cola / QR) para o pagador. Cash-out (payout) segue o mesmo padrão para pagar qualquer chave.

   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_01hxy...",
       "quoteId": "qt_01hxy...",
       "destinationWallet": "4k5dSo1EnderecoSolana..."
     }'
   
   # 201 Created
   {
     "id": "ord_01hxy...",
     "type": "PAYIN",
     "status": "AWAITING_PAYMENT",
     "amountBrl": 1000,
     "targetToken": "USDC",
     "pixPaymentCode": "00020126..."
   }

4. 4

   Receba a confirmação por webhook

   A Astron chama a sua URL a cada mudança de status — pago, concluído, falho, estornado. É assim que a sua aplicação sabe em tempo real o resultado, sem ficar consultando a API.

   // A Astron Pay chama a sua URL a cada mudança de status.
   POST https://sua-api.com/webhooks/astronpay
   
   {
     "event": "order.completed",
     "data": {
       "id": "ord_01hxy...",
       "type": "PAYIN",
       "status": "COMPLETED",
       "amountBrl": 1000,
       "amountToken": "195.69",
       "targetToken": "USDC"
     }
   }