Integración de eCommerce

Esta sección proporciona una guía detallada para la integración de eCommerce y tiendas en línea con RefácilPay. El sistema permite una integración sencilla y eficiente, ofreciendo a los clientes una experiencia de pago segura, rápida y sin complicaciones.

Pasos a seguir para la integración

1. Registro de la tienda: Crear una cuenta y completar la configuración inicial.

2. Obtener token de consumo API: Generar y guardar las credenciales API necesarias para la integración.

3. Consumo de API: Seguir la guía de integración técnica para utilizar los servicios proporcionados por RefácilPay.

Registro de la tienda

Para completar este paso, es necesario construir una URL con ciertos parámetros de entrada que permitirán la vinculación del eCommerce con RefácilPay. La estructura de la URL debe seguir el siguiente formato:

https://autoregistro.refacilpay.co/?comm=1&storeid=1234&returnurl=https://webhok-de-envio-token&nameintegration=NombreECommerce

Ambiente de prueba: https://autoregistro.qa.refacilpay.co/?comm=1&storeid=1234&returnurl=https://webhok-de-envio-token&nameintegration=NombreECommerce

Parámetros de la URL

Name	Type	Description
comm	number	Identificador único del eCommerce (Este ID debe ser solicitado al equipo de RefacilPay).
storeid	string	Identificador único de la tienda asociada al usuario que se está integrando.
returnurl	string	URL a la cual se enviará la notificación del token de autenticación para la tienda. Este token permitirá realizar las peticiones necesarias para consumir los servicios del API.
nameintegration	string	Nombre del eCommerce.

Una vez que se ha generado la URL con los parámetros necesarios, se debe ingresar dicha URL en la barra de búsqueda de un navegador. Esto iniciará el proceso de autorregistro del eCommerce para obtener un usuario. Durante este proceso, se configurarán los datos necesarios y se obtendrán las credenciales de acceso a la plataforma.

Obtener token de consumo API

Después de completar el autorregistro, se procederá a la validación y verificación de los datos proporcionados para confirmar la identidad del registro. Una vez que se ha finalizado este proceso de validación y la identidad ha sido verificada correctamente, se enviará un correo electrónico informando sobre la integración exitosa y se procederá a enviar el token a la URL especificada en el parámetro returnurl.

El envío del token se realizará mediante una petición HTTPS tipo POST con el siguiente formato:

POST {{returnurl}}

Headers

Name	Value
Content-Type	application/json

Fields (Body)

Name	Type	Description
token	string	Token sin expiración para consumir los servicios del API.
storeId	string	Identificador único de la tienda integrada asociada al usuario, proporcionado en los parámetros de la URL de registro.

Request

{
  "token": "MTY4ODQ5NzUyMTk4MSQyYiQxMCRsWlhiU2lkRE0vczdYTkJBcWpENVhPZHhiUGIyVXR3akE5U2RFbjJJRGNPTVQ3TkMvcGRiSw==",
  "storeId": "12345",
}

Consumo de API

Una vez completado el autorregistro y obtenido el token, se podrá utilizar los servicios proporcionados por la API. Para generar un recurso de pago, siga el siguiente flujo:

• Obtener token transaccional

Token Transaccional

• Generar recurso con Link de Pago

Pagos

Para los recursos generados desde la integración de eCommerce, se deben incluir en el campo reference2los siguientes datos:

Name	Type	Description
Commerce	object	Objeto que contiene los datos de la integración con el eCommerce.

Dentro del objeto Commerce, se deben incluir los datos correspondientes al ID del eCommerce proporcionado por RefacilPay y al ID de la tienda.

Name	Type	Description
origin	number	Identificador único del eCommerce (ID proporcionado por el equipo RefácilPay para el proceso de registro).
storeId	string	Identificador único de la tienda integrada asociada al usuario registrado.

Ejemplo

{
  "expiresIn": 0,
  "amount": 18000,
  "brandId": 61,
  "webhookUrl": "https://****gerstg.azure-api.net/SkCo.PagosEnLinea.API/payonline/PostStatus",
  "returnUrl": "https://www.google.com/",
  "showSummary": true,
  "reference1": "CGOOsiYQspMpgDD",
  "reference2": {
    "Label": {
      "Name": "Juanita Perez",
      "Email": "pqacLO87V77DgF62P8PXENA==do",
      "CellPhone": "1VM6daPPJcXCD4Cw93272oQ==8",
      "PersonType": "N",
      "DocumentType": "C",
      "DocumentNumber": 79706920
    },
    "Commerce": {
      "origin": 1,
      "storeId": "12345"
    }
  }
}

• Una vez que se hayan generado o consumido los recursos de pago, se podrá consultar la información sobre el estado del mismo.

Información de pagos