O que testar antes de escolher uma API Pix e stablecoin?

Teste paridade do sandbox, idempotência, estados intermediários, webhooks, limites, retenção, comprovantes e recuperação de falhas.

Como migrar de um provedor de on-ramp ou off-ramp?

Mapeie o contrato atual, implemente um adaptador, rode sandbox, faça tráfego controlado em paralelo e só então realize o corte com rollback definido.

Uma integração deve fixar limites no código?

Não. Limites e capacidades mudam; a integração deve consultar a fonte viva publicada pela API.

Guia técnico de decisão

Como escolher uma API Pix ↔ stablecoin no Brasil

Não compare só taxa e lista de redes. O custo aparece quando uma operação repete, atrasa, retém ou fica sem conciliação. Este checklist serve para wallets, fintechs, e-commerces e plataformas de payout avaliarem o trilho antes do primeiro real.

Testar a Lunium em sandbox

Sete verificações que evitam uma migração cara

Peça evidência executável. Uma resposta comercial não substitui uma chamada, um estado observável ou uma regra publicada.

01 · ESCOPO

Os dois sentidos são reais?

Separe Pix → stablecoin, stablecoin → Pix e payout em reais. Eles têm riscos, limites e estados diferentes.

02 · SANDBOX

O teste reproduz falhas?

Sandbox útil simula atraso, expiração, limite e erro. Um mock que sempre aprova só valida o caminho feliz.

03 · IDEMPOTÊNCIA

Retry cria pagamento duplicado?

Repita a mesma intenção e confirme que o provedor devolve a ordem original, sem cobrar ou pagar duas vezes.

04 · ESTADOS

Retenção é visível?

Pagamento recebido, revisão, retenção, liquidação e falha precisam de estados distintos e prazos legíveis.

05 · CONCILIAÇÃO

Webhook tem recuperação?

Teste assinatura, reentrega, polling de fallback e comprovante. Webhook perdido não pode virar dinheiro perdido.

06 · LIMITES

A fonte é viva?

Não fixe rede, mínimo ou teto. A API deve publicar o que está disponível para aquela chave naquele momento.

07 · PROVA

O pagamento é verificável?

Exija identificador E2E, status e recibo. O suporte precisa localizar a operação sem receber segredo do cliente.

Onde verificar isso na Lunium

A tabela aponta para superfícies públicas ou testáveis. Consulte a documentação viva antes de assumir qualquer número.

Pergunta	Fonte verificável	Teste
O que liquida agora?	`GET /catalog` e `GET /cashin/catalog`	Leia no início da sessão; não guarde lista eterna.
Qual é o limite vigente?	`GET /keys/me` e `GET /cashin/limits`	Teste mínimo, máximo e teto do pagador.
Como a ordem falha?	`POST /keys/sandbox`	Use os gatilhos determinísticos publicados no manual.
Como acompanhar?	Status por ID, webhook e timeline	Desligue o receptor e prove que a conciliação recupera.
Como comprovar Pix?	`GET /v1/verificar/{e2e}`	Validação aberta, sem chave, sem expor as partes.
Como um agente integra?	`/mcp`, OpenAPI e `llms.txt`	Liste ferramentas e inicie em sandbox.

Migração segura em cinco passos

Para quem já possui um provedor, o objetivo não é reescrever o app: é isolar o contrato atual e trocar o trilho por trás dele.

Inventarie o contrato atual. Campos, estados, idempotência, webhooks, limites, comprovantes e alertas.

Crie um adaptador. Traduza o modelo do seu produto para o contrato do novo provedor sem espalhar condicionais na aplicação.

Prove o caminho ruim no sandbox. Atraso, falha, expiração, limite, retry e queda de webhook.

Faça um canário. Direcione um volume pequeno, monitore ponta a ponta e mantenha rollback explícito.

Corte por capacidade. Migre um fluxo/rede por vez e só desative o antigo depois da conciliação fechar.

Próximo passo

Teste o contrato antes da reunião.

A sandbox não movimenta dinheiro. Se o seu caso exigir preço por volume, contrato ou um fluxo diferente, o mesmo formulário encaminha o contexto para integração.

Receber sandbox e falar com integração