moneda
En esta página
Acerca de Koin#
Koin es un sistema de prevención de fraude y riesgo crediticio para el BNPL brasileño.
Koin es una fintech brasileña pionera y un proveedor líder de soluciones Compre Ahora, Pague Después (BNPL) en América Latina, particularmente famosa por sus productos "Boleto Parcelado" y "PIX Parcelado".
Capacidades
- Evaluación de doble amenaza: Evalúa una transacción no sólo para detectar fraude de identidad, sino también para determinar la solvencia crediticia del consumidor y la probabilidad de incumplimiento.
- Cambio de responsabilidad del 100%: Para las transacciones procesadas a través de los métodos de pago alternativos de Koin, asumen todo el riesgo de crédito y fraude, garantizando que usted reciba el pago incluso si el cliente incumple o comete fraude.
- Datos de inclusión financiera: Utiliza fuentes de datos alternativas para calificar a los consumidores brasileños no bancarizados o insuficientemente bancarizados que pueden carecer de historial crediticio tradicional pero que son compradores legítimos.
- Cuotas locales sin inconvenientes: Permite ofertas de pago a plazos sin riesgos a través de Boleto o PIX sin limitar el límite de la tarjeta de crédito del cliente.
Cómo funciona con nuestro motor de orquestación
Debido a que Koin toma una decisión financiera definitiva sobre si financiará la transacción, su API proporciona respuestas de estado claras (Aprobado, Pendiente/Revisión, Denegado).
Nuestro motor de orquestación asigna un "Aprobado" directamente a nuestro Bajo riesgo nivel (continuando con la captura de pago de Koin), asigna "Pendiente" a Riesgo medio (manteniendo el estado del pedido mientras Koin finaliza las verificaciones de crédito) y asigna "Denegado" a Alto riesgo (bloqueando el pago Koin, pero permitiéndole recurrir/enrutar a un método de pago diferente, como una tarjeta de crédito estándar a través de Adyen).
Niveles de riesgo
La siguiente tabla describe cómo las respuestas sin procesar y las puntuaciones de riesgo de cada proveedor admitido se asignan a estos niveles estandarizados, junto con las acciones de enrutamiento predeterminadas activadas por cada nivel. Tenga en cuenta que, si bien estas representan nuestras configuraciones estándar, usted tiene control total para personalizar lo que desencadena cada nivel de riesgo para que se alinee perfectamente con el apetito de riesgo único de su negocio.
Koin evalúa tanto el riesgo de fraude como el de crédito simultáneamente. Sus respuestas dictan si asumirán la responsabilidad del pago a plazos.
| Respuesta sin procesar del proveedor (ejemplo) | Nuestro nivel de riesgo estandarizado | Estrategia de enrutamiento predeterminada |
|---|---|---|
Estado: Approved | 🟢 BAJO RIESGO | Procese directamente a través de la puerta de enlace preferida (por ejemplo, Adyen) |
Estado: Pending (Verificación de crédito/fraude) | 🟡 RIESGO MEDIO | Mantener el estado de la transacción hasta la actualización final del webhook y/o el activador 3D seguro (3DS) |
Estado: Denied | 🔴 ALTO RIESGO | Denegar transacción O Enrutar a puerta de enlace especializada de alto riesgo |
Requisitos#
Antes de configurar Koin en el administrador de DEUNA, debe tener una cuenta de comerciante de Koin activa. Durante la incorporación, Koin proporciona las credenciales para su integración.
Reúna los siguientes valores de su administrador de integración de Koin o de los documentos de incorporación:
- Org ID: Su identificador único de 10 dígitos para su cuenta de comerciante.
- Clave Privada: Tu clave privada.
- Código de tienda
- Tipo de comerciante
Pasos de configuración#
La conexión de Koin es una configuración única en el administrador de DEUNA.
Crear la conexión
-
Inicie sesión en su portal de administración.
-
Vaya a Conexiones.
-
Busque Koin y haga clic Conectar.
Conexiones
Descubre y administra integraciones de pago, billeteras y antifraude.
| Conexiones | Tipo | Estado | Acción |
|---|---|---|---|
| Adyen | Pasarela de pago | Conectada | |
| Worldpay | Pasarela de pago | Conectada | |
| PayPal | Método de pago | Conectada | |
| Mercado Pago | Método de pago | Sin conectar | |
| Riskified | Motor antifraude | Sin conectar |
-
Aparecerá un formulario. Ingrese la siguiente información y credenciales:
Nombre de credencial Valor Tipo Org ID Provided by Koin Obligatorio Clave Privada Provided by Koin Obligatorio Entorno (prueba, en vivo) * "prueba" para Sandbox y "en vivo" para Producción Obligatorio Código de país (código de 2 caracteres) * Código de país de 2 dígitos (por ejemplo, "MX" Obligatorio Tipo de comerciante (proporcionado por Koin) * Proporcionado por Koin; de lo contrario, utilice "comercio electrónico" o "aerolínea" Obligatorio Categoría de comerciante (MCC, 4 dígitos) * Código de categoría de comerciante (por ejemplo, "3676") Obligatorio Nombre comercial * nombre del comerciante Obligatorio Modo de escucha (verdadero o falso) * Por defecto "falso" Obligatorio Código de tienda * Provided by Koin Obligatorio Almacenar Latitud * Latitud de la tienda. Predeterminado "0" Opcional Almacenar longitud * Longitud de la tienda. Predeterminado "0" Opcional -
Clic Guardar.
Configurar el entorno sandbox en DEUNA
- Abre el Administrador DEUNA y habilitar Modo de prueba.
- Confirme que la conexión Koin utiliza el
testenvironment. - Si utiliza la revisión posterior a la autorización, solicite a su gerente técnico de cuentas de DEUNA que habilite la revisión manual y el seguimiento automático de la tienda.
Configurar Koin como proveedor antifraude en DEUNA
Configure Koin como proveedor antifraude utilizando credenciales de prueba:
- Vaya a Conexiones y abre Koin.
- Ingrese las credenciales de prueba de Koin y seleccione el
testenvironment. - Vaya a Estrategias de pago y agregue Koin a la etapa de autorización previa o posterior requerida.
- Activar la estrategia luego de validar su orden de proveedor y manejo de riesgo medio.
Estrategias de pago
Configura el procesamiento predeterminado y las reglas para cada flujo de pago.
Procesamiento predeterminado
Configura el procesamiento predeterminado y las reglas para cada flujo de pago.
| Regla | Enrutamiento | Estado | Acción |
|---|---|---|---|
| Procesamiento predeterminado | Adyen → Worldpay | Activa |
Reglas específicas
Configura el procesamiento predeterminado y las reglas para cada flujo de pago.
| Prioridad | Regla | Condiciones | Enrutamiento | Estado |
|---|---|---|---|---|
| 1 | Órdenes de importe alto | Importe superior a USD 100 | Adyen → Worldpay | Activa |
5. Configurar la toma de huellas digitales del dispositivo
-
Cuando se conecte a Deuna a través del widget de pago y el enlace de pago, siga esto guía.
-
Cuando se conecte a Deuna mediante API directa, siga esto guía.
-
Para cualquiera de las conexiones, debes agregar Koin en el objeto de proveedores con los siguientes parámetros:
JavaScriptKOIN: { orgId: '21xx031605' } -
El parámetro a configurar es
orgId, que forma parte de las credenciales de conexión. -
Para conexiones API, envíe la salida a DEUNA en el
device_idcampo en base64.
6. Pruebe la integración
Realice las siguientes transacciones utilizando los correos electrónicos:
| Resultado | Billing_address.email |
|---|---|
| Aprobación automática | autoaccept@deuna.com |
| Denegación automática | autoreject@deuna.com |
| Aprobación asincrónica | manualaccept@deuna.com |
| Denegación asíncrona | manualreject@deuna.com |
| 3DS | auto_inprogress_3ds2_autoaccept@deuna.com |
Abra el pedido resultante en el Administrador y verifique la decisión de fraude, el estado del pago y el historial de operaciones. Las decisiones de autorización previa deben estar disponibles antes del procesamiento del pago; Las decisiones posteriores a la autorización y de revisión manual pueden completarse de forma asincrónica.
Órdenes
Busca un pago y abre su contexto operativo.
| ID de orden | Creada | Cliente | Procesador | Importe | Estado |
|---|---|---|---|---|---|
| 1 oct, 14:32 | sofia@example.com | Worldpay | 128,40 US$ | Aprobados | |
| 1 oct, 14:18 | diego@example.com | Adyen | 82,00 US$ | Pendiente | |
| 1 oct, 13:54 | ana@example.com | Stripe | 246,90 US$ | Rechazado | |
| 1 oct, 13:41 | marco@example.com | Worldpay | 54,25 US$ | Aprobados |
7. Implementar Koin en producción
Configure el entorno de producción:
- Moneda:
- Obtenga acceso al Panel de producción en producción: solicite a Koin las credenciales requeridas
- Inicie sesión en el panel para configurar la cuenta.
- DEUNA: Configurar el comerciante para Producción en el Admin
- Deseleccionar el modo de prueba
- Configure Koin como proveedor antifraude usando credenciales de producción, configurando
liveoproductioncomo medio ambiente - Configurar las pasarelas de pago y establecer una Estrategia de Pago.