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.

Requisitos

El siguiente contenido enlista los requirimientos para una integracion exitosa con Clearsale.

Requisitos en ambiente de pruebas

Necesitas las siguientes credenciales para probar la integración con Clearsale:

  • Cuenta en Clearsale
  • Aceeso a la tienda de pruebas Clearsale
  • Productos de prueba con los siguientes montos configurados:
    • Un producto con monto igual o menor 50.
    • Un producto con monto mayor a 50, y menor o igual a 100.
    • Un producto con monto menor a 100.

📘

Durante el proceso de integración, contarás con un ingeniero de ventas u operación técnica dedicado para realizar las pruebas en los entornos de sandbox y producción.

Requisitos en producción

Necesitas las siguientes credenciales para completar la integración en producción con Clearsale:

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

📘

Si tienes un KAM de tu motor antifraude, te recomendamos informarlo para agilizar el proceso.

Integra Clearsale

Inicia tu integración con Clearsale completando una certificación con DEUNA en el ambiente de prueba y luego repitiendo el proceso en el ambiente de producción.

Podrás utilizar Clearsale de manera centralizada en DEUNA.

1. Envia un correo a Clearsale para activar DEUNA

Envía un correo a Clearsale indicando que activarás DEUNA, para activar Clearsale con pre-autorización

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 habilitarán la configuración en producción, una vez enviadas las evidencias de transacciones de prueba.

2. Obtener credenciales de prueba

Accede al portal Clearsale de pruebas con la información proporcionada por Clearsale.

  1. En el dashboard, selecciona los tres puntos y haz clic en Settings.

  1. Copia los siguientes datos datos:
    • API Key
    • Client Id
    • Client secret

3. Configura el ambiente de pruebas DEUNA

Activar Clearsale con Pre-Autorización en el Admin de pruebas staging.

  1. En el Admin de DEUNA, ve a Conexiones.
  2. Busca Clearsale y haz click en Conectar.

  1. Ingresa las credenciales de Clearsale en en la pantalla:
    • Ingresa test en Environment (test, live).
    • Ingresa, tu Client secret de Clearsale en Client secret.
    • Ingresa tu id de Clearsale en Client Id.
    • Ingresa tu APi key de Clearsale en API key.
  2. Haz click en Conectar.

👍

Al finalizar la configuración verás un mensaje de éxito.

4. Prueba la integración

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

5. Envia evidencia de 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.

6. Repite el proceso en producción

Comienza el proceso de certificación de Clearsale y DEUNA en el ambiente de producción.

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

  • Clearsale: https://app.clear.sale/
  • DEUNA: https://admin.deuna.com/

7. Realizar transacciones de prueba 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.

🚧

Debes tener disponible una tarjeta para realizar las pruebas productivas.

8. Envia evidencias de pruebas productivas a Clearsle

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

9. Activar la revisión manual 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