Perguntas frequentes
Respostas sobre credenciais, ambientes, checkout e ferramentas.
Qual é o endereço da API?
No ambiente de teste, https://api-pay.adila.co. Configure esse endereço em ADILA_PAY_BASE_URL. docs.adila.co é o site de documentação.
Posso usar uma chave Stripe na Adila Pay?
Não. Envie uma API key Adila Pay vinculada à organização, usando x-api-key ou Authorization: Bearer. A chave Stripe é uma configuração do servidor da plataforma. Veja a autenticação.
Como alterno entre teste e produção?
Troque a API key. pk_test_ opera no sandbox e pk_live_ em produção, na mesma organização e com a mesma URL da API. No painel, troque o workspace. Entenda os ambientes.
A API key pode criar a conta conectada?
Não. Criação de conta e onboarding exigem um owner/admin autenticado com sessão humana. Depois da preparação, a API key pode acessar os recursos financeiros autorizados. Prepare a conta.
Posso colocar a API key no frontend?
Não. Faça as chamadas financeiras no servidor da sua aplicação e armazene a chave em um gerenciador de segredos. O frontend pode receber o resultado permitido pelo seu servidor, como o destino do Checkout hospedado.
Por que recebo 401 ou 403?
401 indica um problema com a credencial. Confira se foi enviada, se está válida e se não expirou ou foi revogada. 403 indica falta de autorização; revise a permissão da operação e, nos fluxos humanos, o papel do usuário. Consulte as permissões.
Como evito criar duas operações ao repetir uma chamada?
Persista uma chave de idempotência antes da primeira tentativa. Reutilize a mesma chave somente para a mesma operação e os mesmos parâmetros. Uma nova operação precisa de uma nova chave. Veja idempotência e erros.
Pix e boleto estão sempre disponíveis?
Não. A disponibilidade depende da habilitação e das capabilities da conta Stripe conectada. Confira sua conta antes de apresentar um meio de pagamento ao cliente.
O retorno do checkout confirma o pagamento?
Não. Consulte o estado financeiro no servidor antes de liberar o produto ou acesso. Use os eventos assinados para reagir, mas confirme o estado pela API antes de liberar. Entenda a confirmação de pagamento.
Como instalo o SDK?
Node.js ou Bun: npm install @adila-sh/pay (ou bun add @adila-sh/pay). Python: pip install adila-pay. PHP e Laravel: composer require adila-sh/pay. O guia do SDK traz os comandos, a configuração e exemplos para cada linguagem.
Preciso gerenciar repasses ou disputas?
A API oferece consultas desses recursos. A gestão de repasses e disputas continua no Dashboard Stripe. Consulte a referência de repasses e disputas.