Apps e roteamento

Uma key por produto

Crie um app por produto e ambiente (blackevin-prod, blackevin-staging, contagorda…). Cada um tem sua secret key, seus return hosts permitidos e seu outbound webhook, e só vê as próprias sessions e subscriptions. Revogar uma key nunca afeta as outras.

O formulário Novo app configura tudo em um passo: nome e cobranças, as rotas (gateways em ordem, cada um com De e Até opcionais) e um outbound webhook opcional. Logo depois, a página do app mostra a key e a request do /connect para copiar.

A key em Settings é a tenant key: ela age como admin sobre todos os apps (e no Default app, se você não enviar "app"). Para seus produtos, use as keys dos apps.

As rotas escolhem o gateway

1. 1As rotas são tentadas em ordem: a primeira dentro da janela, com gateway ativo e que suporta o pagamento, recebe.
2. 2Uma rota pode ter uma janela (de 1 a 10 de dezembro, por exemplo): fora dela a rota é pulada, e a próxima assume sozinha.
3. 3Métodos, moedas e subscriptions vêm do que cada gateway suporta; o resto é configurado no próprio gateway.
4. 4Se um gateway não consegue abrir o checkout, a próxima rota elegível é tentada na hora; a session guarda as tentativas nos metadados.
5. 5Um app sem rotas usa todos os gateways ativos da conta, por prioridade.

O que não muda

Uma subscription fica no gateway onde começou: a autorização do cartão está lá, então renovações e cancelamento continuam indo para ele. Mudar as rotas afeta só novos pagamentos e novas subscriptions; a página do app mostra quantas subscriptions ativas ficam em cada gateway.

Pagamento ou subscription

Um app cobra pagamentos avulsos ou subscriptions (a configuração Cobranças). O /connect cria esse tipo; trocar muda o checkout do produto sem deploy. POST /api/v1/sessions e /api/v1/subscriptions continuam disponíveis para os dois tipos.