Cómo Integrar Clearsale con DEUNA

El objetivo de este manual es ayudarte a entender cómo integrar Clearsale Pre-Autorización con DEUNA. Antes de comenzar, es necesario realizar los siguientes pasos para certificar tu cuenta y credenciales.


Beneficios

  • Podrás utilizar Clearsale de manera centralizada en DEUNA.

Proceso de Certificación Clearsale y DEUNA en Ambiente de Pruebas

Requisitos

  • Tener una cuenta en Clearsale
  • En tu tienda de pruebas:
    • Acceso a Clearsale
    • Configurar productos con montos:
      • 1 Producto con monto ≤ 50
      • 1 Producto con monto > 50 y ≤ 100
      • 1 Producto con monto > 100

👍

Durante el proceso de integración, el comercio contará con un ingeniero de ventas u operación técnica dedicado para realizar las pruebas en los entornos de sandbox y producción. Si tienes un KAM de tu motor antifraude, te recomendamos informarlo para agilizar el proceso.


Paso 1: Enviar Correo a Clearsale para Activar DEUNA

Para activar Clearsale con Pre-Autorización

Envía un correo a Clearsale indicando que activarás DEUNA. A continuación, un ejemplo del correo:

Habilitar DEUNA con flujo Clearsale Pre Autorización

Hola equipo de Clearsale,

Empezaremos el proceso de certificación con DEUNA con flujo pre autorización. Una vez finalicemos, se enviarán los casos para revisión para:
1. Aprobación automática
2. Reprobación automática
3. Análisis Manual - Aprobado Manualmente
4. Análisis Manual - Declinado Manualmente
5. Análisis Manual - Mantenerlo en estado Analyzing

Además, compartimos las URLs de DEUNA para activar los webhooks:
- Ambiente de pruebas: https://api.stg.deuna.io/manual-review
- Ambiente de producción: https://apigw.getduna.com/manual-review

Saludos,


Clearsale te indicará que una vez enviadas las evidencias de transacciones de prueba, habilitarán la configuración en producción.

Paso 2: Obtener Credenciales de Prueba desde Clearsale

  • En el Dashboard, ve a la parte superior derecha, presiona los tres puntos, selecciona Settings y haz clic.

  • Copia los datos de API Key, Client Id y Client Secret. Estos serán utilizados en el admin de DEUNA.

Paso 3: Configurar Clearsale en tu Tienda de Pruebas de DEUNA

Para activar Clearsale con Pre-Autorización

  • En el admin de DEUNA, ve al menú derecho, selecciona Pagos -> Conexiones.

  • En el buscador, escribe "clearsale" y presiona el botón "conectar"

  • Llena la información obtenida de tu panel de Clearsale y presiona Conectar

  • Al finalizar la configuración verás una pantalla indicando que ya fué configurado

Paso 4: Realizar Prueba de Integración en Ambiente de Pruebas

  • Realiza las siguientes pruebas de integración:
