Integre pelo ChatGPT e por agentes

Revisão: 06/10/2026. Entrada guiada: https://luniumpay.com/integrar . Contrato legível por máquina: https://docs.luniumpay.com/integration.json .

Cobre em PIX, receba em USDT

Peça à sua IA: “Quero cobrar R$ 100 por PIX e receber USDT na minha carteira. Mostre a estimativa líquida, gere o QR e acompanhe o pagamento.”

Informe o pagamento: valor em reais, documento de quem vai pagar e sua carteira com a rede correta. A IA consulta taxas, mínimo e estimativa líquida.
Apresente o QR: a cobrança retorna imagem, PIX copia e cola e vencimento. O pagador paga pelo aplicativo bancário.
Acompanhe o resultado: a IA informa PIX recebido e envio de USDT registrado, com link da transação quando disponível. Confirmação na rede é uma etapa separada.

Para cobranças reais, crie seu acesso por autoatendimento e conecte-o em um host compatível com https://api.luniumpay.com/mcp, usando a chave na configuração segura do host. Não cole chaves no chat. O conector público abaixo oferece demonstrações; a vinculação de conta de produção por OAuth ainda não está disponível.

Taxas, mínimos e retenções são informados antes da cobrança. A quantidade de USDT é estimada até a conversão. Cadastro e integração não dependem de conversa comercial. O contrato estruturado traz o roteiro completo em receive_pix_usdt_in_chat.

Pague PIX com cripto e receba o comprovante

Peça à sua IA: “Quero pagar R$ 100 nesta chave PIX usando minha cripto. Mostre a cotação e como enviar; depois acompanhe e entregue o comprovante.”

Informe o PIX: chave e valor em reais, ou o PIX copia e cola completo de uma cobrança.
Escolha moeda e rede: a IA consulta as opções disponíveis e mostra a quantidade de cripto, o valor em reais, os custos e o vencimento. Pagamentos por copia e cola aceitam atualmente USDT/USDC nas rotas compatíveis; pagamentos por chave têm outras opções do catálogo.
Confira e obtenha as instruções: após o aceite da cotação, receba endereço de depósito e memo/tag quando exigido.
Envie a cripto: use a quantidade e a rede indicadas, incluindo o memo/tag, dentro do prazo retornado. O acompanhamento mostra depósito, confirmações, conversão quando necessária e pagamento do PIX.
Receba o comprovante: quando o PIX estiver pago, a IA mostra o E2E e os links de comprovante, PDF e verificação disponíveis. Se o documento ainda estiver sendo preparado, ela continua acompanhando o mesmo pagamento.

O prazo depende da rede e do processamento do PIX. Antes de enviar, confira os custos da cotação; no copia e cola, o valor adicional de processamento já está incluído no total informado. Use sempre o código original da cobrança: não substitua um PIX copia e cola por transferência à chave extraída dele.

Em atraso, conferência ou devolução, acompanhe a ordem original. Não envie novamente por causa de timeout ou ausência momentânea do comprovante. O acesso real usa o mesmo MCP completo e a configuração segura descritos acima; a conexão pública abaixo é de demonstração.

Conhecer e testar dentro do ChatGPT

Uma conta/workspace elegível pode habilitar o modo de desenvolvedor e adicionar um app/plugin MCP remoto. A disponibilidade e os nomes dos menus dependem da conta e da política do workspace. Siga as instruções oficiais: https://developers.openai.com/plugins/deploy/connect-chatgpt .

Nas configurações do ChatGPT, habilite Developer Mode, quando disponível.
Crie a conexão Lunium — integração, com URL https://api.luniumpay.com/mcp/onboarding. Escolha sem autenticação para esta conexão pública.
Revise as ferramentas e adicione a conexão à conversa. Peça: “Planeje uma integração Lunium para receber PIX em custódia usando Node.js. Execute uma demonstração de sandbox e prepare o código para meu projeto.”
O agente consulta lunium_plan_integration, inicia lunium_start_sandbox_demo com um UUID, o seu email (opcional nas ferramentas MCP, mas fortemente recomendado: com ele a LuniumPay manda à pessoa o guia de integração (o que é a LuniumPay, manual, fluxograma, próximos passos) uma única vez; sem ele, crie a chave mesmo assim e colete o e-mail depois com lunium_contact) e flow igual a custody, cashin, payout ou cashout, e acompanha lunium_get_sandbox_demo. A simulação termina em COMPLETED; nenhum dinheiro se move.
Continue com o kit de código e a lista de prontidão. Se quiser acompanhamento humano, forneça o e-mail e autorize lunium_contact. Esse contato é opcional.

