メインコンテンツへスキップ
すべてのシステムが正常に動作しています変更履歴v1
ログイン

Koin

このページで

Koinについて#

Koinは、ブラジルのBNPL（Buy Now, Pay Later）における信用リスクと不正防止ソリューションです。

Koinは、ブラジルの先駆的なフィンテック企業であり、ラテンアメリカにおける「Buy Now, Pay Later (BNPL)」ソリューションの主要なプロバイダーであり、特に「Boleto Parcelado」および「PIX Parcelado」（分割払い）製品で知られています。

機能

  • デュアル・スレッド評価： 取引を、単に身元詐欺だけでなく、消費者の信用力およびデフォルトの可能性の両方に対して評価します。
  • 100%の責任移転： Koinの代替決済方法を通じて処理された取引については、顧客がデフォルトした場合や不正が発生した場合でも、Koinがクレジットおよび不正リスクを完全に負うことを保証します。
  • 金融包摂データ: 従来の信用履歴がないものの、合法的な購入者である可能性のある、未開拓または未開のブラジルの消費者のデータを活用します。
  • シームレスなローカル分割払い： 顧客のクレジットカード限度額を拘束することなく、BoletoまたはPIXを通じてリスクのない分割払いを提供します。

当社のオーケストレーションエンジンとの連携

Koinが取引の資金提供を決定するため、APIは明確なステータス応答（承認、保留/レビュー、拒否）を提供します。

当社のオーケストレーションエンジンは、「承認」を当社の 中リスク レベル（Koinによる支払い回収）に直接マッピングし、「保留」を 高リスク （Koinによる最終的な信用審査を待つ状態）にマッピングし、「拒否」を DEUNA は、設定されたリスクレベルに応じて、次のアクションを適用します。 （Koinによる支払い拒否、ただし、標準のクレジットカード（Adyen経由）へのフォールバック/ルーティングを可能）にマッピングします。

リスクレベル

以下の表は、各サポートされているプロバイダーからの生のレスポンスとリスクスコアが、これらの標準化されたレベルにどのようにマッピングされるか、および各レベルによってトリガーされるデフォルトのルーティングアクションを説明しています。これらの設定は当社の標準構成ですが、各リスクレベルをトリガーする内容を完全にカスタマイズし、ビジネス固有のリスク許容度に合わせることができます。

Koinは、不正および信用リスクを同時に評価します。その応答は、分割払いに対する責任を負うかどうかを決定します。

プロバイダーの生のレスポンス (例)当社の標準化されたリスクレベルデフォルトのルーティング戦略
ステータス： Approved🟢 低リスクお好みのゲートウェイ (例: Adyen) を通じて直接処理
ステータス： Pending （信用/不正チェック）🟡 中リスク最終的なwebhook更新および/またはトリガーまで取引の状態を保持 3D Secure (3DS)
ステータス： Denied🔴 高リスクトランザクションを拒否するか、専門のハイリスクゲートウェイにルーティング

要件#

DEUNA AdminでKoinを設定する前に、アクティブなKoinの商社アカウントが必要です。オンボーディング中に、Koinは統合用の認証情報を提供します。

Koinとの統合マネージャーまたはオンボーディングドキュメントから、以下の値を収集してください：

  • Org ID: 商社アカウントの10桁の固有識別子。
  • プライベートキー: あなたのプライベートキー。
  • Almacenar el código
  • Merchant Type

設定手順#

Koinとの接続は、DEUNAの管理画面で一度設定するだけです。

接続を作成

  1. 管理ポータルにログインしてください。

  2. [Go to] 接続.

  3. Koinを検索し、クリック Connect.

インタラクティブな例サンプルデータを使用し、APIリクエストは行いません。
本番環境
決済

接続

決済、ウォレット、および不正検知の統合を発見および管理します。

Acme LATAM · 本番環境
5 サンプル接続直前に更新
接続種類ステータスアクション
Adyen決済ゲートウェイ接続済み
Worldpay決済ゲートウェイ接続済み
PayPal決済方法接続済み
Mercado Pago決済方法接続されていない
Riskified不正検知エンジン接続されていない

  1. フォームが表示されます。 以下の情報と認証情報を入力してください。

    Credential nameValueType
    Org IDProvided by Koin必須
    ファイル。Provided by Koin必須
    環境(テスト、ライブ) *「test」はSandbox用、「live」はProduction用必須
    カントリーコード(2文字コード) *2桁の国コード（例：「MX」必須
    Merchant Type (Koinによって提供) *Koinによって提供、または「ecommerce」または「airline」を使用必須
    商社カテゴリ（MCC、4桁）*Merchant category code (例: "3676")必須
    Commercial Name *商人の名前必須
    リスナーモード (true または false) *デフォルトは「false」必須
    Store Code *Provided by Koin必須
    Store Latitude *店舗の緯度。デフォルトは「0」任意
    Store Longitude *店舗の経度。デフォルトは「0」任意

  2. クリック 保存.

