Saltar al contenido principal
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 estandarizadoEstrategia de enrutamiento predeterminada
Estado: Approved🟢 BAJO RIESGOProcese directamente a través de la puerta de enlace preferida (por ejemplo, Adyen)
Estado: Pending (Verificación de crédito/fraude)🟡 RIESGO MEDIOMantener el estado de la transacción hasta la actualización final del webhook y/o el activador 3D seguro (3DS)
Estado: Denied🔴 ALTO RIESGODenegar 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

  1. Inicie sesión en su portal de administración.

  2. Vaya a Conexiones.

  3. Busque Koin y haga clic Conectar.

Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.
Producción
Pagos

Conexiones

Descubre y administra integraciones de pago, billeteras y antifraude.

Acme LATAM · Producción
5 conexiones de ejemploActualizado ahora
ConexionesTipoEstadoAcción
AdyenPasarela de pagoConectada
WorldpayPasarela de pagoConectada
PayPalMétodo de pagoConectada
Mercado PagoMétodo de pagoSin conectar
RiskifiedMotor antifraudeSin conectar
  1. Aparecerá un formulario. Ingrese la siguiente información y credenciales:

    Nombre de credencialValorTipo
    Org IDProvided by KoinObligatorio
    Clave PrivadaProvided by KoinObligatorio
    Entorno (prueba, en vivo) *"prueba" para Sandbox y "en vivo" para ProducciónObligatorio
    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 comercianteObligatorio
    Modo de escucha (verdadero o falso) *Por defecto "falso"Obligatorio
    Código de tienda *Provided by KoinObligatorio
    Almacenar Latitud *Latitud de la tienda. Predeterminado "0"Opcional
    Almacenar longitud *Longitud de la tienda. Predeterminado "0"Opcional
  2. Clic Guardar.

Configurar el entorno sandbox en DEUNA

  1. Abre el Administrador DEUNA y habilitar Modo de prueba.
  2. Confirme que la conexión Koin utiliza el test environment.
  3. 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:

  1. Vaya a Conexiones y abre Koin.
  2. Ingrese las credenciales de prueba de Koin y seleccione el test environment.
  3. Vaya a Estrategias de pago y agregue Koin a la etapa de autorización previa o posterior requerida.
  4. Activar la estrategia luego de validar su orden de proveedor y manejo de riesgo medio.
Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.
Producción
Pagos

Estrategias de pago

Configura el procesamiento predeterminado y las reglas para cada flujo de pago.

Acme LATAM · Producción

Procesamiento predeterminado

Configura el procesamiento predeterminado y las reglas para cada flujo de pago.

ReglaEnrutamientoEstadoAcción
Procesamiento predeterminadoAdyen → WorldpayActiva

Reglas específicas

Configura el procesamiento predeterminado y las reglas para cada flujo de pago.

1 regla de ejemploProcesadores de pago
PrioridadReglaCondicionesEnrutamientoEstado
1Órdenes de importe altoImporte superior a USD 100Adyen → WorldpayActiva

5. Configurar la toma de huellas digitales del dispositivo

  1. Cuando se conecte a Deuna a través del widget de pago y el enlace de pago, siga esto guía.

  2. Cuando se conecte a Deuna mediante API directa, siga esto guía.

  3. Para cualquiera de las conexiones, debes agregar Koin en el objeto de proveedores con los siguientes parámetros:

    JavaScript
    	KOIN: { 
    		orgId: '21xx031605'
    	}
  4. El parámetro a configurar es orgId, que forma parte de las credenciales de conexión.

  5. Para conexiones API, envíe la salida a DEUNA en el device_id campo en base64.

6. Pruebe la integración

Realice las siguientes transacciones utilizando los correos electrónicos:

ResultadoBilling_address.email
Aprobación automáticaautoaccept@deuna.com
Denegación automáticaautoreject@deuna.com
Aprobación asincrónicamanualaccept@deuna.com
Denegación asíncronamanualreject@deuna.com
3DSauto_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.

Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.
Producción
Pagos

Órdenes

Busca un pago y abre su contexto operativo.

Acme LATAM · Producción
4 órdenes de ejemploActualizado ahora
ID de ordenCreadaClienteProcesadorImporteEstado
1 oct, 14:32sofia@example.comWorldpay128,40 US$Aprobados
1 oct, 14:18diego@example.comAdyen82,00 US$Pendiente
1 oct, 13:54ana@example.comStripe246,90 US$Rechazado
1 oct, 13:41marco@example.comWorldpay54,25 US$Aprobados

7. Implementar Koin en producción

Configure el entorno de producción:

  1. Moneda:
    1. Obtenga acceso al Panel de producción en producción: solicite a Koin las credenciales requeridas
    2. Inicie sesión en el panel para configurar la cuenta.
  2. DEUNA: Configurar el comerciante para Producción en el Admin
    1. Deseleccionar el modo de prueba
    2. Configure Koin como proveedor antifraude usando credenciales de producción, configurando live o production como medio ambiente
    3. Configurar las pasarelas de pago y establecer una Estrategia de Pago.