Environments
Com o nosso produto de Débito Direto, você tem acesso a dois ambientes para testes e pagamentos no mundo real:
Sandbox
Recomendamos fortemente que, enquanto você estiver integrando com a Belvo, comece com o ambiente Sandbox e depois prossiga para Produção.
Disponível para:
- 🟢 Pagamentos (Débito Direto México)
Use nosso ambiente Sandbox para construir sua integração. Neste ambiente, você pode:
- Usar nossa ferramenta de Importações em Massa sem código para simular pagamentos em lote.
- Usar nossa API para criar Customers, Payment Methods, Generate Agreements e Payment Requests.
- Usar nossas ferramentas de Relatórios para ver como o processo de reconciliação funciona.
Tudo o que você precisa para começar com o ambiente Sandbox é se inscrever no portal Sandbox e verificar seu endereço de e-mail. Depois disso, dependendo das suas necessidades, você pode:
- Seguir nosso guia dedicado Importação em Massa de Pagamentos por Débito Direto (Sem Código) para começar com pagamentos simulados.
- Gerar algumas chaves de API sandbox e Configurar um Débito Direto (API).
Atualizações de status do Sandbox
Para simular situações do mundo real, fornecemos os seguintes fluxos para métodos de pagamento e solicitações:
Métodos de Pagamento
Ao criar um método de pagamento, defina o bank como mx_santander.
Solicitações de pagamento
Ao fazer solicitações de pagamento, dependendo do fluxo que você deseja testar, será necessário fornecer diferentes palavras-chave como valor para o campo reference.
| Fluxo | Referência | Resultado |
|---|---|---|
| Sucesso | successful | A solicitação de pagamento segue estes status: initial -> processing -> successful. |
| Falha | failed | A solicitação de pagamento segue estes status: initial -> processing -> failed. |
| Chargeback | chargeback | A solicitação de pagamento segue estes status: initial -> processing -> successful->chargeback. |
| Padrão | (em branco) | A solicitação de pagamento segue estes status: initial -> processing -> successful. |
Produção
Disponível para:
- 🟢 Pagamentos (Débito Direto México)
Nosso ambiente de Produção lhe dará acesso a pagamentos reais para e de contas usando a plataforma de Débito Direto.
Depois de testar sua integração no ambiente Sandbox e estiver pronto para entrar em operação, você precisará entrar em contato com nossa equipe de suporte para acessar nosso ambiente de Produção. Nossa equipe de suporte entrará em contato com você para agendar uma reunião apenas para garantir que suas necessidades sejam atendidas, e então você só precisará passar por um processo de certificação com um de nossos engenheiros para garantir que sua integração esteja funcionando de forma otimizada.
Uma vez que sua integração esteja certificada, tudo o que você precisará fazer é se inscrever no portal de Produção e verificar seu email. Após isso, se você estiver usando nossa API, precisará:
- Gerar algumas chaves de API de produção.
- Alterar suas chaves de API do Sandbox no seu código para as chaves de API de Produção.
- Alterar a URL base para a qual você faz solicitações de api.sandbox.directdebit.belvo.com para api.directdebit.belvo.com.
- Configurar sua URL de webhook de produção.
Chaves de API e Autenticação
Gerar Chaves de API
Para obter suas chaves de API:
- Faça login no seu Portal de Débito Direto. (Login Sandbox | Login Produção)
- Vá para Desenvolvedores -> Chaves de API. (Chaves de API Sandbox | Chaves de API Produção)
- Clique em Gerar Chaves de API.
- Salve sua Chave Secreta e Senha Secreta (elas serão exibidas apenas uma vez).
- Após salvar e baixar sua chave secreta e senha, clique em Concluído.
✅ Suas chaves de API foram geradas com sucesso.
Autenticação
Após obter sua Secret Key e Secret Password, forneça-os nos cabeçalhos correspondentes sempre que fizer uma solicitação a um endpoint protegido.
curl --request <the_method> \
--url https://api.sandbox.directdebit.belvo.com/<the_endpoint>
--header 'api-key-id: <Your secret-key-id>' \
--header 'api-key-secret: <Your secret-password>'