Pular para o conteúdo
Auryon369Auryon369Auryon369 · Docs

Migrar da plataforma anterior

Em 5 minutos: o caminho mínimo

Seção intitulada “Em 5 minutos: o caminho mínimo”

Se a sua integração usa PIX, boleto, consultas e webhooks, a migração é:

  1. Gere credenciais novas no painel da Auryon: Integrações → API → Gerar credencial. Marque as mesmas permissões que a credencial antiga tinha.
  2. Troque a URL base: https://app.auryon369.com/api/v1 → https://api.auryon369.com.br/api/v1
  3. Troque as chaves x-public-key e x-secret-key.
  4. Confira a lista abaixo. Se nenhum item se aplicar ao seu caso, terminou.

Rotas, campos, formato das respostas, códigos de erro e webhooks do callbackUrl continuam os mesmos.

O que muda: confira antes de ligar

Seção intitulada “O que muda: confira antes de ligar”
# Se você usa… O que muda O que fazer
1 /gateway/card/receive ou /gateway/card/subscription ⛔ Não existe mais. Responde sempre 400 GATEWAY_FAILED_PRECONDITION. A Auryon não recebe dados de cartão pela API. Use POST /gateway/checkout e redirecione o comprador ao checkoutUrl. Ver “Cartão” abaixo.
2 /gateway/producer/balance com vendas em dólar ou BDM ⚠️ Mostra só o saldo em Reais. Nada falha, mas o número fica menor do que o seu saldo total. Para todas as moedas, use GET /v1/balance ou o painel.
3 splits[] ⚠️ producerId passa a ser o ID da conta Auryon. Os IDs antigos não valem. E a soma dos splits não pode passar do valor líquido (antes era o valor total). Peça o ID novo a cada parceiro (painel → Integrações → API) e revise splits que dividem 100% da venda.
4 /gateway/checkout ⚠️ offer.price é em reais. O produto segue a regra de aprovação da sua conta (a mesma do painel): produto ainda não aprovado responde 409 GATEWAY_FAILED_PRECONDITION, sem link. Os dados de customer não vão para a URL. Confirme que você manda reais (497.00), não centavos (49700). Se a sua conta não aprova produtos automaticamente, crie-os com antecedência e trate o 409.
5 Webhooks que leem CPF, CNPJ, telefone ou endereço do comprador ⚠️ Esses campos vêm null. Se precisa desses dados (nota fiscal, entrega), use o painel ou fale com o suporte.
6 /gateway/crypto/receive com moeda diferente de BDM ⚠️ Só "currency": "BDM". Use BDM Digital.
7 /gateway/pix/subscription ou /gateway/crypto/subscription ✅ Funcionam. ⚠️ periodicityType: DAYS e firstChargeIn > 0 não são suportados. Use WEEKS, MONTHS ou YEARS. Para período de teste, use uma oferta com trial no painel.
8 /gateway/pix/deposit ⛔ Responde 501. Fale com o suporte.
9 dueDate ⚠️ Aceito e ignorado: o vencimento segue a configuração da conta. Ajuste o vencimento no painel.
10 Webhooks do painel (não do callbackUrl) Os webhooks cadastrados na plataforma anterior não vêm junto. Cadastre de novo em Integrações → Webhooks, no formato Legado para manter o parser.
11 O mesmo identifier reaproveitado com outro valor ⚠️ Repetir o identifier com o mesmo pedido devolve a mesma transação; com outro valor ou outra forma de pagamento, responde 409 GATEWAY_FAILED_PRECONDITION. Gere um identifier novo para cada cobrança diferente.
12 Muitas requisições ⚠️ Limite de 100 por minuto por credencial, somando todas as rotas; consulta de transação e de assinatura, 30 por minuto. Use webhooks em vez de polling.

Cartão

Seção intitulada “Cartão”

Antes, o cartão podia ir pela API (/gateway/card/receive, com número e CVV). Na Auryon, o cartão é sempre digitado no checkout:

1. POST /api/v1/gateway/checkout      → { productId, offerCode, checkoutUrl }
2. redirecione o comprador ao checkoutUrl
3. receba o TRANSACTION_PAID no seu webhook (identifique pelo produto/oferta)

Por quê: quem recebe número de cartão no servidor precisa da certificação PCI-DSS de nível máximo (auditoria anual, testes de invasão, varreduras trimestrais). O checkout da Auryon tokeniza o cartão no navegador, e nem o seu servidor nem o da Auryon tocam no número. Você também deixa de ter dado de cartão passando pelo seu sistema.

Recomendado depois da migração: a API v1

Seção intitulada “Recomendado depois da migração: a API v1”

⚠️ A camada legada será desligada em 31 de dezembro de 2026. Até lá ela funciona sem mudanças; depois disso, só a API v1 responde. Planeje a troca com folga.

A camada legada está depreciada. Ela resolve a migração, mas tem três limitações que a API v1 não tem:

Legada v1
Webhook token fixo no corpo, sem assinatura HMAC-SHA256, proteção contra reenvio, rotação sem perda
Saldo só Reais por moeda
Dinheiro reais em número JSON menor unidade em string, sem erro de centavos

Um bom caminho: migre para a legada agora (troca de URL e chaves) e passe o webhook para o formato V1 quando puder. É a mudança com mais ganho de segurança.

Checklist de virada

Seção intitulada “Checklist de virada”
  • Credenciais novas geradas, com as permissões certas
  • URL base e chaves trocadas em todos os ambientes
  • Nenhuma chamada a /gateway/card/* (ou migradas para o checkout)
  • producerId dos splits atualizados para os IDs da Auryon
  • Preço do /gateway/checkout conferido em reais, e produtos aprovados
  • Assinaturas: cadência em WEEKS/MONTHS/YEARS (não DAYS) e sem firstChargeIn
  • Webhooks do painel recadastrados (formato Legado ou V1)
  • Um PIX de teste de ponta a ponta: criar → pagar → TRANSACTION_PAID recebido