Introducción
El proceso de autoacreditación tiene como objetivo aportar fluidez y agilidad al proceso de publicación a través de un flujo 100% en línea para permitir rápidamente la autorización de su operación. Para la autoacreditación en los canales abiertos al público, es necesario enviar la documentación y, principalmente, la 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 y proporcionaremos detalles de este viaje para brindar claridad y asegurarnos de que, al final de la lectura, esté listo para calificar.
¿Cómo es el proceso?
Podemos definir que este proceso se produce en 3 etapas principales:
- Ofrecer un escaparate;
- Registro de establecimientos;
- Pedido.
A medida que vaya leyendo, analizaremos cada uno de los pasos, así como las reglas empresariales, las operaciones REST y cómo completarlas. El objetivo es que, al final de la lectura, esté listo para comprar productos y servicios.
Los escalones
En esta sección, exploraremos los pasos en detalle, mostrando lo que es necesario para lograr el objetivo en cada uno de ellos de una manera funcional y técnica.
El siguiente diagrama ilustra el flujo de autoacreditación y abarca 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 a la documentación . El access_token generado debe pasarse como un parámetro llamado «Autorización» en el encabezado de la llamada.
Paso 1: Presentación de ofertas
El escaparate de ofertas tiene como objetivo permitir a los clientes averiguar 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 la anticipación de las cuentas por cobrar o facilitadores para su operación, como el enlace de pago.
Para conocer las ofertas disponibles, tenemos una operación REST en el servicio de Ofertas que reúne todos los productos y servicios que se pueden comprar:
OBTENGA https://{getnet-api-base}/v1/offerings
Parámetros importantes (QueryParams):
- campo - Este es el canal de origen y desde allí devuelve las ofertas asociadas al canal;
- canal - A través de esta información, podrá ver ofertas exclusivas para el país informado;
- tipo_fiscal - Indica si se trata de una persona física o jurídica.
La documentación técnica del servicio está disponible en Página de publicación y obtención de ofertas .
Tras seleccionar una de las ofertas que figuran en el escaparate, se debe fijar el precio, es decir, se deben consultar los precios y tarifas de los productos y servicios de Getnet en los sistemas internos para generar el precio según el tipo de producto.
Los precios deben hacerse a través del servicio de ofertas:
OBTENGA https://{getnet-api-base}/v1/offerings/{offering_id}/pricing
Parámetros importantes (ruta):
- id_de oferta - identificador de la oferta a la que se va a fijar el precio.
La documentación técnica del servicio está disponible en Página de precios .
Una vez que se haya fijado el precio de la oferta, debe estar disponible para su inclusión en el pedido. Para ello, se debe recuperar toda la información actualizada sobre la oferta, y esto se debe hacer a través del servicio de ofertas:
OBTENGA https://{getnet-api-base}/v1/offerings? priced_offering_id= {offering_id}
Parámetros importantes (QueryParam):
- id_de oferta - identificador de oferta.
La documentación técnica del servicio está disponible en Ofertas: página de publicación 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, porque a través de esta información podremos evaluar productos y servicios más personalizados, además de llevar a cabo algunos flujos de validación internos.
El registro del establecimiento se divide en dos formas:
Simplificado - En la versión simplificada, será necesario realizar 3 pasos a través de las API:
- Preinscripción: aquí debe introducir algunos datos básicos, como el tipo de persona (jurídica o física), el número de documento y el país para iniciar el proceso de registro;
- La actualización: en esta etapa, el paso de «registro previo» devuelve algunos campos relevantes para la operación y alguna información adicional que debe usarse para actualizar completamente su registro:
- Persona jurídica: además de los datos generales de la empresa, también se requieren otros grupos de datos, como: dirección comercial, actividad económica, contacto, socios, representante legal, horario de apertura, etc. ;
- Individual: además de los datos personales, también se requieren otros grupos de datos, como: dirección residencial y comercial, actividad económica, horario de apertura, etc.
- Calificación: en esta etapa final, evaluaremos todos los datos enviados para asegurarnos de que cumplen con los requisitos y, además, se llevará a cabo una evaluación completa de su registro para permitir la contratación de productos y servicios;
Completa - En este aspecto, el flujo se realizará en dos etapas también a través de API:
- Registro: en esta operación, será necesario informar todos los campos relevantes para 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: dirección comercial, actividad económica, contacto, socios, representante legal, horario de apertura, etc. ;
- Individual: además de los datos personales, también se requieren otros grupos de datos, como: dirección residencial 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 garantizar que los productos y servicios sean relevantes.
Operaciones REST:
Registro simplificado
PUBLICACIÓN https://{getnet-api-base}/merchants
Parámetros importantes (cuerpo):
- código_comprador : código del adquirente (siempre será getnet);
- datos_legales_del comerciante : Se trata de un objeto que contendrá información sobre el propio establecimiento:
- Persona jurídica : país, persona.tipo fiscal, persona.número_documento_legal;
- Individual : país, person.fiscal_type, person.legal_document_number y natalidad_nacimiento.
- información_adicional : Para fines 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 y condiciones generales de operación de la LGPD.
La documentación técnica de los servicios está disponible en Registro simplificado y Páginas de consulta de documentos .
Suplemento de inscripción
PUT https://{getnet-api-base}/merchants
Parámetros importantes (ruta):
- identificador del comerciante : ID de vendedor. Parámetros importantes (cuerpo):
- código_comprador : código del adquirente (siempre será getnet);
- datos_legales_del comerciante : Se trata de un objeto que contendrá información sobre el propio establecimiento:
- Entidad 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.work_hours y otros;
- Individual : 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.
- información_adicional : Para fines 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 y condiciones generales de operación de la LGPD.
La documentación técnica de los servicios está disponible en Registro simplificado y Páginas de consulta de documentos .
Calificación de registro
PUBLICACIÓN https://{getnet-api-base}/merchants/{merchant_id}/qualification
Parámetros importantes (ruta):
- identificador del comerciante : Identificación del establecimiento.
La documentación técnica de las operaciones está disponible en Enlace a comerciantes .
Paso 3: Crear el pedido
Para que una persona física o jurídica se convierta realmente en cliente de Getnet, es necesario comprar productos y/o servicios y, para ello, debe realizar un pedido.
La solicitud incluye información sobre la oferta seleccionada, los detalles del establecimiento, así como la dirección y la cuenta bancaria del cliente para recibir los pagos.
Para crear un pedido, se debe utilizar el servicio Pedidos:
PUBLICACIÓN https://{getnet-api-base}/v1/orders
Parámetros importantes (cuerpo):
- datos_legales_del comerciante : Este es un objeto que contendrá información sobre el propio establecimiento, como: país, person.fiscal _type, person.legal _document_number y similares;
- información_entrega : objeto que contiene la información para entregar los productos comprados en el pedido;
- cuentas mercantiles : objeto que contiene los detalles de la cuenta bancaria para recibir pagos;
- artículos : objeto que contiene todos los productos y servicios solicitados en el pedido.
La documentación técnica del servicio está disponible en Página de creación de pedidos .
Después de enviar el pedido, es necesario validar los datos enviados para el pedido y comprobar si son para poder enviar realmente el pedido.
Para validar el pedido, se debe utilizar el servicio de pedidos:
PUBLICACIÓN https://{getnet-api-base}/v1/orders/{order_id}/validation
Parámetros importantes (ruta):
- id_pedido : identificador del pedido que se va a validar.
La documentación técnica del servicio está disponible en Página de validación de pedidos .
Una vez que se valida y aprueba el pedido, se puede enviar para la compra y el envío de productos y/o servicios.
Para enviar el pedido, se debe utilizar el servicio de pedidos:
PUT https://{getnet-api-base}/v1/orders/{order_id}/submit
Parámetros importantes (ruta):
- id_pedido : identificador del pedido que se va a validar.
La documentación técnica del servicio está disponible en Página de envío de pedidos .