Integre a API da Coloca, passo a passo.

Crie sua conta no sandbox

Acesse app.qa.colocapayments.com e escolha Registrar-se. O cadastro cria sua organização e seu usuário, que fica como administrador.

• Preencha o formulário com seus dados e os da sua empresa.
• Você recebe um código de 6 dígitos por e-mail: digite-o para confirmar seu endereço.
• Sua equipe não precisa se cadastrar: depois você os convida em Configurações → Acesso e permissões.

O QA é independente da produção: mesmo que você já tenha conta em produção, crie uma nova no QA. Recomendado: ative a autenticação de dois fatores (2FA) em Configurações → Segurança.

Peça para habilitarmos suas API keys

A criação de API keys vem desativada, também no QA. Escreva para hello@colocapayments.com e nós a ativamos para sua organização: no sandbox ela é habilitada na hora, sem revisão prévia.

• Escreva a partir do mesmo e-mail que você usou no cadastro do QA.
• Conte o nome da sua organização e o que você vai integrar: recebimentos, envios, cartões…
• Respondemos no mesmo e-mail quando estiver ativa. O botão abaixo deixa o e-mail pronto.

Agende sua revisão técnica

Quando seu fluxo funcionar de ponta a ponta no QA, agende uma reunião pelo Meet com nossa equipe técnica e mostre sua integração funcionando.

Antes de agendar, confirme que:

• Sua organização no QA está verificada e seu fluxo principal funciona de ponta a ponta.
• Você usa Idempotency-Key nas operações que movimentam dinheiro e trata bem as novas tentativas.
• Você trata os erros por code: validação, saldo insuficiente, verificação exigida, limites de valor.
• Seu webhook está configurado, passa no teste de conexão e valida x-secret.
• Suas API keys estão guardadas com segurança e têm apenas as permissões necessárias.
• Você consulta o status das operações (endpoints de consulta ou webhooks), sem depender só da resposta inicial.

Na reunião você nos mostra seus casos de uso funcionando, o tratamento de erros, a idempotência, os webhooks e como protege suas API keys. Se for aprovada, você fica pronto para a produção; se houver observações, nós as compartilhamos e agendamos outra revisão.