Para plataformas e wallets · PIX → cripto
Receba PIX e receba USDT na sua carteira
Seu cliente paga em reais pelo banco. Você acompanha o recebimento do PIX e a entrega de USDT na carteira informada, pela rede disponível. A Lunium oferece API e ferramentas para agentes; comece entendendo o fluxo e preparando sua integração.
Como começar com sua IA
Você pode usar Gemini, ChatGPT ou outra IA para entender este percurso e preparar sua integração.
Confira quanto vai receber
Informe o valor em reais, o documento do pagador e a carteira com a rede correta. Consulte a estimativa líquida, as taxas, o mínimo e eventuais retenções.
Gere e compartilhe o QR
A cobrança retorna o QR Code, o PIX copia e cola e o vencimento. O pagador usa seu aplicativo bancário.
Acompanhe até a entrega
Veja o PIX recebido e o envio da cripto. O link da transação e a confirmação na rede são apresentados quando disponíveis.
Um pedido para sua IA
Quero receber R$ 100 por PIX e receber USDT na minha carteira usando a Lunium. Confira moeda, rede, taxas e mínimo; explique como conectar minha conta e gerar o QR, e acompanhe as etapas quando as ferramentas estiverem disponíveis.
O valor em USDT é estimado até a conversão. O prazo depende da retenção aplicável, do processamento e da rede.
A execução real pelo chat exige um agente conectado à sua conta. O conector público da Lunium oferece demonstrações; a conexão de produção por OAuth no ChatGPT ainda não está disponível. Nunca cole sua chave de produção em uma conversa.
Como integrar PIX para stablecoin
Este fluxo atende produtos que precisam entregar cripto após cada pagamento: entrada de recursos em wallets, compra de ativos por usuários e recebimento comercial com liquidação em cripto. O pagador usa PIX no banco; seu backend escolhe a moeda, a rede e a carteira de destino.
Consulte a rota
Leia GET /cashin/catalog, selecione um par entregável e consulte POST /cashin/preview para estimar o recebido e o mínimo em reais.
Gere a cobrança
Envie POST /cashin/charge com destino: "cripto", valor em centavos, documento do pagador e endereço na rede selecionada.
Concilie a entrega
Apresente o QR e a validade retornados. Acompanhe o pagamento e, separadamente, a entrega de cripto por consulta de status ou webhook.
Se você quer receber em reais e decidir o saque depois, use PIX para custódia BRL. Nesse fluxo, a cobrança não exige carteira e a conversão acontece somente no saque.
Exemplo de cobrança PIX para USDT
Use uma chave lun_test_, guardada no backend, e confirme key.sandbox=true em GET /keys/me. Os exemplos abaixo usam documentos e destinos sintéticos. Não os envie com credenciais de produção.
POST /cashin/charge · corpo de exemplo para sandbox
{
"amount_cents": 10000,
"payer_tax_number": "12345678901",
"destino": "cripto",
"asset": "usdt",
"chain": "polygon",
"payout_address": "0x1111111111111111111111111111111111111111",
"external_id": "sandbox-pix-usdt-001"
}Envie para https://api.luniumpay.com/cashin/charge com X-API-Key: $LUNIUM_API_KEY e Content-Type: application/json. amount_cents: 10000 representa R$ 100,00. O valor é ilustrativo: a criação revalida limites e o mínimo efetivo.
Guarde o cashin_id retornado. Na sandbox, confirme por POST /sandbox/cashin/{cashin_id}/pay com corpo {} e consulte GET /cashin/{cashin_id}/status até status=paid e settlement_status=sent. O QR de teste contém SANDBOX:NAO_PAGAVEL: e não deve ser pago em banco.
Para USDC ou BTC, selecione um par disponível e altere asset, chain e o endereço juntos. O campo de rede é chain neste endpoint; ele recebe o network do catálogo de entrega.
Moeda, rede e mínimo vêm da API
| Consulta | O que usar no seu produto |
|---|---|
GET /cashin/catalog | Pares de instant e convert com entregavel=true; leia memoRequired, withdrawMin e withdrawFee. |
POST /cashin/preview | Estimativa de conversão e min_brl_cents. A prévia não cria cobrança nem fixa o câmbio até o pagamento. |
GET /cashin/limits?payer_tax=... | Limites orientativos do pagador, faixas de retenção e disponível. A criação revalida as condições. |
GET /cashin/{cashin_id}/status | Pagamento, entrega, retenção e hash, quando disponível. Leia os dois estados da operação. |
Não mantenha uma lista fixa de criptos, redes, mínimos ou prazos no checkout. Uma rota pode entrar em manutenção, exigir memo ou deixar de estar entregável. stale=true sinaliza catálogo em cache. O prazo depende da retenção aplicável, do provedor e da rede; a geração do QR não garante liquidação imediata.
PIX pago e cripto entregue são etapas diferentes
cashin.paid confirma o PIX recebido. cashin.settled e a combinação status=paid com settlement_status=sent indicam o envio registrado. Para entrega em blockchain, leia settlement_proof, a transação e settlement_confirmed_at: envio registrado e confirmação na rede são etapas separadas. Um resultado incerto exige conciliação: não marque o pedido como entregue nem inicie outra cobrança automaticamente.
Guarde external_id e o identificador retornado antes de atualizar seu pedido. Em retry, mantenha a mesma referência e o mesmo corpo. Configure um receptor HTTPS, valide a assinatura HMAC sobre o corpo bruto e deduplique por event_id. Depois de timeout, consulte a operação original antes de decidir repetir. O manual de webhooks e conciliação detalha a implementação.
Mostre ao cliente as retenções retornadas em held_hours, hold_hours e liberar_em, quando presentes. Se não aceitar a retenção da régua do pagador, use allow_hold:false; isso não remove outras restrições da chave.
Dúvidas de integração
É obrigatório cadastrar uma carteira fixa?
Não. No cash-in direto você pode informar payout_address por cobrança. Para receber sem definir endereço, escolha destino: "saldo" e faça o saque depois pela custódia.
USDT e USDC estão disponíveis em qualquer rede?
Use somente os pares entregáveis do catálogo atual. A existência de um ativo em uma rede não garante que essa rota esteja habilitada. Mínimos, custos e memo variam por rota.
A sandbox paga um PIX e envia pela corretora parceira?
Não. O PIX é não pagável e a entrega cripto é fictícia, com hash iniciado por sandbox:. Ela valida seu código e seus eventos. Uma operação com PIX e entrega reais acontece em produção.
Por que informar CPF ou CNPJ do pagador?
payer_tax_number identifica quem fará o pagamento e participa dos limites e verificações. Ele não é o identificador do pedido nem substitui customer_ref. Envie o documento correto em produção.