Passa al contenuto principale
In questa pagina

Informazioni su Koin#

Koin è un rischio di credito e prevenzione delle frodi per BNPL brasiliano.

Koin è un pinnaio brasiliano pionieristico e fornitore leader di soluzioni Buy Now, Pay Later (BNPL) in America Latina, particolarmente famoso per i suoi prodotti "Boleto Parcelado" e "PIX Parcelado".

Funzionalità

  • Valutazione a doppia trentina: Valuta una transazione non solo per frode di identità, ma anche per la stima di credito del consumatore e la probabilità di default.
  • 100% di responsabilità Shift: Per le transazioni elaborate attraverso i metodi di pagamento alternativi di Koin, assumono il pieno rischio di credito e frode, garantendo di essere pagato anche se il cliente non ha commesso alcuna frode.
  • Dati di inclusione finanziaria: Utilizza fonti di dati alternativi per segnare consumatori brasiliani non argini o sottobanco che potrebbero mancare di storie di credito tradizionali ma sono acquirenti legittimi.
  • Installazioni locali senza cuciture: Consente di installare senza rischi offerte tramite Boleto o PIX senza fissare il limite della carta di credito del cliente.

Come funziona con il nostro motore di orchestrazione

Poiché Koin prende una decisione finanziaria definitiva sul fatto che essi finanziano la transazione, la loro API fornisce risposte chiare allo stato (Approved, Pending/Review, Denied).

