Integração em produção

Antes de operar valores reais, valide o fluxo completo no sandbox. Produção é outro workspace da mesma organização, com conta conectada e API key próprias. Veja Ambientes.

Conta e credenciaisCopiar link da seção

• Confirme o endereço HTTPS da API de produção com a equipe.
• Conclua o onboarding da conta conectada e confira requirements e capabilities.
• Crie uma API key com o ambiente Produção (pk_live_); a organização é a mesma do sandbox.
• Conceda somente as permissões utilizadas pela integração.
• Guarde a API key no servidor e prepare sua revogação e substituição.

As capabilities da conta determinam quais meios de pagamento podem ser utilizados. Não assuma que Pix ou boleto estão disponíveis sem conferir a configuração da conta.

Catálogo e checkoutCopiar link da seção

Crie clientes, produtos e preços no ambiente de produção. IDs de teste não são transferidos para produção. Para assinaturas, use um preço recorrente e conceda payments:write e subscriptions:write à chave.

No Checkout hospedado, encaminhe o cliente à URL retornada pela sessão. As URLs de sucesso e cancelamento são definidas pelo servidor; alinhe esses destinos com a equipe operadora antes da publicação.

Confirmação de pagamentoCopiar link da seção

O retorno do cliente à sua aplicação não comprova o pagamento. Consulte a sessão, o PaymentIntent, a assinatura ou a fatura pela API autorizada e verifique o estado necessário para seu fluxo antes de entregar o produto.

A Adila Pay envia eventos assinados ao destino cadastrado pela sua organização, como payment.succeeded, payment.refunded e subscription.renewed. Use-os para reagir em tempo real, mas confirme o estado pela API antes de efeitos irreversíveis e deduplique pelo ID do evento. Consulte Eventos e confirmação de pagamento.

Repetições e falhasCopiar link da seção

Persista a chave de idempotência junto da operação lógica. Se houver timeout ou falha transitória, reutilize a mesma chave e os mesmos parâmetros. Não gere uma nova operação apenas porque a primeira resposta não chegou.

Trate os códigos HTTP conforme Idempotência, paginação e erros. Corrija erros de credencial, permissão e validação antes de repetir. Para falhas transitórias e rate limit, aplique espera progressiva.

Dados consumidos pela aplicaçãoCopiar link da seção

As respostas Stripe têm schemas abertos no contrato atual. Valide os campos que sua aplicação utiliza em vez de presumir que qualquer resposta possui o mesmo formato. Guarde os identificadores financeiros necessários à conciliação.

Ao investigar uma falha, compartilhe código HTTP, horário, operação e requestId, quando disponível. Evite incluir API keys, cookies, client_secret, URLs de sessão ou dados pessoais do pagador.