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;

  1. Realizar consulta de utilities com o filtro 3 Energia Elétrica. (Item obrigatório)

  2. Criar uma Subscription para alguma utility de Energia elétrica, inserindo o pagamento automático (automaticPayment = true). (Item obrigatório)

  3. Criar uma Subscription para alguma utility de Telecomunicações, inserindo o pagamento automático (automaticPayment = true). (Item obrigatório)

  4. 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].

  1. Realizar a busca de Histórico por Subscriptions passando o “SubscriptionsId” utilizado no item 3 ou 4. (Item obrigatório)

  2. 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)

  3. Realizar uma chamada de confirmação ou recusa do pagamento de um débito pelo endpoint de “Patch”. (Item obrigatório)

  4. Realizar o cancelamento da subscription realizada no item 4. (Item obrigatório)

  5. Exibir o fluxo a nível usuário da realização de uma subscrição. (*Item obrigatório)