Começando

Onboarding e credenciais

O onboarding técnico é conduzido pelo time Idea+Cash Engineering em conjunto com o comercial. Ao final você recebe credenciais para dev, homologação e produção, com as contas vinculadas ao seu caso de uso.

1. Kickoff comercial

Formalize o contrato com a Idea+Cash. Compartilhe volumetria esperada, tipos de fluxo (cash-in, cash-out) e chaves Pix pretendidas.

2. KYP e habilitação da Conta Transacional Idea+Cash

Antes de qualquer credencial, seu cadastro passa por KYP e a Conta Transacional Idea+Cash é habilitada pelo time de Operações. Sem essa conta ativa não há operação Pix — ver Conta Transacional.

3. Kickoff técnico

Nesse encontro definimos com o seu time:

Quais contas sua integração poderá operar — ver Autorização por conta.
URLs de webhook e política de retentativas do seu lado.
Janela de homologação e critérios de aprovação — ver Homologação e go-live.

4. Provisionamento de credenciais

Você recebe, por canal seguro:

client_id e client_secret por ambiente (dev, hml, prod).
O accountId da Conta Transacional Idea+Cash — esse valor vai no header account-id das requests (ex.: account-id: <ACCOUNT_ID>). Alternativas: wallet-id ou tax-identifier.
O tenantid a ser enviado como header em todas as chamadas.
URLs de autenticação e de API por ambiente.

Segurança do segredo

Nunca versione o client_secret. Use cofre gerenciado (AWS Secrets Manager, GCP Secret Manager, HashiCorp Vault, Doppler). Rotacione imediatamente se houver suspeita de vazamento.

5. Vínculo integração ↔ conta

Sua integração é vinculada à(s) conta(s) que poderá operar. Toda rota /integration/v1/** que atua sobre conta valida esse vínculo contra a conta referenciada na request. Parceiro com N contas precisa de vínculo para cada uma — sem vínculo, a chamada retorna 403. Detalhes em Autorização por conta.

6. Homologação assistida

Roteiro mínimo, evidências e checklist de aprovação estão em Homologação e go-live.

7. Go-live monitorado

Aprovada a homologação, migramos as credenciais para o ambiente produtivo. O acompanhamento pós go-live é alinhado junto ao time de suporte Idea+Cash, com limites conservadores no início da operação.