アカウント保護スキーマ
この記事では、アプリケーション プログラミング インターフェイス (API) を使用してスキーマの概要を説明します。 詳細については、「 Dynamics 365 Fraud Protection リアルタイム API の概要を参照してください。
AccountCreation
AccountCreation API を使用すると、リスク評価のための新しいアカウント作成イベントの受信に関する情報とコンテキストを Microsoft Dynamics 365 Fraud Protection と共有できます。
| Object | 属性 | Type | 説明 |
|---|---|---|---|
| テナント ID | string | TenantId は、Azure ActiveDirectory テナントを表す GUID です。 | |
| Name | string | 値は AP です。AccountCreation。 | |
| バージョン | string | 値は 0.5 です。 | |
| MetaData | trackingId | string | AccountCreationId イベントの識別子。 |
| MetaData | SignupId | string | AccountCreationId イベントの識別子。 (この値は、 trackingId 属性の値と一致する可能性がありますが、 userId 属性とは異なります)。 |
| MetaData | assessmentType | string | イベントの評価の種類。 指定できる値は、 評価 および protectです。 値が指定されていない場合、既定値は protect です。 |
| MetaData | customerLocalDate | dateTime | 顧客のローカル タイム ゾーンでの AccountCreationId イベントの作成日。 形式は ISO 8601 です。 |
| MetaData | merchantTimeStamp | dateTime | イベントのタイム スタンプ。 |
| DeviceContext | DeviceContextId | string | 顧客のセッション ID。 この情報は、DFP デバイス フィンガープリント サービスによってマスターされます。 |
| DeviceContext | ipAddress | string | マーチャントが提供する顧客の IP アドレス。 |
| DeviceContext | provider | string | デバイス情報のプロバイダー。 指定できる値は、 DFPFingerprinting および Merchant です。 値が指定されていない場合、既定値は DFPFingerprinting です。 |
| DeviceContext | externalDeviceId | string | マーチャントによって提供およびマスタリングされた顧客のデバイス ID。 |
| DeviceContext | externalDeviceType | string | マーチャントによって提供およびマスタリングされた顧客のデバイス タイプ。 使用できる値は、 Mobile、 Computer、 MerchantHardware、 Tablet、および GameConsole です。 |
| User | userId | string | ユーザー識別子。 この情報はマーチャントから提供されます。 |
| ユーザー | userType | string | ユーザーのプロファイル タイプ。 指定できる値は、 Consumer、 Developer、 Seller、 Publisher、および Tenant です。 |
| User | UserName | string | マーチャント システムで一意であるユーザー指定のユーザー名。 |
| User | firstName | string | アカウントでユーザーが提供した名。 |
| User | lastName | string | アカウントでユーザーが提供した姓。 |
| User | CountryRegion | string | ユーザーの国またはリージョン。 値は、2 文字の ISO 国/地域コード (たとえば、 US) である必要があります。 |
| User | zipCode | string | ユーザーの郵便番号。 |
| User | timeZone | string | ユーザーのタイム ゾーンです。 |
| User | 言語 | string | ユーザーの言語と地域 (たとえば、 EN-US)。 |
| User | membershipId | string | ユーザーがすでにマーチャントの既存のメンバーシップを持っている場合は、メンバーシップ ID。 |
| User | isMembershipIdUserName | [bool] | membershipId 値をユーザー名として使用できるかどうかを示す True/False 値。 既定値は Falseです。 |
| スマートフォン | phoneType | enum | 電話番号の種類。 使用できる値は、 Primary と Alternative です。 既定値は Primary です。 |
| スマートフォン | phoneNumber | string | ユーザーの電話番号。 形式は、国/地域コードの後にハイフン (-) を付け、電話番号 (たとえば、米国の場合は +1-1234567890) にする必要があります。 |
| スマートフォン | isPhoneNumberValidated | [bool] | True/Falseユーザーが所有しているユーザー指定の電話番号が検証されているかどうかを示す値です。 |
| スマートフォン | phoneNumberValidatedDate | dateTime | ユーザーの電話番号の検証日。 形式は ISO 8601 です。 |
| スマートフォン | isPhoneUserName | [bool] | 電話番号をユーザー名として使用できるかどうかを示す True/False 値です。 既定値は Falseです。 |
| メール | emailType | enum | 電子メール アドレスの種類。 使用できる値は、 Primary と Alternative です。 |
| メール | emailValue | string | ユーザーの電子メール アドレスです。 この値は大文字と小文字を区別しません。 |
| メール | isEmailValidated | [bool] | True/False ユーザー指定の電子メール アドレスがユーザーの所有として検証されているかどうかを示す値です。 |
| メール | emailValidatedDate | dateTime | ユーザーの電子メール アドレスの検証日。 形式は ISO 8601 です。 |
| メール | isEmailUserName | [bool] | 電子メール アドレスをユーザー名として使用できるかどうかを示す True/False 値。 既定値は Falseです。 |
| SSOAuthenticationProvider | authenticationProvider | string | ユーザーのシングル サインオン (SSO) 認証プロバイダー (マーチャントの SSO 認証プロバイダーと異なる場合)。 使用できる値は、 MSA、 Facebook、 PSN、 MerchantAuth、および Google です。 |
| SSOAuthenticationProvider | displayName | string | SSO 認証プロバイダーのユーザーの表示名 (たとえば、Microsoft アカウント、Facebook、Google のユーザー名)。 |
| 番地 | addressType | enum | アドレスのタイプです。 使用できる値は、 Primary、 Billing、 Shipping、および Alternative です。 既定値は Primary です。 |
| 番地 | firstName | string | アドレスに関連付けられているユーザー指定の名。 |
| 番地 | lastName | string | アドレスに関連付けられているユーザー指定の姓。 |
| 番地 | phoneNumber | string | アドレスに関連付けられているユーザー指定の電話番号。 |
| 番地 | street1 | string | 住所に提供された最初の行。 |
| 番地 | street2 | string | 住所に提供された 2 番目の行。 (この値を空白にすることはできません。) |
| 番地 | street3 | string | 住所に提供された 3 番目の行。 (この値を空白にすることはできません。) |
| アドレス | city | string | 住所に提供された都市。 |
| 番地 | state | string | 住所に提供された都道府県。 |
| 番地 | 地域 | string | 住所に提供された地区。 |
| 番地 | zipCode | string | 住所に提供された郵便番号。 |
| 番地 | CountryRegion | string | 住所に提供された国/リージョン コード。 値は、2 文字の ISO 国/地域コード (たとえば、 US) である必要があります。 |
| PaymentInstrument | merchantPaymentInstrumentId | string | 支払い方法の ID。 この情報はマーチャントから提供されます。 |
| PaymentInstrument | type | enum | 支払いのタイプ。 指定できる値は、 CreditCard、 DirectDebit、 PayPal、 MobileBilling、 OnlineBankTransfer、 Invoice、 MerchantGiftCard、 MerchantWallet、 CashOnDelivery、 Paytm、 CCAvenue。 |
| PaymentInstrument | creationDate | DateTime | マーチャントのシステムでの支払い方法の最初のエントリの日付。 形式は ISO 8601 です。 |
| PaymentInstrument | updateDate | DateTime | マーチャントのシステムでの支払い方法の前回の更新の日付。 形式は ISO 8601 です。 |
| PaymentInstrument | state | string | マーチャントのシステムにおける支払い方法の現在の状態 (たとえば、 Active、 Blocked、 Expired)。 |
| PaymentInstrument | cardType | string | この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 指定できる値は、 Visa、 Mastercard、 Amex、 ACH、 SEPA、 UnionPay、 Inicis、 MobileBillingCarrier、 Discover、 AllPay、 JCB、 DiscoverDiners。 |
| PaymentInstrument | holderName | string | 支払い方法のユーザーの名前。 この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 |
| PaymentInstrument | bin | string | この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 |
| PaymentInstrument | expirationDate | string | マーチャントのシステムでの支払い方法の有効期限。 形式は ISO 8601 です。 この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 |
| PaymentInstrument | lastFourDigits | string | この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 |
| PaymentInstrument | メール | string | 支払い方法に関連付けられている電子メール アドレス。 この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | billingAgreementId | string | この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | payerId | string | この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | payerStatus | string | PayPal が支払人を認証したかどうかを示す値。 この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | addressStatus | string | PayPal が支払人の住所を認証したかどうかを示す値。 この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | imei | string | この属性は、 MobileBilling タイプの支払いにのみ使用されます。 |
| PaymentInstrument \ BillingAddress | addressType | enum | アドレスのタイプです。 使用できる値は、 Primary、 Billing、 Shipping、および Alternative です。 既定値は Billing です。 |
| PaymentInstrument \ BillingAddress | firstName | string | アドレスに関連付けられているユーザー指定の名。 |
| PaymentInstrument \ BillingAddress | lastName | string | アドレスに関連付けられているユーザー指定の姓。 |
| PaymentInstrument \ BillingAddress | phoneNumber | string | アドレスに関連付けられているユーザー指定の電話番号。 |
| PaymentInstrument \ BillingAddress | street1 | string | 住所に提供された最初の行。 |
| PaymentInstrument \ BillingAddress | street2 | string | 住所に提供された 2 番目の行。 (この値を空白にすることはできません。) |
| PaymentInstrument \ BillingAddress | street3 | string | 住所に提供された 3 番目の行。 (この値を空白にすることはできません。) |
| PaymentInstrument \ BillingAddress | city | string | 住所に提供された都市。 |
| PaymentInstrument \ BillingAddress | state | string | 住所に提供された都道府県。 |
| PaymentInstrument \ BillingAddress | 地域 | string | 住所に指定された地区 |
| PaymentInstrument \ BillingAddress | zipCode | string | 住所に提供された郵便番号。 |
| PaymentInstrument \ BillingAddress | CountryRegion | string | 住所に提供された国/リージョン コード。 値は、2 文字の ISO 国/地域コード (たとえば、 US) である必要があります。 |
| MarketingContext | campaignType | enum | マーケティング キャンペーン タイプ。 指定できる値は Direct、 Email、 Referral、 PaidSearch、 OrganicSearch、 Advertising、 SocialNetwork、 General Marketing、 Unknown、 Other。 |
| MarketingContext | trafficSource-referrer | string | このユーザーのソース (既知の場合)。 既存のユーザー参照元を介する場合は、参照元の MerchantUserId を提供します。 |
| MarketingContext | trafficSource-referralLink | string | このユーザーのソース (既知の場合)。 既存のユーザー参照元ではなく他のキャンペーン タイプを使用する場合は、ソース URL リンクを提供します。 |
| MarketingContext | trafficSource-referralSite | string | トラフィックのソース サイト。 使用できる値は、Facebook、Instagram、、Bing、Google、Pinterest、WhatsApp などです。 |
| MarketingContext | IncentiveType | enum | 新規ユーザーのインセンティブ タイプ。 指定できる値は、 None、 CashBack、 Discount、 FreeTrial、 BonusPoints、 Gift、 Unknown、 Other です。 |
| MarketingContext | incentiveOffer | string | 正確なインセンティブ オファー名。 たとえば、最初の注文で 5 ドルオフ、無料配送、5,000 ポイントです。 |
| MarketingContext | CampaignStartDate | 日付 | インセンティブ収集から始まるキャンペーンの日付。 |
| MarketingContext | CampaignExpireDate | 日付 | インセンティブ収集から始まるキャンペーン有効期限。 |
| MarketingContext | IncentiveQuantityLimit | string | マーチャントによって設定されたインセンティブ数量制限。 たとえば、ユーザー 1 人あたり 1 日あたり最大 3 つの 5,000 ポイントです。 |
AccountCreationStatus
AccountCreationStatus API を使用すると、アカウント作成イベントの状態に関する情報とコンテキストを Fraud Protection と共有できます。 このイベントは、データ インジェスト イベントのみです。
| Object | 属性 | Type | 説明 |
|---|---|---|---|
| テナント ID | string | TenantId は、Azure ActiveDirectory テナントを表す GUID です。 | |
| Name | string | 値は AP です。AccountCreation.Status。 | |
| バージョン | string | 値は 0.5 です。 | |
| MetaData | trackingID | string | SignupStatus イベントの識別子。 |
| MetaData | signupId | string | Signup イベントの識別子。 |
| MetaData | merchantTimeStamp | DateTime | イベントのタイム スタンプ。 |
| MetaData | userId | string | ユーザー識別子。 この情報はマーチャントから提供されます。 |
| StatusDetails | statusType | enum | 状態の種類: Approved、 Rejected、または Pending。 |
| StatusDetails | reasonType | enum | 理由の種類: 破棄、 challenge が失敗しました、 challenge が成功しました、 challenge の保留中、 失敗、、 ビューが渡されました、 ビュー保留中、または None。 既定値は None です。 |
| StatusDetails | challengeType | enum | レビューの状態の種類: SMS、 Email、 Phone、 Other、または None。 既定値は None です。 |
| StatusDetails | statusDate | DateTime | ステータスが適用された日時。 形式は ISO 8601 です。 |
AccountLogIn
AccountLogIn API を使用すると、リスク評価のための受信サインイン イベントに関する情報とコンテキストを Fraud Protection と共有できます。
| Object | 属性 | Type | 説明 |
|---|---|---|---|
| 氏名 | string | 値は AP です。AccountLogin。 | |
| バージョン | string | 値は 0.5 です。 | |
| MetaData | trackingId | string | Login イベントの識別子。 |
| MetaData | LogInId | string | Signup イベントの識別子。 (この値は、 trackingId 属性の値と一致する場合があります)。 |
| MetaData | assessmentType | string | イベントの評価の種類。 指定できる値は、 評価 および protectです。 値が指定されていない場合、既定値は protect です。 |
| MetaData | customerLocalDate | dateTime | 顧客のローカル タイム ゾーンでの Signup イベントの作成日。 形式は ISO 8601 です。 |
| MetaData | merchantTimeStamp | dateTime | イベントのタイム スタンプ。 |
| DeviceContext | DeviceContextId | string | 顧客のセッション ID。 この情報は、DFP デバイス フィンガープリント サービスによってマスターされます。 |
| DeviceContext | ipAddress | string | マーチャントが提供する顧客の IP アドレス。 |
| DeviceContext | provider | string | デバイス情報のプロバイダー。 指定できる値は、 DFPFingerprinting および Merchant です。 値が指定されていない場合、既定値は DFPFingerprinting です。 |
| DeviceContext | externalDeviceId | string | マーチャントによって提供およびマスタリングされた顧客のデバイス ID。 |
| DeviceContext | externalDeviceType | string | マーチャントによって提供およびマスタリングされた顧客のデバイス タイプ。 |
| User | userId | string | ユーザー識別子。 この情報はマーチャントから提供されます。 |
| ユーザー | userType | string | ユーザーのプロファイル タイプ。 指定できる値は、 Consumer、 Developer、 Seller、 Publisher、および Tenant です。 |
| User | UserName | string | マーチャント システムで一意であるユーザー指定のユーザー名。 |
| SSOAuthenticationProvider | authenticationProvider | string | ユーザーの SSO 認証プロバイダー (マーチャントの SSO 認証プロバイダーと異なる場合)。 使用できる値は、 MSA、 Facebook、 PSN、 MerchantAuth、および Google です。 |
| SSOAuthenticationProvider | displayName | string | SSO 認証プロバイダーのユーザーの表示名。 たとえば、Microsoft アカウント、Facebook、Google のユーザー名などです。 |
| RecentUpdate | lastPhoneNumberUpdate | dateTime | 最新の更新プログラムまたは任意の電話番号の作成の日付/時刻。 |
| RecentUpdate | lastEmailUpdate | dateTime | 電子メール アドレスの最新の更新または作成の日付/時刻。 |
| RecentUpdate | lastAddressUpdate | dateTime | 最新の更新プログラムまたは任意のアドレスの作成の日付/時刻。 |
| RecentUpdate | lastPaymentInstrumentUpdate | dateTime | 支払い方法の最新の更新または作成の日付/時刻。 |
| MarketingContext | campaignType | enum | マーケティング キャンペーン タイプ。 指定できる値は Direct、 Email、 Referral、 PaidSearch、 OrganicSearch、 Advertising、 SocialNetwork、 General Marketing、 Unknown、 Other。 |
| MarketingContext | trafficSource-referrer | string | このユーザーのソース (既知の場合)。 既存のユーザー参照元を介する場合は、参照元の MerchantUserId を提供します。 |
| MarketingContext | trafficSource-referralLink | string | このユーザーのソース (既知の場合)。 既存のユーザー参照元ではなく他のキャンペーン タイプを使用する場合は、ソース URL リンクを提供します。 |
| MarketingContext | trafficSource-referralSite | string | トラフィックのソース サイト。 使用できる値は、Facebook、Instagram、、Bing、Google、Pinterest、WhatsApp などです。 |
| MarketingContext | IncentiveType | enum | 新規ユーザーのインセンティブ タイプ。 指定できる値は、 None、 CashBack、 Discount、 FreeTrial、 BonusPoints、 Gift、 Unknown、 Other です。 |
| MarketingContext | incentiveOffer | string | 正確なインセンティブ オファー名。 たとえば、最初の注文で 5 ドルオフ、無料配送、5,000 ポイントです。 |
| MarketingContext | CampaignStartDate | 日付 | インセンティブ収集から始まるキャンペーンの日付。 |
| MarketingContext | CampaignExpireDate | 日付 | インセンティブ収集から始まるキャンペーン有効期限。 |
| MarketingContext | IncentiveQuantityLimit | string | マーチャントによって設定されたインセンティブ数量制限。 たとえば、ユーザー 1 人あたり 1 日あたり最大 3 つの 5,000 ポイントです。 |
AccountLogInStatus
AccountLogInStatus API を使用すると、アカウント サインイン イベントの状態に関する情報とコンテキストを Fraud Protection と共有できます。 このイベントは、データ インジェスト イベントのみです。
| Object | 属性 | Type | 説明 |
|---|---|---|---|
| 氏名 | string | 値は AP です。AccountLogin.Status。 | |
| バージョン | string | 値は 0.5 です。 | |
| MetaData | trackingID | string | LoginStatus イベントの識別子。 |
| MetaData | logInId | string | Login イベントの識別子。 |
| MetaData | merchantTimeStamp | DateTime | イベントのタイム スタンプ。 |
| MetaData | userId | string | ユーザー識別子。 この情報はマーチャントから提供されます。 |
| StatusDetails | statusType | string | 状態の種類: Approved、 Rejected、または Pending。 |
| StatusDetails | reasonType | enum | 理由の種類: 破棄、 challenge が失敗しました、 challenge が成功しました、 challenge の保留中、 失敗、、 ビューが渡されました、 ビュー保留中、または None。 既定値は None です。 |
| StatusDetails | challengeType | enum | レビューの状態の種類: SMS、 Email、 Phone、 Other、または None。 既定値は None です。 |
| StatusDetails | statusDate | DateTime | ステータスが適用された日時。 形式は ISO 8601 です。 |
AccountUpdate
AccountUpdate API を使用すると、アカウント情報の更新を Fraud Protection と共有できます。 たとえば、ユーザー プロファイル、住所、支払い方法、電話番号、電子メール アドレス、SSO などの情報を編集または追加できます。 このイベントは、データ インジェスト イベントのみです。
| Object | 属性 | Type | 説明 |
|---|---|---|---|
| 氏名 | string | 値は AP です。AccountUpdate。 | |
| バージョン | string | 値は 0.5 です。 | |
| MetaData | trackingId | string | AccountUpdate イベントの識別子。 |
| MetaData | SignupId | string | AccountUpdateId イベントの識別子。 (この値は、 trackingId 属性の値と一致する場合があります)。 |
| MetaData | customerLocalDate | dateTime | 顧客のローカル タイム ゾーンでの AccountUpdate イベントの作成日。 形式は ISO 8601 です。 |
| MetaData | merchantTimeStamp | dateTime | イベントのタイム スタンプ。 |
| DeviceContext | DeviceContextId | string | 顧客のセッション ID。 この情報は、DFP デバイス フィンガープリント サービスによってマスターされます。 |
| DeviceContext | ipAddress | string | マーチャントが提供する顧客の IP アドレス。 |
| DeviceContext | provider | string | デバイス情報のプロバイダー。 指定できる値は、 DFPFingerprinting および Merchant です。 値が指定されていない場合、既定値は DFPFingerprinting です。 |
| DeviceContext | externalDeviceId | string | マーチャントによって提供およびマスタリングされた顧客のデバイス ID。 |
| DeviceContext | externalDeviceType | string | マーチャントによって提供およびマスタリングされた顧客のデバイス タイプ。 指定できる値は、 Mobile'、 Computer、 MerchantHardware、 Tablet、および GameConsole です。 |
| User | userId | string | ユーザー識別子。 この情報はマーチャントから提供されます。 |
| ユーザー | userType | string | ユーザーのプロファイル タイプ。 指定できる値は、 Consumer、 Developer、 Seller、 Publisher、および Tenant です。 |
| User | UserName | string | マーチャント システムで一意であるユーザー指定のユーザー名。 |
| User | firstName | string | アカウントでユーザーが提供した名。 |
| User | lastName | string | アカウントでユーザーが提供した姓。 |
| User | CountryRegion | string | ユーザーの国またはリージョン。 値は、2 文字の ISO 国/地域コード (たとえば、 US) である必要があります。 |
| User | zipCode | string | ユーザーの郵便番号。 |
| User | timeZone | string | ユーザーのタイム ゾーンです。 |
| User | 言語 | string | ユーザーの言語と地域 (たとえば、 EN-US)。 |
| User | membershipId | string | ユーザーがすでにマーチャントの既存のメンバーシップを持っている場合は、メンバーシップ ID。 |
| User | isMembershipIdUserName | [bool] | membershipId 値をユーザー名として使用できるかどうかを示す True/False 値。 既定値は Falseです。 |
| スマートフォン | phoneType | enum | 電話番号の種類。 使用できる値は、 Primary と Alternative です。 既定値は Primary です。 |
| スマートフォン | phoneNumber | string | ユーザーの電話番号。 形式は、国/地域コードの後にハイフン (-) を付け、電話番号 (たとえば、米国の場合は +1-1234567890) にする必要があります。 |
| スマートフォン | isPhoneNumberValidated | [bool] | True/Falseユーザーが所有しているユーザー指定の電話番号が検証されているかどうかを示す値です。 |
| スマートフォン | phoneNumberValidatedDate | dateTime | ユーザーの電話番号の検証日。 形式は ISO 8601 です。 |
| スマートフォン | isPhoneUserName | [bool] | 電話番号をユーザー名として使用できるかどうかを示す True/False 値です。 既定値は Falseです。 |
| メール | emailType | enum | 電子メール アドレスの種類。 使用できる値は、 Primary と Alternative です。 |
| メール | emailValue | string | ユーザーの電子メール アドレスです。 この値は大文字と小文字を区別しません。 |
| メール | isEmailValidated | [bool] | True/False ユーザー指定の電子メール アドレスがユーザーの所有として検証されているかどうかを示す値です。 |
| メール | emailValidatedDate | dateTime | ユーザーの電子メール アドレスの検証日。 形式は ISO 8601 です。 |
| メール | isEmailUserName | [bool] | 電子メール アドレスをユーザー名として使用できるかどうかを示す True/False 値。 既定値は Falseです。 |
| SSOAuthenticationProvider | authenticationProvider | string | ユーザーの SSO 認証プロバイダー (マーチャントの SSO 認証プロバイダーと異なる場合)。 使用できる値は、 MSA、 Facebook、 PSN、 MerchantAuth、および Google です。 |
| SSOAuthenticationProvider | displayName | string | SSO 認証プロバイダーのユーザーの表示名 (たとえば、Microsoft アカウント、Facebook、Google のユーザー名)。 |
| 番地 | addressType | enum | アドレスのタイプです。 使用できる値は、 Primary、 Billing、 Shipping、および Alternative です。 既定値は Primary です。 |
| 番地 | firstName | string | アドレスに関連付けられているユーザー指定の名。 |
| 番地 | lastName | string | アドレスに関連付けられているユーザー指定の姓。 |
| 番地 | phoneNumber | string | アドレスに関連付けられているユーザー指定の電話番号。 |
| 番地 | street1 | string | 住所に提供された最初の行。 |
| 番地 | street2 | string | 住所に提供された 2 番目の行。 (この値を空白にすることはできません。) |
| 番地 | street3 | string | 住所に提供された 3 番目の行。 (この値を空白にすることはできません。) |
| アドレス | city | string | 住所に提供された都市。 |
| 番地 | state | string | 住所に提供された都道府県。 |
| 番地 | 地域 | string | 住所に提供された地区。 |
| 番地 | zipCode | string | 住所に提供された郵便番号。 |
| 番地 | CountryRegion | string | 住所に提供された国/リージョン コード。 値は、2 文字の ISO 国/地域コード (たとえば、 US) である必要があります。 |
| PaymentInstrument | merchantPaymentInstrumentId | string | 支払い方法の ID。 この情報はマーチャントから提供されます。 |
| PaymentInstrument | type | enum | 支払いのタイプ。 指定できる値は、 CreditCard、 DirectDebit、 PayPal、 MobileBilling、 OnlineBankTransfer、 Invoice、 MerchantGiftCard、 MerchantWallet、 CashOnDelivery、 Paytm、 CCAvenue。 |
| PaymentInstrument | creationDate | DateTime | マーチャントのシステムでの支払い方法の最初のエントリの日付。 形式は ISO 8601 です。 |
| PaymentInstrument | updateDate | DateTime | マーチャントのシステムでの支払い方法の前回の更新の日付。 形式は ISO 8601 です。 |
| PaymentInstrument | state | string | マーチャントのシステムにおける支払い方法の現在の状態 (たとえば、 Active、 Blocked、 Expired)。 |
| PaymentInstrument | cardType | string | この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 指定できる値は、 Visa、 Mastercard、 Amex、 ACH、 SEPA、 UnionPay、 Inicis、 MobileBillingCarrier、 Discover、 AllPay、 JCB、 DiscoverDiners。 |
| PaymentInstrument | holderName | string | 支払い方法のユーザーの名前。 この属性は、 CreditCard DirectDebit 型の支払いにのみ使用されます。 |
| PaymentInstrument | bin | string | この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 |
| PaymentInstrument | expirationDate | string | マーチャントのシステムでの支払い方法の有効期限。 形式は ISO 8601 です。 この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 |
| PaymentInstrument | lastFourDigits | string | この属性は、 CreditCard または DirectDebit 型の支払いにのみ使用されます。 |
| PaymentInstrument | メール | string | 支払い方法に関連付けられている電子メール アドレス。 この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | billingAgreementId | string | この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | payerId | string | この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | payerStatus | string | PayPal が支払人を認証したかどうかを示す値。 この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | addressStatus | string | PayPal が支払人の住所を認証したかどうかを示す値。 この属性は、 PayPal タイプの支払いにのみ使用されます。 |
| PaymentInstrument | imei | string | この属性は、 MobileBilling タイプの支払いにのみ使用されます。 |
| PaymentInstrument \ BillingAddress | addressType | enum | アドレスのタイプです。 使用できる値は、 Primary、 Billing、 Shipping、および Alternative です。 既定値は Billing です。 |
| PaymentInstrument \ BillingAddress | firstName | string | アドレスに関連付けられているユーザー指定の名。 |
| PaymentInstrument \ BillingAddress | lastName | string | アドレスに関連付けられているユーザー指定の姓。 |
| PaymentInstrument \ BillingAddress | phoneNumber | string | アドレスに関連付けられているユーザー指定の電話番号。 |
| PaymentInstrument \ BillingAddress | street1 | string | 住所に提供された最初の行。 |
| PaymentInstrument \ BillingAddress | street2 | string | 住所に提供された 2 番目の行。 (この値を空白にすることはできません。) |
| PaymentInstrument \ BillingAddress | street3 | string | 住所に提供された 3 番目の行。 (この値を空白にすることはできません。) |
| PaymentInstrument \ BillingAddress | city | string | 住所に提供された都市。 |
| PaymentInstrument \ BillingAddress | state | string | 住所に提供された都道府県。 |
| PaymentInstrument \ BillingAddress | 地域 | string | 住所に提供された地区。 |
| PaymentInstrument \ BillingAddress | zipCode | string | 住所に提供された郵便番号。 |
| PaymentInstrument \ BillingAddress | CountryRegion | string | 住所に提供された国/リージョン コード。 値は、2 文字の ISO 国/地域コード (たとえば、 US) である必要があります。 |
Labels
Labels API を使用すると、不正行為シグナルの追加セットに基づくモデル トレーニングのトランザクションとイベントの結果に関する追加情報を共有できます。 この情報には、銀行から受け取る情報が含まれます。 このイベントは、データ インジェスト イベントのみです。
| カテゴリ | 属性 | Type | 説明 |
|---|---|---|---|
| 氏名 | string | 値は AP です。AccountLabel。 | |
| バージョン | string | 値は 0.5 です。 | |
| MetaData | TrackingId | String | 各イベント/レコードの一意の ID。 |
| MetaData | merchantTimeStamp | DateTime | 販売者のタイム ゾーン内の日付。 形式は ISO 8601 です。 |
| MetaData | userId | string | ユーザー識別子。 この情報はマーチャントから提供されます。 |
| Label | EventTimeStamp | DateTime | イベントの日時。 使用可能な値は、チャージバック日とレビュー日です。 形式は ISO 8601 です。 |
| Label | LabelObjectType | enum | ラベルの種類: Purchase、 Account Creation、 Account Login、 Account Update、 Custom Fraud Evaluation、 Account、 Payment instrument、または Email。 |
| Label | LabelObjectId | String | オブジェクトの識別子フィールド: PurchaseId、 AccountCreationId、 AccountLoginId、 AccountUpdateId、 UserId、 MerchantPaymentInstrumentId、または Email。 |
| Label | LabelSource | enum | ラベルのソース: Customer Escalation、 Chargeback、 TC40_SAFE、 Manual Review、 Refund、 Offline Analysis、または Account Protection Review。 |
| Label | LabelState | enum | ラベルの現在の状態: 受け入れ済み、 Fraud、 Disputed、 Reversed、 Abuse、 Resubmitted Request、 AccountCompromised、または AccountNotCompromed。 |
| Label | LabelReasonCodes | enum | 各種類のラベルに関連付けられている理由コード: Processor/Bank 応答コード、 Fraud Refund、 Account TakeOver、 Payment Instrument Fraud、 Account Fraud、 Abuse、 Friendly Fraud、 Account Credentials leaked、または Passed Account Protection Checks。 |
| Label | プロセッサ | String | 不正アクセスを効果的に回避するための TC40 またはシステム (SAFE) 情報を生成する銀行または支払い処理者の名前。 |
| Label | EffectiveStartDate | DateTime | このラベルが有効になる日付。 形式は ISO 8601 です。 |
| Label | EffectiveEndDate | DateTime | このラベルの終了日。 形式は ISO 8601 です。 |