Il nostro motore di orchestrazione mappa un "Approved" direttamente al nostro Rischio basso tier (procedere con la cattura di pagamento Koin), mappe "Pending" a Rischio medio (tenendo lo stato dell'ordine mentre Koin finalizza i controlli di credito), e le mappe "Denied" a Rischio alto (bloccando il pagamento Koin, ma permettendo di fallback / reindirizzare ad un metodo di pagamento diverso come una carta di credito standard via Adyen).

Tire di rischio

La tabella seguente delinea come le risposte grezze e i punteggi di rischio di ciascun provider supportato sono mappati a questi livelli standardizzati, insieme alle azioni di routing predefinite innescate da ogni livello. Tenete a mente che mentre queste rappresentano le nostre configurazioni standard, avete il pieno controllo per personalizzare ciò che innesca ogni livello di rischio per allineare perfettamente con l'appetito unico del rischio del vostro business.

Koin valuta sia il rischio di frode che di credito contemporaneamente. Le loro risposte dettano se assumeranno la responsabilità per il pagamento di rate.

Risposta cruda del fornitore (esempio)Il nostro livello di rischio standardizzatoStrategia di routing predefinita
Stato: Approved🟢 RISCHIO BASSOElaborare direttamente tramite gateway preferito (ad esempio, Adyen)
Stato: Pending (Credito/Consultazione della Frazione)🟡 RISCHIO MEDIUMTenere lo stato delle transazioni fino all'aggiornamento finale di webhook e/o Trigger 3D Secure (3DS)
Stato: Denied🔴 RISCHIO ALTADeny transazione O percorso per gateway ad alto rischio specializzato

Requisiti#

Prima di configurare Koin nell'Admin DEUNA, è necessario disporre di un account attivo di Koin. Durante l'installazione, Koin fornisce le credenziali per la tua integrazione.

Raccogli i seguenti valori dal tuo Koin integration manager o dai documenti di bordo:

  • Org ID: Il tuo unico identificativo a 10 cifre per il tuo account mercantile.
  • Chiave privata: La tua chiave privata.
  • Codice di memorizzazione
  • Tipo di merce

Passi di configurazione#

Collegare Koin è una configurazione di una volta nell'Admin DEUNA.

Creare la connessione

  1. Accedi al tuo portale Admin.

  2. Vai a Collegamenti.

  3. Cerca Koin e clicca Collegamento.

Esempio interattivoUsa dati di esempio e non effettua richieste API.
Produzione
Pagamenti

Connessioni

Scopri e gestisci le integrazioni di pagamento, wallet e antifrode.

Acme LATAM · Produzione
5 connessioni di esempioAggiornato ora
ConnessioniTipoStatoAzione
AdyenGateway di pagamentoConnessa
WorldpayGateway di pagamentoConnessa
PayPalMetodo di pagamentoConnessa
Mercado PagoMetodo di pagamentoNon connessa
RiskifiedMotore antifrodeNon connessa
  1. Verrà visualizzata una forma. Inserisci le seguenti informazioni e credenziali:

    Nome CredenzialeValoreTipo
    Org IDProvided by KoinObbligatorio
    Chiave privataProvided by KoinObbligatorio
    Ambiente (prova, live) *"test" per Sandbox e "live" per la produzioneObbligatorio
    Codice paese (2 codici di beneficenza) *Codice Paese a 2 cifre (ad esempio "MX"Obbligatorio
    Tipo di mercenari (fornito da Koin) *Fornito da Koin, altrimenti utilizzare "ecommerce" o "aeroline"Obbligatorio
    Categoria Merchant (MCC, 4 cifre) *Codice categoria Merchant (ad esempio "3676")Obbligatorio
    Nome commerciale *Nome di MerchantObbligatorio
    Modalità di ascolto (verità o falso) *"false" predefinitoObbligatorio
    Codice di deposito *Provided by KoinObbligatorio
    Luogo di conservazione *Latitudine del negozio. Predefinito "0"Facoltativo
    Negozio Longitudine *Longitudine del negozio. Predefinito "0"Facoltativo
  2. Cliccare su Salva.

Impostare l'ambiente sandbox in DEUNA

  1. Aprire DEUNA Admin e abilitare Modalità di prova.
  2. Confermare che la connessione Koin utilizza test environment.
  3. Se si utilizza la revisione post-autorizzazione, chiedere al proprio Direttore di Account Tecnico DEUNA di attivare la revisione manuale e il follow-up automatico per il negozio.

Configurare Koin come fornitore antifrode in DEUNA

Configurare Koin come provider antifrode utilizzando le credenziali di test:

  1. Vai a Collegamenti e aprire Koin.
  2. Inserisci le credenziali di prova Koin e seleziona le test environment.
  3. Vai a Strategie di pagamento e aggiungere Koin alla fase di pre-autorizzazione o post-autorizzazione richiesta.
  4. Attivare la strategia dopo aver convalidato l'ordine del fornitore e la gestione a medio rischio.
Esempio interattivoUsa dati di esempio e non effettua richieste API.
Produzione
Pagamenti

Strategie di pagamento

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

Acme LATAM · Produzione

Elaborazione predefinita

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

RegolaInstradamentoStatoAzione
Elaborazione predefinitaAdyen → WorldpayAttiva

Regole specifiche

Configura l’elaborazione predefinita e le regole per ogni flusso di pagamento.

1 regola di esempioProcessori di pagamento
PrioritàRegolaCondizioniInstradamentoStato
1Ordini di importo elevatoImporto superiore a 100 USDAdyen → WorldpayAttiva

5. Configurare l'impronta digitale del dispositivo

  1. Quando si collega a Deuna tramite il link di pagamento Widget e Payment guida.

  2. Quando si collega a Deuna tramite API diretta, segui questo guida.

  3. Per una connessione, è necessario aggiungere Koin nell'oggetto provider con i seguenti parametri:

    JavaScript
    	KOIN: { 
    		orgId: '21xx031605'
    	}
  4. Il parametro da configurare è orgId, che fa parte delle credenziali di connessione.

  5. Per le connessioni API, inviare l'output a DEUNA nel device_id campo in base64.

6. Testare l'integrazione

Effettuare le seguenti operazioni utilizzando le e-mail:

RisultatoBilling_address.email
Provetta automaticaautoaccept@deuna.com
Deny automaticoautoreject@deuna.com
Approvo asincianomanualaccept@deuna.com
Deny asincantesimomanualreject@deuna.com
3DSauto_inprogress_3ds2_autoaccept@deuna.com

Aprire l'ordine risultante nell'Amministratore e verificare la decisione di frode, lo stato di pagamento e la cronologia delle operazioni. Le decisioni di pre-autorizzazione devono essere disponibili prima dell'elaborazione dei pagamenti; le decisioni di post-autorizzazione e di revisione manuale possono completare in modo asincrono.

Esempio interattivoUsa dati di esempio e non effettua richieste API.
Produzione
Pagamenti

Ordini

Trova un pagamento e apri il suo contesto operativo.

Acme LATAM · Produzione
4 ordini di esempioAggiornato ora
ID ordineCreatoClienteProcessoreImportoStato
1 ott, 14:32sofia@example.comWorldpay128,40 USDApprovati
1 ott, 14:18diego@example.comAdyen82,00 USDIn sospeso
1 ott, 13:54ana@example.comStripe246,90 USDRifiutato
1 ott, 13:41marco@example.comWorldpay54,25 USDApprovati

7. Distribuire Koin alla produzione

Impostare l'ambiente di produzione:

  1. Koin:
    1. Ottieni l'accesso al Dashboard di produzione in produzione: Chiedi a Koin per le credenziali richieste
    2. Accedi alla dashboard per configurare l'account
  2. DEUNA: Configurare il commerciante per la produzione nell'Admin
    1. Modalità di prova non deselezionabile
    2. Configurare Koin come fornitore antifrode utilizzando le credenziali di produzione, impostando live o production come l'ambiente
    3. Configurare i gateway di pagamento e stabilire una strategia di pagamento.