Introducción

El proceso de autoacreditación tiene como objetivo aportar fluidez y agilidad al proceso de liberación a través de un flujo 100% online para habilitar rápidamente la autorización de su operación. Para la autoacreditación en canales abiertos al público, es necesario enviar documentación y, principalmente, biometría facial a través de la aplicación Getnet Brasil.

A través de esta guía, exploraremos cada uno de los pasos, proporcionando detalles de este viaje para aportar claridad y asegurar que, al final de la lectura, esté listo para ser calificado.

¿Cómo es el proceso?

Podemos definir que este proceso ocurre en 3 etapas principales:

  • Escaparate de ofertas;
  • Registro del establecimiento;
  • Pedido.
image

A medida que avance en la lectura, exploraremos cada uno de los pasos, así como las reglas de negocio, las operaciones REST y cómo completarlas. El objetivo es que al final de la lectura esté listo para adquirir productos y servicios.

Los pasos

En esta sección, exploraremos los pasos en detalle, mostrando lo que es necesario para lograr el objetivo en cada uno de ellos de forma funcional y técnica.

El siguiente diagrama ilustra el flujo de autoacreditación, cubriendo los pasos que se detallarán a continuación:

Para consumir operaciones REST, es necesario realizar el flujo de autenticación disponible en este enlace de documentación . El access_token generado debe pasarse como un parámetro llamado “ Authorization ” en la cabecera de la llamada.
Paso 1: Escaparate de Ofertas

El Escaparate de Ofertas tiene como objetivo permitir que los clientes conozcan qué productos y servicios están disponibles para su compra. Existe una variedad de productos y servicios que van desde soluciones digitales y financieras hasta las famosas máquinas de tarjetas.

Cuando analizamos el tema de las soluciones digitales y financieras, existen mecanismos que pueden promover aún más la salud financiera, como el anticipo de cobros o facilitadores para su operación, como el enlace de pago.

Para conocer las ofertas disponibles, disponemos de una operación REST en el servicio Offers que devuelve todos los productos y servicios que se pueden adquirir:


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

Parámetros importantes ( queryParams ):

  • country - Este es el canal de origen y, a partir de ahí, devuelve las ofertas asociadas al canal;
  • channel - A través de esta información, podrá ver ofertas exclusivas para el país informado;
  • fiscal_type - Denota si se trata de una persona física o jurídica.
La documentación técnica del servicio está disponible en la página de Listado y Obtención de Ofertas .

Tras seleccionar una de las ofertas listadas en el escaparate, debe tarificarse, es decir, deben consultarse los precios y tasas de los productos y servicios de Getnet en los sistemas internos para generar la tarificación según el tipo de producto.

La tarificación debe realizarse a través del servicio Offers:


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

Parámetros importantes (path):

  • offering_id - identificador de la oferta a tarificar.
La documentación técnica del servicio está disponible en la página de Tarificación .

Una vez tarificada la oferta, debe ponerse a disposición para su inclusión en el pedido. Para ello, debe recuperarse toda la información actualizada sobre la oferta, y esto debe hacerse a través del servicio Offers:


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

Parámetros importantes ( queryParam ):

  • offering_id - identificador de la oferta.
La documentación técnica del servicio está disponible en la página de Ofertas - Listado y Obtención .

Paso 2: Registro del Establecimiento

Para consolidar las ofertas e incluso ver su viabilidad, necesitamos saber más sobre usted y el establecimiento, ya que a través de esta información podremos evaluar productos y servicios más personalizados, además de realizar algunos flujos de validación interna.

El registro del establecimiento se divide en dos modalidades:

Simplificado - En la versión simplificada, será necesario realizar 3 pasos a través de APIs:
  • Pre-registro - Aquí se introduce información básica, como el tipo de persona (física o jurídica), el número de documento y el país para iniciar el proceso de registro;
  • La actualización - En esta etapa, el paso de “pre-registro” devuelve algunos campos relevantes para la operación y cierta información adicional que debe utilizarse para actualizar su registro por completo:
  • Persona Jurídica: además de los datos generales de la empresa, también se requieren otros grupos de datos, como: domicilio social, actividad económica, contacto, socios, representante legal, horario de apertura, etc.;
  • Persona Física: además de los datos personales, también se requieren otros grupos de datos, como: domicilio particular y comercial, actividad económica, horario de apertura, etc.
  • Calificación - En esta etapa final, evaluaremos todos los datos enviados para asegurar que cumplen con la normativa y, además, se llevará a cabo una evaluación completa de su registro para permitir la contratación de productos y servicios;
