Aller au contenu principal
Sur cette page

À propos de Koin#

Koin est une prévention du risque de crédit et de la fraude pour la BNPL brésilienne.

Koin est un pionnier brésilien de la fintech et un fournisseur leader de solutions Buy Now, Pay Later (BNPL) en Amérique latine, particulièrement célèbre pour ses produits « Boleto Parcelado » et « PIX Parcelado » (installation).

Fonctionnalités

  • Évaluation à double menace : Évaluer une transaction non seulement pour fraude d'identité, mais aussi pour la solvabilité du consommateur et la probabilité de défaut.
  • 100 % de la charge de responsabilité Pour les transactions traitées par les modes de paiement alternatifs de Koin, ils assument le risque de crédit et de fraude, vous garantissant ainsi un paiement même si le client fait défaut ou commet une fraude.
  • Données sur l'inclusion financière : Utilise d'autres sources de données pour marquer les consommateurs brésiliens non bancaires ou sous-bancaires qui pourraient manquer d'historiques de crédit traditionnels mais qui sont des acheteurs légitimes.
  • Installations locales sans soudure : Permet des offres d'acompte sans risque via Boleto ou PIX sans que la limite de la carte de crédit du client soit redressée.

Comment ça marche avec notre moteur d'orchestration

Comme Koin décide de façon définitive si elle financera la transaction, son API fournit des réponses claires (approuvées, en attente/réexamen, refusées).

Notre moteur d'orchestration cartographie un "Approuvé" directement à notre Faible risque niveau (procéder avec la capture de paiement Koin), cartes "Pending" à Risque moyen (en tenant l'état de commande pendant que Koin finalise les vérifications de crédit), et map "Dénié" à Risque élevé (blocage du paiement Koin, mais vous permettant de faire un retour/route vers un autre mode de paiement comme une carte de crédit standard via Adyen).

Niveau de risque

Le tableau ci-dessous indique comment les réponses brutes et les cotes de risque de chaque fournisseur pris en charge sont cartographiées selon ces niveaux normalisés, ainsi que les actions de routage par défaut déclenchées par chaque niveau. Gardez à l'esprit que bien que ces configurations représentent nos configurations standard, vous avez le contrôle total de personnaliser ce qui déclenche chaque niveau de risque pour parfaitement s'aligner avec l'appétit de risque unique de votre entreprise.

Koin évalue simultanément le risque de fraude et de crédit. Leurs réponses dictent s'ils assumeront la responsabilité du paiement d'acomptes provisionnels.

Réponse brute du fournisseur (exemple)Notre niveau de risque normaliséStratégie de routage par défaut
Statut : Approved🟢 FAIBLE RISQUETraitez directement via la passerelle préférée (par exemple, Adyen)
Statut : Pending (Crédits/Vérifications)🟡 RISQUE MOYENTenir l'état de transaction jusqu'à la mise à jour et/ou le trigger final du webhook 3D Secure (3DS)
Statut : Denied🔴 RISQUE ÉLEVÉRefuser la transaction OU Acheminer vers une passerelle spécialisée à haut risque

Exigences#

Avant de configurer Koin dans l'Admin DEUNA, vous devez avoir un compte marchand Koin actif. Pendant l'embarquement, Koin fournit les identifiants pour votre intégration.

Recueillir les valeurs suivantes de votre gestionnaire d'intégration Koin ou de vos documents d'embarquement :

  • Org ID: Votre identifiant unique à 10 chiffres pour votre compte marchand.
  • Clé privée : Ta clé privée.
  • Code de magasin
  • Type de marchandises

Étapes de configuration#

Connecter Koin est une configuration unique dans l'administration DEUNA.

Créer la connexion

  1. Connectez-vous à votre portail d'administration.

  2. Aller à Connexions.

  3. Rechercher Koin et cliquez Se connecter.

Exemple interactifUtilise des données fictives et n’effectue aucune requête API.
Production
Paiements

Connexions

Découvrez et gérez les intégrations de paiement, de portefeuille et antifraude.