DEUNA でサンドボックス環境を設定します。

  1. 開く 使用する APM の評価用の不正検知プロバイダーを選択および設定します (例: Cybersource または Riskified)。 および、 Modo de prueba.
  2. Koin接続が、 test environment.
  3. もし、後承認レビューを使用する場合は、DEUNAのテクニカルアカウントマネージャーに、ストアに対して手動レビューと自動フォローアップを有効化するように依頼してください。

KoinをDEUNAの不正防止プロバイダーとして設定

Koinを不正防止プロバイダーとして、テスト用の資格情報を使用して設定してください：

  1. [Go to] 接続 および Koin を有効化します。
  2. Koin のテスト認証情報を入力し、「Koin」を選択します。 test environment.
  3. [Go to] 決済戦略 および、Koin を必要な事前承認または事後承認の段階に追加します。
  4. 戦略を有効化するには、プロバイダーの注文と中程度のリスクの取り扱いを確認してください。
インタラクティブな例サンプルデータを使用し、APIリクエストは行いません。
本番環境
決済

決済方法

各決済フローのデフォルト処理とルールを設定します。

Acme LATAM · 本番環境

デフォルト処理

各決済フローのデフォルト処理とルールを設定します。

ルールルーティングステータスアクション
デフォルト処理Adyen → Worldpayアクティブ

特定のルール

各決済フローのデフォルト処理とルールを設定します。

1 サンプルルール決済プロセッサ
優先度ルール条件ルーティングステータス
1高額注文100ドル以上の金額Adyen → Worldpayアクティブ

5. デバイスフィンガープリンティングの設定

  1. Payment Widget および Payment Link を使用して Deuna に接続する場合、以下の手順に従ってください。 ガイド.

  2. Deunaへの直接的なAPI接続を行う場合は、以下の手順に従ってください。 ガイド.

  3. どちらの場合でも、プロバイダーオブジェクトに「Koin」パラメータを追加する必要があります。以下のパラメータが必要です。

    JavaScript
    	KOIN: { 
		orgId: '21xx031605'
	}

  4. 設定するパラメータは orgIdであり、これは接続認証情報の一部です。

  5. API接続の場合、結果を device_id フィールドにBase64形式で送信してください。

6. 統合のテスト

以下のトランザクションをメールアドレスを使用して実行してください。

結果Billing_address.email
自動承認autoaccept@deuna.com
自動拒否autoreject@deuna.com
非同期承認manualaccept@deuna.com
非同期拒否manualreject@deuna.com
3DSauto_inprogress_3ds2_autoaccept@deuna.com

結果として生成された注文を管理画面で開き、不正判断、支払いステータス、および操作履歴を確認してください。事前承認の決定は、支払い処理の前に利用可能である必要があります。事後承認および手動レビューの決定は、非同期で完了する場合があります。

インタラクティブな例サンプルデータを使用し、APIリクエストは行いません。
本番環境
決済

注文

決済を検索し、その運用コンテキストを開きます。

Acme LATAM · 本番環境
4 サンプル注文直前に更新
注文ID作成顧客プロセッサ金額ステータス
10月1日 14:32sofia@example.comWorldpay$128.40承認
10月1日 14:18diego@example.comAdyen$82.00保留中
10月1日 13:54ana@example.comStripe$246.90拒否
10月1日 13:41marco@example.comWorldpay$54.25承認

7. KoinのProduction環境への展開

本番環境を設定します:

  1. Koin:
    1. Production環境でProductionダッシュボードへのアクセス: Koinに必要な認証情報を取得
    2. ダッシュボードにログインしてアカウントを設定
  2. DEUNA: 管理画面でProduction環境用の商人を設定
    1. テストモードを無効化
    2. Koinを不正防止プロバイダーとして、Production環境で設定します。 live または production 環境設定を「Production」に設定
    3. 支払いゲートウェイを設定し、支払い戦略を確立します。