Completo - En este aspecto, el flujo ocurrirá en dos etapas también a través de APIs:
  • Registro - En esta operación, será necesario informar todos los campos relevantes según el tipo de persona:
  • Persona Jurídica: además de los datos generales de la empresa, también se requieren otros grupos de datos, como: domicilio social, actividad económica, contacto, socios, representante legal, horario de apertura, etc.;
  • Persona Física: además de los datos personales, también se requieren otros grupos de datos, como: domicilio particular y comercial, actividad económica, horario de apertura, etc.
  • Calificación - Esta etapa sigue el mismo formato que la versión simplificada, es decir, se evaluará todo el registro para asegurar que los productos y servicios son pertinentes.

Operaciones REST:

Registro Simplificado

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

Parámetros importantes (body):

  • acquirer_code : Código del Acquirer (siempre será getnet );
  • merchant_legal_data : Este es un objeto que contendrá información sobre el propio establecimiento:
  • Persona Jurídica : country, person.fiscal _type , person.legal _document_number ;
  • Persona Física : country, person.fiscal_type, person.legal_document_number y birth_date.
  • additional_information : A efectos de registro, términos y condiciones, es necesario aceptar esta información y, para ello, este objeto representa la “aceptación” de los términos de la LGPD y las condiciones generales de funcionamiento.
La documentación técnica de los servicios está disponible en las páginas de Registro Simplificado y Consulta de Documentos .

Complemento de registro

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

Parámetros importantes (path):

  • merchant_id : ID del Merchant. Parámetros importantes (body):
  • acquirer_code : Código del Acquirer (siempre será getnet );
  • merchant_legal_data : Este es un objeto que contendrá información sobre el propio establecimiento:
  • Persona 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 y otros;
  • Persona 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 y otros.
  • additional_information : A efectos de registro, términos y condiciones, es necesario aceptar esta información y, para ello, este objeto representa la “aceptación” de los términos de la LGPD y las condiciones generales de funcionamiento.
La documentación técnica de los servicios está disponible en las páginas de Registro Simplificado y Consulta de Documentos .

Calificación de registro

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

Parámetros importantes (path):

  • merchant_id : Identificación del establecimiento.
La documentación técnica de las operaciones está disponible en este enlace de Merchants .

Paso 3: Creación del Pedido

Para que una persona física o jurídica se convierta realmente en cliente de Getnet, es necesario adquirir productos y/o servicios y, para ello, debe realizarse un pedido.

La solicitud incluye información sobre la oferta seleccionada, detalles del establecimiento, así como la dirección del cliente y la cuenta bancaria para la recepción de pagos.

Para crear un pedido, debe utilizarse el servicio Orders:


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

Parámetros importantes (body):

  • merchant_legal_data : Este es un objeto que contendrá información sobre el propio establecimiento, como: country, person.fiscal _type , person.legal _document_number y similares;
  • delivery_info : objeto que contiene la información para entregar los productos adquiridos en el pedido;
  • merchant_accounts : objeto que contiene los datos de la cuenta bancaria para la recepción de pagos;
  • items : objeto que contiene todos los productos y servicios solicitados en el pedido.
La documentación técnica del servicio está disponible en la página de Creación de Pedidos .

Tras el envío del pedido, es necesario validar los datos enviados para el mismo y comprobar si son correctos para proceder a su envío definitivo.

Para validar el pedido, debe utilizarse el servicio Orders:


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

Parámetros importantes (path):

  • order_id : identificador del pedido a validar.
La documentación técnica del servicio está disponible en la página de Validación de Pedidos .

Una vez validado y aprobado el pedido, este puede enviarse para la compra y el envío de productos y/o servicios.

Para enviar el pedido, debe utilizarse el servicio Orders:


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

Parámetros importantes (path):

  • order_id : identificador del pedido a validar.
La documentación técnica del servicio está disponible en la página de Envío de Pedidos .