Guia inicial
Organização, autenticação e sequência da integração.
Abrir documentaçãoPara quem desenvolve
Clientes, catálogo, checkout e assinaturas. Comece pelo contexto da organização e conecte cada etapa ao seu backend.
A primeira consulta
Este exemplo consulta até dez clientes da conta conectada. A chave precisa da permissão customers:read na organização informada.
Configure as variáveis no seu servidor com a URL da API, o ID da organização e uma chave válida. O exemplo não envia requisições nesta página.
Consultar autenticaçãoShell / consulta de clientes
curl --get \
"$ADILA_PAY_BASE_URL/v2/organizations/$ORGANIZATION_ID/stripe/customers" \
--data-urlencode "limit=10" \
--header "x-api-key: $ADILA_PAY_API_KEY"Mantenha a chave no servidor. Nunca a inclua no frontend.
Da preparação ao resultado
Configure a conta de pagamentos e conclua o onboarding necessário. A conta Stripe é selecionada pelo servidor a partir da organização.
Crie uma chave com os recursos e ações necessários. Armazene o valor completo ao criá-la e revogue o acesso quando a integração terminar.
Use produtos e preços da conta conectada. Nas mutações, persista uma Idempotency-Key por operação e reutilize-a nas tentativas.
Verifique a sessão, o pagamento ou a fatura pela API antes de liberar o pedido. Defina também como tratar pagamentos pendentes e reembolsos.
Referências para construir
Organização, autenticação e sequência da integração.
Abrir documentaçãoModos de sessão, permissões e confirmação do pagamento.
Ler o guia de checkoutOs artefatos gerados estão disponíveis no projeto para uso local. Converse com a equipe sobre acesso e distribuição.
Solicitar orientação técnicaVamos construir
Alinhe ambiente, conta conectada e confirmação de pagamentos com a equipe antes de colocar a integração em operação.