A conexão pública faz planejamento, consulta de catálogo, testes sintéticos e contato consentido. Ela não vincula contas de produção. OAuth de conta Lunium para ChatGPT ainda não está implementado; as exigências estão em https://developers.openai.com/plugins/build/auth . O MCP completo em /mcp também tem ferramentas de conta, para hosts que configurem X-API-Key de forma segura. Não cole chaves de produção no chat.

A existência de um endpoint MCP não significa publicação automática no diretório de apps do ChatGPT. Se a opção de conexão não aparecer na sua conta, use o briefing e o kit abaixo.

Começar com qualquer IA de programação

Abra https://luniumpay.com/integrar , escolha o fluxo e a linguagem e copie o briefing. Inclua o projeto em que deseja trabalhar. O briefing aponta para o contrato vigente e pede implementação, testes e explicação do que ainda precisa ser validado.

Baixe https://docs.luniumpay.com/starter/lunium-starter.zip . Execute node sandbox.mjs all (Node 20+) ou python3 sandbox.py all (Python 3.9+). Não há bibliotecas extras. Os scripts criam uma chave de teste em memória (com o e-mail de quem vai testar, em LUNIUM_SANDBOX_EMAIL), simulam o fluxo escolhido (ou todos com all), consultam o estado e recusam chaves de produção. Você pode reutilizar sua chave lun_test_ por variável de ambiente LUNIUM_API_KEY.

O arquivo AGENTS.md do kit orienta a IA no repositório. Não substitui as instruções do seu projeto. Código de teste: https://docs.luniumpay.com/starter/sandbox.mjs e https://docs.luniumpay.com/starter/sandbox.py .

Qual fluxo implementar

Receber PIX na custódia: POST /cashin/charge com destino: "saldo". Crédito em BRL; não exige carteira fixa. O payer_tax_number é o documento do pagador real. customer_ref escolhe a subconta.
Sacar cripto da custódia: consulte disponível em /saldo, rotas em /cashin/catalog e escolha moeda, chain, endereço e memo quando exigido. Envie POST /saldo/sacar-cripto. Não prometa toda moeda listada: confira entregavel e limites.
PIX com entrega direta em cripto: use destino: "cripto", catálogo de entrega e POST /cashin/preview antes de criar a cobrança.
Cripto para PIX: use /catalog, POST /cash-outs, aceite e acompanhamento. Esse fluxo também está disponível no sandbox.
Payout PIX: confirme capacidades em /keys/me, saldo disponível e taxas em /saldo; crie em POST /payouts e acompanhe o ID retornado.

Em cash-in e saque cripto o campo da rede é chain; em cash-out é network. Em cash-in e payout, valores em reais usam centavos inteiros. No cash-out, brl_amount é uma string decimal em reais, como "100.00"; quantidades de cripto também usam strings decimais. Consulte o schema de cada rota em https://docs.luniumpay.com/openapi.json .

O que o teste comprova

O sandbox cobre PIX de entrada, crédito de custódia, saque e entrega cripto, payout PIX, transferência interna e cash-out. O QR não é bancário: o pagamento é confirmado em POST /sandbox/cashin/{cashin_id}/pay. Tudo é fictício, sem chamada a banco, corretora ou blockchain. Consulte https://docs.luniumpay.com/sandbox para cenários de falha, retenção, saldo insuficiente, resultado incerto, webhooks assinados e diferenças de produção.

A demonstração pública usa dados sintéticos fixos. Não recebe carteira, PIX, valor ou chave de produção. O identificador do teste expira após duas horas; o estado financeiro fictício persiste após reinício; cash-out tem retenção de duas horas. Reutilize request_id em retries e o demo_id para acompanhamento. Um teste concluído não certifica sua integração inteira.

Antes de operar dinheiro real

Leia https://docs.luniumpay.com/manual . Verifique permissões e limites da chave, mínimos e taxas por rota, documentos e destinatários reais, saldo disponível e retenções. Implemente external_id persistente por intenção, retries sem alterar o pedido, verificação HMAC do corpo bruto do webhook, timestamp e deduplicação de eventos. Após timeout, consulte a operação original.

Cash-in só conclui com status=paid e settlement_status=sent; cash-out com state=COMPLETED; payout com status=sent. Não trate delayed como falha. Armazene chaves e segredos somente no backend. Autorize conscientemente a primeira operação real do fluxo escolhido.