Clearsale
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.
- En el dashboard, selecciona los tres puntos y haz clic en Settings.
- 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.
- En el Admin de DEUNA, ve a Conexiones.
- Busca Clearsale y haz click en Conectar.
- 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.
- 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:
# | 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
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
Updated about 10 hours ago