Introdução

O processo de autocredenciamento visa trazer fluidez e agilidade ao processo de liberação por meio de um fluxo 100% online para habilitar rapidamente a autorização de sua operação. Para o autocredenciamento em canais abertos ao público, é necessário o envio de documentação e, principalmente, biometria facial via aplicativo Getnet Brasil.

Através deste guia, exploraremos cada uma das etapas, fornecendo detalhes desta jornada a fim de trazer clareza e garantir que, ao final da leitura, você esteja pronto para ser qualificado.

Como é o processo?

Podemos definir que este processo ocorre em 3 estágios principais:

  • Vitrine de ofertas;
  • Cadastro do estabelecimento;
  • Pedido.
image

Conforme você ler, exploraremos cada uma das etapas, bem como regras de negócio, operações REST e como concluí-las. O objetivo é que, ao final da leitura, você esteja pronto para adquirir produtos e serviços.

As etapas

Nesta seção, exploraremos as etapas em detalhes, mostrando o que é necessário para atingir o objetivo em cada uma delas de forma funcional e técnica.

O diagrama abaixo ilustra o fluxo de autocredenciamento, abrangendo as etapas que serão detalhadas a seguir:

Para consumir operações REST, é necessário realizar o fluxo de autenticação disponível neste link de documentação . O access_token gerado deve ser passado como um parâmetro chamado “ Authorization ” no cabeçalho da chamada.
Etapa 1: Vitrine de Ofertas

A Vitrine de Ofertas visa permitir que os clientes saibam quais produtos e serviços estão disponíveis para compra. Existe uma variedade de produtos e serviços que variam de soluções digitais e financeiras até as famosas máquinas de cartão.

Quando olhamos para o tópico de soluções digitais e financeiras, existem mecanismos que podem promover ainda mais a saúde financeira, como a antecipação de recebíveis ou facilitadores para sua operação, como o link de pagamento.

Para saber sobre as ofertas disponíveis, temos uma operação REST no serviço Offers que traz todos os produtos e serviços que podem ser adquiridos:


GET https://{getnet-api-base}/v1/offerings

Parâmetros importantes ( queryParams ):

  • country - Este é o canal de origem e, a partir daí, retorna as ofertas associadas ao canal;
  • channel - Através desta informação, você poderá ver ofertas exclusivas para o país informado;
  • fiscal_type - Denota se é uma pessoa física ou jurídica.
A documentação técnica do serviço está disponível na página de Listagem e Obtenção de Ofertas .

Após selecionar uma das ofertas listadas na vitrine, ela deve ser precificada, ou seja, os preços e taxas dos produtos e serviços Getnet devem ser consultados nos sistemas internos para gerar a precificação de acordo com o tipo de produto.

A precificação deve ser feita através do serviço Offers:


GET https://{getnet-api-base}/v1/offerings/{offering_id}/pricing

Parâmetros importantes (path):

  • offering_id - identificador da oferta a ser precificada.
A documentação técnica do serviço está disponível na página de Precificação .

Uma vez que a oferta foi precificada, ela deve ser disponibilizada para inclusão no pedido. Para fazer isso, todas as informações atualizadas sobre a oferta devem ser recuperadas, e isso deve ser feito através do serviço Offers:


GET https://{getnet-api-base}/v1/offerings?priced_offering_id={offering_id}

Parâmetros importantes ( queryParam ):

  • offering_id - identificador da oferta.
A documentação técnica do serviço está disponível na página de Ofertas - Listagem e Obtenção .

Etapa 2: Cadastro do Estabelecimento

Para consolidar as ofertas e até mesmo ver sua viabilidade, precisamos saber mais sobre você e o estabelecimento, pois através destas informações seremos capazes de avaliar produtos e serviços mais personalizados, além de realizar alguns fluxos de validação interna.

O cadastro do estabelecimento é dividido em duas formas:

Simplificado - Na versão simplificada, será necessário realizar 3 etapas via APIs:
  • Pré-cadastro - Aqui você insere algumas informações básicas, como tipo de pessoa (jurídica ou física), número do documento e país para iniciar o processo de cadastro;
  • A atualização - Nesta etapa, a etapa de “pré-cadastro” retorna alguns campos relevantes para a operação e algumas informações adicionais que devem ser usadas para atualizar seu cadastro completamente:
  • Pessoa Jurídica: além dos dados gerais da empresa, outros grupos de dados também são necessários, como: endereço comercial, atividade econômica, contato, sócios, representante legal, horário de funcionamento, etc.;
  • Pessoa Física: além dos dados pessoais, outros grupos de dados também são necessários, como: endereço residencial e comercial, atividade econômica, horário de funcionamento, etc.
  • Qualificação - Nesta etapa final, avaliaremos todos os dados enviados para garantir que estejam em conformidade e, também, uma avaliação completa do seu cadastro será realizada para permitir a contratação de produtos e serviços;