#CasoReglaCaso de usoCriterio de aceptación
1Aprobación automáticaTransacción con DEUNA con monto total ≤ 501. El comprador selecciona un producto con un monto ≤ 50. 2. Selecciona DEUNA para realizar el pago. 3. Llena la información y finaliza la compra.1. La transacción es aprobada en DEUNA. 2. La transacción queda aprobada en Clearsale. 3. La transacción queda aprobada en tu tienda.
2Reprobación automáticaTransacción con DEUNA > 50 monto total ≤ 1001. El comprador selecciona un producto con un monto > 50 y ≤ 100. 2. Selecciona DEUNA para realizar el pago. 3. Llena la información y finaliza la compra.1. La transacción en DEUNA es denegada. 2. La transacción queda denegada en Clearsale. 3. La transacción queda reprobada en tu tienda.
3Análisis Manual - Aprobado ManualmenteTransacción con DEUNA por monto total > 1001. El comprador selecciona un producto con un monto > 100. 2. Selecciona DEUNA para realizar el pago. 3. Llena la información y finaliza la compra. 4. El merchant entra a su panel de Clearsale y DEUNA para validar la transacción pendiente. 5. El merchant aprueba manualmente la transacción.1. La transacción en DEUNA queda aprobada. 2. La transacción en Clearsale queda aprobada. 3. La transacción en tu tienda queda aprobada.
4Análisis Manual - Declinado ManualmenteTransacción con DEUNA por monto total > 1001. El comprador selecciona un producto con un monto > 100. 2. Selecciona DEUNA para realizar el pago. 3. Llena la información y finaliza la compra. 4. El merchant entra a su panel de Clearsale y DEUNA para validar la transacción pendiente. 5. El merchant declina manualmente la transacción.1. La transacción en DEUNA queda rechazada. 2. La transacción en Clearsale queda rechazada. 3. La transacción en tu tienda queda rechazada.
5Análisis Manual - Mantenerlo en estado AnalyzingTransacción con DEUNA por monto total > 1001. El comprador selecciona un producto con un monto > 100. 2. Selecciona DEUNA para realizar el pago. 3. Llena la información y finaliza la compra.1. La transacción en Clearsale queda como analyzing.
  • Al finalizar las pruebas debes entrar a DEUNA y buscar las 5 transacciones, en cada una de ellas debes copiar el ID de transacción para enviarlo a clearsale. Para eso debes entrar al dashboard de DEUNA y entrar al módulo de ordenes

  • Cuando entras al detalle debes copiar el ID de la transacción como en la imágen, por cada una de las pruebas realizadas

Paso 5: Enviar Evidencia de las Pruebas a Clearsale

Una vez finalizadas las pruebas, envía un correo a Clearsale con la evidencia de las transacciones. Recomendamos enviarlo en el mismo correo donde se inició la conversación de DEUNA..

Estimado equipo de Clearsale,

Adjuntamos evidencia de las pruebas con DEUNA en ambiente de pruebas:

1. Aprobación automática:  1xxxxxxx123
2. Reprobación automática: 1xxxxxxx123
3. Análisis Manual - Aprobado Manualmente: 1xxxxxxx123
4. Análisis Manual - Declinado Manualmente: 1xxxxxxx123
5. Análisis Manual - Mantenerlo en estado Analyzing: 1xxxxxxx123

Esperamos su confirmación para realizar la activación en producción.

Saludos,
  • Clearsale responderá indicando que puedes avanzar con el proceso en producción.

Proceso de Certificación Clearsale y DEUNA en Ambiente Productivo

Requisitos

  • Completaste la certificación en ambiente de pruebas
  • Tener acceso a una cuenta en Clearsale productiva
  • Contar con tarjeta real para realizar las pruebas

Paso 1: Obtener credenciales y configurar clearsale en DEUNA

Para el ambiente productivo, el proceso es el mismo para la obtención de credenciales de clearsale y configuración en el admin de DEUNA, pero utilizando las URLs y credenciales de producción:

Paso 2: Realizar transacciones de prueba productivas

  • Importante: Debes tener disponible una tarjeta para realizar las pruebas productivas.
  • Al igual que en el proceso de pruebas debes enviar evidencia a clearsale. Se recomienda enviar evidencia de al menos tres transacciones a Clearsale una vez configurado y activado.

Paso 3: Enviar evidencia a clearsale de pruebas productivas

Para finalizar debes enviar a clearsale en el mismo correo las transacciones productivas para validar que todo está correcto.


Activación de revisión manual en DEUNA


Paso 1: Activar Manual Review en DEUNA

Una vez el motor de fraude te confirme que se activó el webhook, es de suma importancia realizar la siguiente configuración. Debes entrar a tu configuración de DEUNA e ir a Administración -> Comercio y activar los atributos de "Ajustes generales de fraude"

  • Habilitar revisión manual
  • Habilitar ejecución automática de operaciones

Una vez activado, podemos continuar con el proceso