Receber Pix na custódia
Saldo em reais, subcontas e saques em Pix ou cripto. Sem carteira fixa.
LuniumPay / Guias de integração
Pix e cripto no seu produto.
Comece pelo fluxo.
Guias para equipes que integram pagamentos em wallets, plataformas, marketplaces e sistemas de gestão. Escolha como o dinheiro entra, onde fica o saldo e como o destinatário recebe.
O que o seu produto precisa fazer?
Receber Pix e entregar cripto
Cobrança, USDT ou USDC, rede de entrega e confirmação por webhook.
Receber cripto e pagar Pix
Prévia, aceite, depósito na rede correta e conciliação do pagamento.
Pagar Pix usando o saldo
Payouts, débito, taxas, consulta de status e recuperação após falha.
Custódia ou entrega direta?
Na custódia, o Pix é creditado em saldo BRL. A aplicação pode separar o saldo por cliente e solicitar saques depois. Na entrega direta, a cobrança já define a cripto, a rede e o endereço do destinatário. Essa escolha muda os campos da chamada e o evento que sua aplicação deve esperar.
Não confunda recebimento do Pix com entrega final de cripto: confirme o estado de liquidação antes de marcar a entrega como concluída.
Da escolha ao primeiro teste
Abra a demonstração do fluxo
Em Integrar, escolha custódia, Pix para cripto, cripto para Pix ou payout. A demonstração usa saldo fictício e não exige cadastro obrigatório.
Leve o contrato para seu projeto
Baixe o kit Node/Python ou siga o guia de integração com IA. O briefing da página inclui o fluxo escolhido e links para a especificação atual.
Teste também quando algo falha
Valide idempotência, expiração, saldo insuficiente, retenção e reenvio de webhook usando os cenários da sandbox.
Antes de movimentar dinheiro real
A sandbox valida o contrato e a lógica da integração. Um piloto de produção valida a liquidação real, com credencial, valores e destinatários autorizados.
Webhooks e idempotência
Trate reenvios, valide assinaturas e recupere o estado após um timeout.
Como avaliar uma API de pagamentos
Compare contrato, limites, retenção, conciliação e tratamento de falhas.
Migrar uma integração existente
Planeje o adaptador, valide por capacidade e preserve a conciliação durante a troca.
O que a sandbox permite testar
Entenda saldo fictício, confirmação de Pix, simulação de entrega e estados de erro.
Qual documento usar em cada etapa?
| Etapa | Fonte | O que verificar |
|---|---|---|
| Planejar | Manual da API | Campos, autenticação, estados e exemplos. |
| Implementar com IA | Guia para agentes | Instruções, contrato e critérios de conclusão. |
| Validar | Sandbox | Fluxos e falhas com saldo fictício. |
| Operar | Status e manual | Disponibilidade, catálogo e conciliação. |
Teste o fluxo que você pretende integrar.
Escolha o percurso e copie o briefing para o seu editor ou agente de IA. O contexto segue com você até a implementação.
Conteúdo técnico da equipe LuniumPay · Revisado em . Taxas, limites e rotas de produção devem ser consultados na API.