Completo - Neste aspecto, o fluxo ocorrerá em duas etapas também via APIs:
  • Cadastro - Nesta operação, será necessário informar todos os campos relevantes para o tipo de pessoa:
  • Pessoa Jurídica: além dos dados gerais da empresa, outros grupos de dados também são necessários, como: endereço comercial, atividade econômica, contato, sócios, representante legal, horário de funcionamento, etc.;
  • Pessoa Física: além dos dados pessoais, outros grupos de dados também são necessários, como: endereço residencial e comercial, atividade econômica, horário de funcionamento, etc.
  • Qualificação - Esta etapa segue o mesmo formato da versão simplificada, ou seja, todo o cadastro será avaliado para garantir que os produtos e serviços sejam relevantes.

Operações REST:

Cadastro Simplificado

POST https://{getnet-api-base}/merchants

Parâmetros importantes (body):

  • acquirer_code : Código do adquirente (será sempre getnet );
  • merchant_legal_data : Este é um objeto que conterá informações sobre o próprio estabelecimento:
  • Pessoa Jurídica : country, person.fiscal _type , person.legal _document_number ;
  • Pessoa Física : country, person.fiscal_type, person.legal_document_number e birth_date.
  • additional_information : Para fins de cadastro, termos e condições, é necessário aceitar estas informações e, para isso, este objeto representa o “aceite” dos termos da LGPD e condições gerais de operação.
A documentação técnica dos serviços está disponível nas páginas de Cadastro Simplificado e Consulta de Documentos .

Complemento de cadastro

PUT https://{getnet-api-base}/merchants

Parâmetros importantes (path):

  • merchant_id : ID do Merchant. Parâmetros importantes (body):
  • acquirer_code : Código do adquirente (será sempre getnet );
  • merchant_legal_data : Este é um objeto que conterá informações sobre o próprio estabelecimento:
  • Pessoa Jurídica : country, person.fiscal_type, person.legal_document_number, person.legal_name, person.founding_date, person.business_address, person.economic_activity_profile, person.contacts, person.shareholders, person.legal_representative, person.working_hours e outros;
  • Pessoa Física : country, person.fiscal_type, person.legal_document_number, person, person.birth_date, person.economic_activity_profile, person.residential_address, person.commercial_address, person.working_hours, person.legal_representative e outros.
  • additional_information : Para fins de cadastro, termos e condições, é necessário aceitar estas informações e, para isso, este objeto representa o “aceite” dos termos da LGPD e condições gerais de operação.
A documentação técnica dos serviços está disponível nas páginas de Cadastro Simplificado e Consulta de Documentos .

Qualificação de cadastro

POST https://{getnet-api-base}/merchants/{merchant_id}/qualification

Parâmetros importantes (path):

  • merchant_id : Identificação do estabelecimento.
A documentação técnica das operações está disponível neste link de Merchants .

Etapa 3: Criação do Pedido

Para que uma pessoa física ou jurídica se torne efetivamente um cliente Getnet, é necessário adquirir produtos e/ou serviços e, para isso, um pedido deve ser feito.

A solicitação inclui informações sobre a oferta selecionada, detalhes do estabelecimento, bem como o endereço do cliente e a conta bancária para recebimento de pagamentos.

Para criar um pedido, o serviço Orders deve ser utilizado:


POST https://{getnet-api-base}/v1/orders

Parâmetros importantes (body):

  • merchant_legal_data : Este é um objeto que conterá informações sobre o próprio estabelecimento, como: country, person.fiscal _type , person.legal _document_number e similares;
  • delivery_info : objeto contendo as informações para entrega dos produtos adquiridos no pedido;
  • merchant_accounts : objeto contendo detalhes da conta bancária para recebimento de pagamentos;
  • items : objeto que contém todos os produtos e serviços solicitados no pedido.
A documentação técnica do serviço está disponível na página de Criação de Pedido .

Após o envio do pedido, é necessário validar os dados enviados para o pedido e verificar se estão em conformidade para submeter o pedido efetivamente.

Para validar o pedido, o serviço Orders deve ser utilizado:


POST https://{getnet-api-base}/v1/orders/{order_id}/validation

Parâmetros importantes (path):

  • order_id : identificador do pedido a ser validado.
A documentação técnica do serviço está disponível na página de Validação de Pedido .

Uma vez que o pedido é validado e aprovado, o pedido pode ser submetido para compra e envio de produtos e/ou serviços.

Para enviar o pedido, o serviço Orders deve ser utilizado:


PUT https://{getnet-api-base}/v1/orders/{order_id}/submit

Parâmetros importantes (path):

  • order_id : identificador do pedido a ser validado.
A documentação técnica do serviço está disponível na página de Envio de Pedido .