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
- Accede a Clearsale de pruebas en https://app-sandbox.clear.sale/ con la información proporcionada por 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
- Accede a https://admin.stg.deuna.io/ e ingresa las credenciales proporcionadas por el equipo de DEUNA.
- 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:
# | Caso | Regla | Caso de uso | Criterio de aceptación |
---|---|---|---|---|
1 | Aprobación automática | Transacción con DEUNA con monto total ≤ 50 | 1. 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. |
2 | Reprobación automática | Transacción con DEUNA > 50 monto total ≤ 100 | 1. 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. |
3 | Análisis Manual - Aprobado Manualmente | Transacción con DEUNA por monto total > 100 | 1. 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. |
4 | Análisis Manual - Declinado Manualmente | Transacción con DEUNA por monto total > 100 | 1. 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. |
5 | Análisis Manual - Mantenerlo en estado Analyzing | Transacción con DEUNA por monto total > 100 | 1. 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:
- Clearsale: https://app.clear.sale/
- DEUNA: https://admin.deuna.com/
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
Updated 5 months ago