Roteiro de homologação débito automático
Objetivo
Criamos esse roteiro com objetivo de validar se suas integrações estão coerentes com o esperado pela celcoin, após seu preenchimento será possível avaliar se o seu sistema está apto a transacionar apto a transacionar através do WebService de Débito automático.
Após conclusão do roteiro, por favor direcione o mesmo para nossa equipe de suporte que irá realizar uma homologação e tudo ocorrendo com sucesso, disponibiliza as chaves apis de produção para inicio da sua operação.
Procedimentos obrigatórios
Realizar os testes na sequência apresentada:
- Consulta da Utilities;
- Cadastro de uma conta;
- Consultas de subscriptions e Invoices;
- Consulta de Histórico;
- Confirma ou Recusa Pagamento;
- Cancelamento de inscrição.
Cada item deste roteiro está marcado no final de sua descrição, se o envio do mesmo será obrigatório, ou não.
Aprovação do roteiro
O roteiro deverá conter a seguintes evidências para aprovação de nosso analista:
Print/Captura da interface junto ao usuário e/ou log da aplicação (cliente) realizando a comunicação com a API;
Caso não seja realizado um item não obrigatório do roteiro, esclarecer com poucas palavras o motivo.
Não serão aprovados roteiros preenchidos com:
Print/Captura de requisições via Postman;
Print/Captura de requisições pelo Sandbox da API;
Print/Captura de qualquer plataforma que permite simulação de requisições e retornos do serviço da API
Relação de chamadas necessárias:
Consulta da Utilities
GET - /eda/v1/utilities/da
Cadastro
POST - /eda/v1/utilities/subscriptions
Consulta inscrições
GET - /eda/v1/utilities/subscriptions/{subscriptionId}/history
GET - /eda/v1/utilities/subscriptions/occurrence
GET - /eda/v1/utilities/invoices
GET - /eda/v1/utilities/invoices/duedate
Confirma ou Recusa Pagamento
PATCH - /eda/v1/utilities/invoices
Cancelamento de inscrição
DELETE - /eda/v1/utilities/subscriptions/{subscriptionId}
Roteiro
É obrigatório realizar as transações a partir da versão 1 ou superior, conforme procedimentos descritos acima.
Informar quais serão as formas de identificar uma transação ou o cadastro de conta no seu sistema. Ex: Cartão + AuteExterna ou TerminalExterno + AuteExterna.
OBS1: A chave deve ser única. Estes campos irão ajudar na auditoria do sistema origem;
OBS2: O externalTerminal pode ser o login do cliente, pode ser o id do cliente, CPF do cliente etc;
OBS3: O externalNSU pode ser o id de transação do sistema de origem ou um incremental por dia / cliente;
OBS4: Necessário estar com credencial liberada para uso do SandBox;
-
Realizar consulta de utilities com o filtro 3 Energia Elétrica. (Item obrigatório)
-
Criar uma Subscription para alguma utility de Energia elétrica, inserindo o pagamento automático (automaticPayment = true). (Item obrigatório)
-
Criar uma Subscription para alguma utility de Telecomunicações, inserindo o pagamento automático (automaticPayment = true). (Item obrigatório)
-
Receber e evidenciar o recebimento da troca de status da adesão e a da chegada de um novo débito. (Item obrigatório)
OBS1: É recebido via webHook, para isso será necessário o cadastro via chamado com a equipe de suporte através do email [email protected].
-
Realizar a busca de Histórico por Subscriptions passando o “SubscriptionsId” utilizado no item 3 ou 4. (Item obrigatório)
-
Realizar a busca por Invoices passando a data de vencimento de algum dos débitos recebidos como parâmetro, retornado no item 5. (Item obrigatório)
-
Realizar uma chamada de confirmação ou recusa do pagamento de um débito pelo endpoint de “Patch”. (Item obrigatório)
-
Realizar o cancelamento da subscription realizada no item 4. (Item obrigatório)
-
Exibir o fluxo a nível usuário da realização de uma subscrição. (*Item obrigatório)
Updated 4 months ago