Acme LATAM · Production
5 connexions fictivesMis à jour à l’instant
ConnexionsTypeStatutAction
AdyenPasserelle de paiementConnectée
WorldpayPasserelle de paiementConnectée
PayPalMoyen de paiementConnectée
Mercado PagoMoyen de paiementNon connectée
RiskifiedMoteur antifraudeNon connectée
  1. Un formulaire apparaîtra. Entrez les renseignements et les références suivants :

    Nom de créanceValeurTapez
    Org IDProvided by KoinObligatoire
    Clé privéeProvided by KoinObligatoire
    Environnement (essai, vie) *"test" pour Sandbox et "live" pour productionObligatoire
    Code pays (2 caractères) *Code de pays à 2 chiffres (par exemple "MX"Obligatoire
    Type de marchandises (fourni par Koin) *Fourni par Koin, utiliser autrement "ecommerce" ou "aérien"Obligatoire
    Catégorie de marchandises (MCC, 4 chiffres) *Code de catégorie de marchandises (par exemple "3676")Obligatoire
    Nom commercial *Nom de la société MerchantObligatoire
    Mode d'écoute (vrai ou faux) *Faux par défautObligatoire
    Code de stockage *Provided by KoinObligatoire
    Magasiner la latitude *Latitude du magasin. Par défaut "0"Facultatif
    Entreposer la longitude *Longitude du magasin. Par défaut "0"Facultatif
  2. Cliquez Enregistrer.

Mettre en place l'environnement de bac à sable dans DEUNA

  1. Ouvrir la Administrateur DEUNA et permettre Mode d'essai.
  2. Confirmer que la connexion Koin utilise la test environment.
  3. Si vous utilisez l'examen post-autorisation, demandez à votre gestionnaire de compte technique DEUNA d'activer l'examen manuel et le suivi automatique pour le magasin.

Configurer Koin comme un fournisseur antifraude dans DEUNA

Configurer Koin comme un fournisseur antifraude utilisant des références de test :

  1. Aller à Connexions et ouvre Koin.
  2. Entrez les identifiants de test Koin et sélectionnez le test environment.
  3. Aller à Stratégies de paiement et ajouter Koin à l'étape de préautorisation ou de postautorisation requise.
  4. Activer la stratégie après validation de la commande du fournisseur et de la manipulation à risque moyen.
Exemple interactifUtilise des données fictives et n’effectue aucune requête API.
Production
Paiements

Stratégies de paiement

Configurez le traitement par défaut et les règles de chaque flux de paiement.

Acme LATAM · Production

Traitement par défaut

Configurez le traitement par défaut et les règles de chaque flux de paiement.

RègleRoutageStatutAction
Traitement par défautAdyen → WorldpayActive

Règles spécifiques

Configurez le traitement par défaut et les règles de chaque flux de paiement.

1 règle fictiveProcesseurs de paiement
PrioritéRègleConditionsRoutageStatut
1Commandes de valeur élevéeMontant supérieur à 100 USDAdyen → WorldpayActive

5. Configurer les empreintes digitales de l'appareil

  1. Lors de la connexion à Deuna via le lien de paiement Widget et de paiement, suivez ceci guide.

  2. Pour vous connecter à Deuna par API directe, suivez ceci guide.

  3. Pour chaque connexion, vous devez ajouter Koin dans l'objet fournisseurs avec les paramètres suivants:

    JavaScript
    	KOIN: { 
    		orgId: '21xx031605'
    	}
  4. Le paramètre à configurer est orgId, qui fait partie des lettres de connexion.

  5. Pour les connexions API, envoyez la sortie à DEUNA dans le device_id champ de base64.

6. Essaie l ' intégration

Effectuez les transactions suivantes à l'aide des courriels :

RésultatBilling_address.email
Prouvez automatiquementautoaccept@deuna.com
Défaut automatiqueautoreject@deuna.com
Async Approuvermanualaccept@deuna.com
Async Denymanualreject@deuna.com
3DSauto_inprogress_3ds2_autoaccept@deuna.com

Ouvrez l'ordre résultant dans l'Admin et vérifiez la décision de fraude, le statut de paiement, et l'historique de l'opération. Les décisions de préautorisation devraient être disponibles avant le traitement des paiements; les décisions de postautorisation et de révision manuelle peuvent être prises de façon asynchrone.

Exemple interactifUtilise des données fictives et n’effectue aucune requête API.
Production
Paiements

Commandes

Trouvez un paiement puis ouvrez son contexte opérationnel.

Acme LATAM · Production
4 commandes fictivesMis à jour à l’instant
ID de commandeCrééeClientProcesseurMontantStatut
1 oct., 14:32sofia@example.comWorldpay128,40 $USApprouvés
1 oct., 14:18diego@example.comAdyen82,00 $USEn attente
1 oct., 13:54ana@example.comStripe246,90 $USRefusé
1 oct., 13:41marco@example.comWorldpay54,25 $USApprouvés

7. Déployer Koin à la production

Mettre en place l'environnement de production:

  1. - Oui.
    1. Accédez au tableau de bord de production en production : Demandez aux Koin les références requises
    2. Connectez-vous au tableau de bord pour configurer le compte
  2. - Oui. Configurer le marchand pour la production dans l'administration
    1. Désélectionner le mode d'essai
    2. Configurer Koin en tant que fournisseur antifraude en utilisant les identifiants de production, paramétrer live ou production en tant qu ' environnement
    3. Configurez les passerelles de paiement et établissez une stratégie de paiement.