curl -X POST 'https://verification.didit.me/v3/businesses/create/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"vendor_data": "company-456", "legal_name": "New Corp Ltd", "country_code": "US"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.businesses.create(
vendor_data="company-456",
legal_name="New Corp Ltd",
country_code="US",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.businesses.create({
vendor_data: "company-456",
legal_name: "New Corp Ltd",
country_code: "US",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Businesses.Create(ctx, didit.BusinessesCreateParams{
VendorData: didit.String("company-456"),
LegalName: didit.String("New Corp Ltd"),
CountryCode: didit.String("US"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BusinessesCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.businesses().create(BusinessesCreateParams.builder()
.vendorData("company-456")
.legalName("New Corp Ltd")
.countryCode("US")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->businesses->create([
'vendor_data' => 'company-456',
'legal_name' => 'New Corp Ltd',
'country_code' => 'US',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.businesses.create(
vendor_data: "company-456",
legal_name: "New Corp Ltd",
country_code: "US"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Businesses.CreateAsync(new BusinessesCreateParams
{
VendorData = "company-456",
LegalName = "New Corp Ltd",
CountryCode = "US",
});
Console.WriteLine(JsonSerializer.Serialize(result));企業作成API:ベンダーKYBエンティティの登録
KYBセッションの実行前にDiditの企業(KYB)エンティティを事前登録します。外部データベースからの一括オンボーディングや取引モニタリング用の登録に利用できます。
curl -X POST 'https://verification.didit.me/v3/businesses/create/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"vendor_data": "company-456", "legal_name": "New Corp Ltd", "country_code": "US"}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.businesses.create(
vendor_data="company-456",
legal_name="New Corp Ltd",
country_code="US",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.businesses.create({
vendor_data: "company-456",
legal_name: "New Corp Ltd",
country_code: "US",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Businesses.Create(ctx, didit.BusinessesCreateParams{
VendorData: didit.String("company-456"),
LegalName: didit.String("New Corp Ltd"),
CountryCode: didit.String("US"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BusinessesCreateParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.businesses().create(BusinessesCreateParams.builder()
.vendorData("company-456")
.legalName("New Corp Ltd")
.countryCode("US")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->businesses->create([
'vendor_data' => 'company-456',
'legal_name' => 'New Corp Ltd',
'country_code' => 'US',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.businesses.create(
vendor_data: "company-456",
legal_name: "New Corp Ltd",
country_code: "US"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Businesses.CreateAsync(new BusinessesCreateParams
{
VendorData = "company-456",
LegalName = "New Corp Ltd",
CountryCode = "US",
});
Console.WriteLine(JsonSerializer.Serialize(result));概要
法人確認 (KYB) セッションを実行する前に、法人エンティティを明示的に作成します。使用するケース
- 最初の法人確認 (KYB) セッションの前に、メタデータを事前登録する場合(パートナー、レベル、社内識別子など)。
- 既存の企業一覧を保有した状態で、別のKYBベンダーから移行する場合。
- 取引のみの登録。オフラインのプロセスで確認済みの企業について取引を送信する場合。
注意事項
vendor_dataは必須で、アプリケーションごとに一意である必要があります。重複すると競合エラーが返されます。更新するにはPATCH /v3/businesses/{vendor_data}/を使用してください。- 登記由来のフィールド(
legal_name、registration_number、country_code)は事前登録できますが、最初に承認済みとなった法人確認 (KYB) セッションの登記データによって上書きされます。 country_codeがアプリケーションの危険国リストに該当する場合、企業はBLOCKEDステータスで作成されます。business.data.updatedを発行します。
権限
役割にcreate:businessesが付与されている必要があります。
関連情報
承認
お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys
ボディ
この企業に対するお客様独自の識別子です(自由形式の文字列で、UUIDではありません)。任意ですが、指定を強く推奨します。指定する場合は、アプリケーション内の削除されていない企業の間で一意である必要があり、送信されたとおりに完全一致で照合されます。
コンソールに表示されるわかりやすい表示名(UI表示ではlegal_nameより優先されます)。
255企業の正式な法人名。
255法人の登記番号または設立番号。
100設立国(ISO 3166-1 alpha-2、例: GB、US)。
10初期のライフサイクルステータス。デフォルトはACTIVEです。
ACTIVE, FLAGGED, BLOCKED 企業に付与する任意のJSONオブジェクト。デフォルトは{}です。
レスポンス
企業を作成しました。企業の完全なレコードが返されます(Get Businessと同じ形式)。
企業の完全な詳細。BusinessListItemにmetadataとupdated_atを追加したものです。
この企業に対するDiditの安定した内部UUIDです。
この企業に対するお客様独自の識別子です(セッション作成時に渡されたもの)。ベンダー識別子が指定されなかった場合はnullになることがあります。
お客様が設定したカスタム表示名
登記簿または手動入力による正式な法人名
会社の登記番号または設立番号
設立国(ISO 3166-1 alpha-2、例: GB、US)。
利用可能な最適な名前:display_nameが設定されていればそれを、設定されていなければlegal_nameを使用
企業レコードのライフサイクルステータス(セッションのステータスではありません)。ACTIVEがデフォルトで、FLAGGEDは手動での確認対象としてマークし、BLOCKEDはこのvendor_dataでの新規セッションを禁止します。
ACTIVE, FLAGGED, BLOCKED この企業の認証セッションの総数
承認済みセッションの数
却下されたセッションの数
レビュー中のセッション数
この企業のすべてのKYBセッションを通じた、機能ごとの集計ステータスです。現在のキーはKYB(登記上の企業チェックのステータス)のみです。取り得る値はApproved、Declined、In Review、Not Finished、Resub Requestedです。
featuresと同じデータを、{feature, status}オブジェクトの順序付き配列で表したもの。
Show child attributes
Show child attributes
直近のセッションの日時
最初のセッションの日時
直近のアクティビティ(ステータス変更、セッション更新など)の日時
この企業に割り当てられたタグ
Show child attributes
Show child attributes
この企業に付加したカスタムメタデータJSON。デフォルトは{}です。