계정 보호 스키마
이 문서에서는 API(애플리케이션 프로그래밍 인터페이스)를 통해 스키마를 간략하게 설명합니다. 자세한 내용은 Dynamics 365 Fraud Protection 실시간 API 통합을 참조 하세요.
AccountCreation
AccountCreation API를 사용하면 위험 평가를 위해 들어오는 새 계정 생성 이벤트에 대한 정보 및 컨텍스트를 Microsoft Dynamics 365 Fraud Protection과 공유할 수 있습니다.
| Object | attribute | Type | 설명 |
|---|---|---|---|
| 테넌트 ID | string | TenantId는 Azure ActiveDirectory 테넌트(Tenant)를 나타내는 GUID입니다. | |
| 속성 | string | 값은 AP입니다 . AccountCreation. | |
| 버전 | string | 값은 0.5입니다. | |
| MetaData | trackingId | string | AccountCreationId 이벤트의 식별자입니다. |
| MetaData | SignupId | string | AccountCreationId 이벤트의 식별자입니다. (이 값은 trackingId 특성의 값과 일치할 수 있지만 userId 특성과는 다릅니다.) |
| MetaData | assessmentType | string | 이벤트에 대한 평가 유형입니다. 가능한 값은 평가 및 보호됩니다. 값을 지정하지 않으면 기본값이 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입니다. |
| 사용자 | userId | string | 사용자 식별자입니다. 이 정보는 판매자가 제공합니다. |
| 사용자 | userType | string | 사용자의 프로필 유형입니다. 가능한 값은 소비자, 개발자, 판매자, 게시자 및 테넌트입니다. |
| 사용자 | UserName | string | 가맹점 시스템에서 고유한 사용자 제공 사용자 이름입니다. |
| 사용자 | firstName | string | 계정에서 사용자가 제공한 이름입니다. |
| 사용자 | lastName | string | 계정에서 사용자가 제공한 성입니다. |
| 사용자 | CountryRegion | string | 사용자의 국가 또는 지역입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다. |
| 사용자 | zipCode | string | 사용자의 우편 번호입니다. |
| 사용자 | timeZone | string | 사용자의 표준 시간대입니다. |
| 사용자 | language | string | 사용자의 언어 및 지역(예: EN-US)입니다. |
| 사용자 | membershipId | string | 사용자에게 이미 가맹점과 기존 멤버 자격이 있는 경우의 멤버 자격 ID입니다. |
| 사용자 | isMembershipIdUserName | bool | membershipId 값을 사용자 이름으로 사용할 수 있는지 여부를 나타내는 True/False 값입니다. 기본값은 False입니다. |
| 휴대폰 | phoneType | enum | 전화 번호의 유형입니다. 가능한 값은 기본 및 대안입니다. 기본값은 Primary입니다. |
| 휴대폰 | phoneNumber | string | 사용자의 전화 번호입니다. 형식은 국가/지역 코드 다음에 하이픈(-) 및 전화 번호(예: 미국, +1-1234567890)여야 합니다. |
| 휴대폰 | isPhoneNumberValidated | bool | 사용자가 제공한 전화 번호가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다. |
| 휴대폰 | phoneNumberValidatedDate | dateTime | 사용자 전화 번호의 유효성 검사 날짜입니다. ISO 8601 형식입니다. |
| 휴대폰 | isPhoneUserName | bool | 전화 번호를 사용자 이름으로 사용할 수 있는지 여부를 나타내는 True/False 값입니다. 기본값은 False입니다. |
| 전자 메일 | emailType | enum | 전자 메일 주소의 유형입니다. 가능한 값은 기본 및 대안입니다. |
| 전자 메일 | emailValue | string | 사용자의 전자 메일 주소입니다. 이 값은 대/소문자를 구분하지 않습니다. |
| 전자 메일 | isEmailValidated | bool | 사용자가 제공한 전자 메일 주소가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다. |
| 전자 메일 | emailValidatedDate | dateTime | 사용자 전자 메일 주소의 유효성 검사 날짜입니다. ISO 8601 형식입니다. |
| 전자 메일 | isEmailUserName | bool | 전자 메일 주소를 사용자 이름으로 사용할 수 있는지 여부를 나타내는 True/False 값입니다. 기본값은 False입니다. |
| SSOAuthenticationProvider | authenticationProvider | string | 가맹점의 SSO 인증 공급자와 다른 경우 사용자의 SSO(Single Sign-On) 인증 공급자입니다. 가능한 값은 MSA, Facebook, PSN, MerchantAuth 및 Google입니다. |
| SSOAuthenticationProvider | displayName | string | SSO 인증 공급자에 대한 사용자의 표시 이름(예: Microsoft 계정, Facebook 또는 Google의 사용자 이름)입니다. |
| 주소 | addressType | enum | 주소의 형식입니다. 가능한 값은 기본, 청구, 배송 및 대안입니다. 기본값은 Primary입니다. |
| 주소 | firstName | string | 주소와 연결된 사용자가 제공한 이름입니다. |
| 주소 | lastName | string | 주소와 연결된 사용자가 제공한 성입니다. |
| 주소 | phoneNumber | string | 주소와 연결된 사용자가 제공한 전화 번호입니다. |
| 주소 | street1 | string | 주소에 대해 제공된 첫 번째 행입니다. |
| 주소 | street2 | string | 주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.) |
| 주소 | street3 | string | 주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.) |
| 주소 | city | string | 주소로 제공된 도시입니다. |
| 주소 | state | string | 주소에 대해 제공된 주 또는 주입니다. |
| 주소 | 지구 | string | 주소에 대해 제공된 지구입니다. |
| 주소 | zipCode | string | 주소에 대해 제공된 우편 번호입니다. |
| 주소 | CountryRegion | string | 주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다. |
| PaymentInstrument | merchantPaymentInstrumentId | string | 결제 방법의 식별자입니다. 이 정보는 판매자가 제공합니다. |
| 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 | 가맹점 시스템에서 결제 방법의 현재 상태(예: 활성, 차단됨 또는 만료됨)입니다. |
| 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 | 주소의 형식입니다. 가능한 값은 기본, 청구, 배송 및 대안입니다. 기본값은 청구입니다. |
| PaymentInstrument \ BillingAddress | firstName | string | 주소와 연결된 사용자가 제공한 이름입니다. |
| PaymentInstrument \ BillingAddress | lastName | string | 주소와 연결된 사용자가 제공한 성입니다. |
| PaymentInstrument \ BillingAddress | phoneNumber | string | 주소와 연결된 사용자가 제공한 전화 번호입니다. |
| PaymentInstrument \ BillingAddress | street1 | string | 주소에 대해 제공된 첫 번째 행입니다. |
| PaymentInstrument \ BillingAddress | street2 | string | 주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.) |
| PaymentInstrument \ BillingAddress | street3 | string | 주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.) |
| PaymentInstrument \ BillingAddress | city | string | 주소로 제공된 도시입니다. |
| PaymentInstrument \ BillingAddress | state | string | 주소에 대해 제공된 주 또는 주입니다. |
| PaymentInstrument \ BillingAddress | 지구 | string | 주소에 대해 제공된 지구 |
| PaymentInstrument \ BillingAddress | zipCode | string | 주소에 대해 제공된 우편 번호입니다. |
| PaymentInstrument \ BillingAddress | CountryRegion | string | 주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다. |
| MarketingContext | campaignType | enum | 마케팅 캠페인 유형입니다. 가능한 값은 Direct, Email, 조회, PaySearch, OrganicSearch, Advertising, SocialNetwork, 일반 마케팅, 알 수 없음, 기타입니다. |
| MarketingContext | trafficSource-referrer | string | 알려진 경우 이 사용자의 원본입니다. 기존 사용자 조회를 통해 이 경우 참조자의 원래 MerchantUserId를 제공합니다. |
| MarketingContext | trafficSource-referralLink | string | 알려진 경우 이 사용자의 원본입니다. 기존 사용자 조회 대신 다른 캠페인 유형을 통해 사용하는 경우 원본 URL 링크를 제공합니다. |
| MarketingContext | trafficSource-referralSite | string | 트래픽의 원본 사이트입니다. 가능한 값은 페이스 북, 인스 타 그램, 트위터, 빙, 구글, 핀터레스트, 싸이 월드, 미투데이 등입니다. |
| MarketingContext | IncentiveType | enum | 새 사용자의 인센티브 유형입니다. 가능한 값은 None, CashBack, Discount, FreeTrial, BonusPoints, Gift, Unknown, Other입니다. |
| MarketingContext | incentiveOffer | string | 정확한 인센티브 제품 이름입니다. 예를 들어, 첫 번째 주문에 $5 할인, 무료 배송, 5000 포인트. |
| MarketingContext | CampaignStartDate | date | 인센티브 수집을 시작하는 캠페인 날짜입니다. |
| MarketingContext | CampaignExpireDate | date | 인센티브 컬렉션의 캠페인 만료 날짜입니다. |
| MarketingContext | IncentiveQuantityLimit | string | 가맹점에서 설정한 인센티브 수량 한도입니다. 예를 들어 하루에 사용자당 최대 5,000포인트입니다. |
AccountCreationStatus
AccountCreationStatus API를 사용하면 계정 생성 이벤트의 상태에 대한 정보 및 컨텍스트를 Fraud Protection과 공유할 수 있습니다. 이 이벤트는 데이터 수집 이벤트입니다.
| Object | attribute | Type | 설명 |
|---|---|---|---|
| 테넌트 ID | string | TenantId는 Azure ActiveDirectory 테넌트(Tenant)를 나타내는 GUID입니다. | |
| 속성 | string | 값은 AP입니다 . AccountCreation.Status. | |
| 버전 | string | 값은 0.5입니다. | |
| MetaData | trackingID | string | SignupStatus 이벤트의 식별자입니다. |
| MetaData | signupId | string | 등록 이벤트의 식별자입니다. |
| MetaData | merchantTimeStamp | DateTime | 이벤트의 타임스탬프를 나타냅니다. |
| MetaData | userId | string | 사용자 식별자입니다. 이 정보는 판매자가 제공합니다. |
| StatusDetails | statusType | enum | 상태 유형: 승인됨, 거부됨 또는 보류 중입니다. |
| StatusDetails | reasonType | enum | 이유 유형: 챌린지 중단, 도전 실패, 챌린지 통과, 챌린지 보류 중, 검토 실패, 검토 통과, 검토 보류 중 또는 없음. 기본 값은 None입니다. |
| StatusDetails | challengeType | enum | 검토 상태 유형: SMS, 전자 메일, 전화, 기타 또는 없음. 기본 값은 None입니다. |
| StatusDetails | statusDate | DateTime | 상태가 적용된 날짜 및 시간입니다. ISO 8601 형식입니다. |
AccountLogIn
AccountLogIn API를 사용하면 위험 평가를 위해 들어오는 로그인 이벤트에 대한 정보 및 컨텍스트를 Fraud Protection과 공유할 수 있습니다.
| Object | attribute | Type | Description |
|---|---|---|---|
| 이름 | string | 값은 AP입니다 . AccountLogin. | |
| 버전 | string | 값은 0.5입니다. | |
| MetaData | trackingId | string | 로그인 이벤트의 식별자 입니다 . |
| MetaData | LogInId | string | 등록 이벤트의 식별자입니다. (이 값은 trackingId 특성의 값과 일치할 수 있습니다.) |
| MetaData | assessmentType | string | 이벤트에 대한 평가 유형입니다. 가능한 값은 평가 및 보호됩니다. 값을 지정하지 않으면 기본값이 protect입니다. |
| MetaData | customerLocalDate | dateTime | 고객의 현지 표준 시간대에 있는 등록 이벤트의 생성 날짜입니다. 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 | 가맹점에서 제공하고 마스터한 고객의 디바이스 유형입니다. |
| 사용자 | userId | string | 사용자 식별자입니다. 이 정보는 판매자가 제공합니다. |
| 사용자 | userType | string | 사용자의 프로필 유형입니다. 가능한 값은 소비자, 개발자, 판매자, 게시자 및 테넌트입니다. |
| 사용자 | 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, 조회, PaySearch, OrganicSearch, Advertising, SocialNetwork, 일반 마케팅, 알 수 없음, 기타입니다. |
| MarketingContext | trafficSource-referrer | string | 알려진 경우 이 사용자의 원본입니다. 기존 사용자 조회를 통해 이 경우 참조자의 원래 MerchantUserId를 제공합니다. |
| MarketingContext | trafficSource-referralLink | string | 알려진 경우 이 사용자의 원본입니다. 기존 사용자 조회 대신 다른 캠페인 유형을 통해 사용하는 경우 원본 URL 링크를 제공합니다. |
| MarketingContext | trafficSource-referralSite | string | 트래픽의 원본 사이트입니다. 가능한 값은 페이스 북, 인스 타 그램, 트위터, 빙, 구글, 핀터레스트, 싸이 월드, 미투데이 등입니다. |
| MarketingContext | IncentiveType | enum | 새 사용자의 인센티브 유형입니다. 가능한 값은 None, CashBack, Discount, FreeTrial, BonusPoints, Gift, Unknown, Other입니다. |
| MarketingContext | incentiveOffer | string | 정확한 인센티브 제품 이름입니다. 예를 들어, 첫 번째 주문에 $5 할인, 무료 배송, 5000 포인트. |
| MarketingContext | CampaignStartDate | date | 인센티브 수집을 시작하는 캠페인 날짜입니다. |
| MarketingContext | CampaignExpireDate | date | 인센티브 컬렉션의 캠페인 만료 날짜입니다. |
| MarketingContext | IncentiveQuantityLimit | string | 가맹점에서 설정한 인센티브 수량 한도입니다. 예를 들어 하루에 사용자당 최대 5,000포인트입니다. |
AccountLogInStatus
AccountLogInStatus API를 사용하면 계정 로그인 이벤트의 상태에 대한 정보 및 컨텍스트를 Fraud Protection과 공유할 수 있습니다. 이 이벤트는 데이터 수집 이벤트입니다.
| Object | attribute | Type | Description |
|---|---|---|---|
| 이름 | string | 값은 AP입니다 . AccountLogin.Status. | |
| 버전 | string | 값은 0.5입니다. | |
| MetaData | trackingID | string | LoginStatus 이벤트의 식별자입니다. |
| MetaData | logInId | string | 로그인 이벤트의 식별자 입니다 . |
| MetaData | merchantTimeStamp | DateTime | 이벤트의 타임스탬프를 나타냅니다. |
| MetaData | userId | string | 사용자 식별자입니다. 이 정보는 판매자가 제공합니다. |
| StatusDetails | statusType | string | 상태 유형: 승인됨, 거부됨 또는 보류 중입니다. |
| StatusDetails | reasonType | enum | 이유 유형: 챌린지 중단, 도전 실패, 챌린지 통과, 챌린지 보류 중, 검토 실패, 검토 통과, 검토 보류 중 또는 없음. 기본 값은 None입니다. |
| StatusDetails | challengeType | enum | 검토 상태 유형: SMS, 전자 메일, 전화, 기타 또는 없음. 기본 값은 None입니다. |
| StatusDetails | statusDate | DateTime | 상태가 적용된 날짜 및 시간입니다. ISO 8601 형식입니다. |
AccountUpdate
AccountUpdate API를 사용하면 사기 방지를 사용하여 계정 정보 업데이트를 공유할 수 있습니다. 예를 들어 사용자 프로필, 주소, 결제 방법, 전화 번호, 전자 메일 주소 및 SSO와 같은 정보를 편집하거나 추가할 수 있습니다. 이 이벤트는 데이터 수집 이벤트입니다.
| Object | attribute | Type | Description |
|---|---|---|---|
| 이름 | 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입니다. |
| 사용자 | userId | string | 사용자 식별자입니다. 이 정보는 판매자가 제공합니다. |
| 사용자 | userType | string | 사용자의 프로필 유형입니다. 가능한 값은 소비자, 개발자, 판매자, 게시자 및 테넌트입니다. |
| 사용자 | UserName | string | 가맹점 시스템에서 고유한 사용자 제공 사용자 이름입니다. |
| 사용자 | firstName | string | 계정에서 사용자가 제공한 이름입니다. |
| 사용자 | lastName | string | 계정에서 사용자가 제공한 성입니다. |
| 사용자 | CountryRegion | string | 사용자의 국가 또는 지역입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다. |
| 사용자 | zipCode | string | 사용자의 우편 번호입니다. |
| 사용자 | timeZone | string | 사용자의 표준 시간대입니다. |
| 사용자 | language | string | 사용자의 언어 및 지역(예: EN-US)입니다. |
| 사용자 | membershipId | string | 사용자에게 이미 가맹점과 기존 멤버 자격이 있는 경우의 멤버 자격 ID입니다. |
| 사용자 | isMembershipIdUserName | bool | membershipId 값을 사용자 이름으로 사용할 수 있는지 여부를 나타내는 True/False 값입니다. 기본값은 False입니다. |
| 휴대폰 | phoneType | enum | 전화 번호의 유형입니다. 가능한 값은 기본 및 대안입니다. 기본값은 Primary입니다. |
| 휴대폰 | phoneNumber | string | 사용자의 전화 번호입니다. 형식은 국가/지역 코드 다음에 하이픈(-) 및 전화 번호(예: 미국, +1-1234567890)여야 합니다. |
| 휴대폰 | isPhoneNumberValidated | bool | 사용자가 제공한 전화 번호가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다. |
| 휴대폰 | phoneNumberValidatedDate | dateTime | 사용자 전화 번호의 유효성 검사 날짜입니다. ISO 8601 형식입니다. |
| 휴대폰 | isPhoneUserName | bool | 전화 번호를 사용자 이름으로 사용할 수 있는지 여부를 나타내는 True/False 값입니다. 기본값은 False입니다. |
| 전자 메일 | emailType | enum | 전자 메일 주소의 유형입니다. 가능한 값은 기본 및 대안입니다. |
| 전자 메일 | 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입니다. |
| 주소 | firstName | string | 주소와 연결된 사용자가 제공한 이름입니다. |
| 주소 | lastName | string | 주소와 연결된 사용자가 제공한 성입니다. |
| 주소 | phoneNumber | string | 주소와 연결된 사용자가 제공한 전화 번호입니다. |
| 주소 | street1 | string | 주소에 대해 제공된 첫 번째 행입니다. |
| 주소 | street2 | string | 주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.) |
| 주소 | street3 | string | 주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.) |
| 주소 | city | string | 주소로 제공된 도시입니다. |
| 주소 | state | string | 주소에 대해 제공된 주 또는 주입니다. |
| 주소 | 지구 | string | 주소에 대해 제공된 지구입니다. |
| 주소 | zipCode | string | 주소에 대해 제공된 우편 번호입니다. |
| 주소 | CountryRegion | string | 주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다. |
| PaymentInstrument | merchantPaymentInstrumentId | string | 결제 방법의 식별자입니다. 이 정보는 판매자가 제공합니다. |
| 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 | 가맹점 시스템에서 결제 방법의 현재 상태(예: 활성, 차단됨 또는 만료됨)입니다. |
| 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 | 주소의 형식입니다. 가능한 값은 기본, 청구, 배송 및 대안입니다. 기본값은 청구입니다. |
| PaymentInstrument \ BillingAddress | firstName | string | 주소와 연결된 사용자가 제공한 이름입니다. |
| PaymentInstrument \ BillingAddress | lastName | string | 주소와 연결된 사용자가 제공한 성입니다. |
| PaymentInstrument \ BillingAddress | phoneNumber | string | 주소와 연결된 사용자가 제공한 전화 번호입니다. |
| PaymentInstrument \ BillingAddress | street1 | string | 주소에 대해 제공된 첫 번째 행입니다. |
| PaymentInstrument \ BillingAddress | street2 | string | 주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.) |
| PaymentInstrument \ BillingAddress | street3 | string | 주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.) |
| PaymentInstrument \ BillingAddress | city | string | 주소로 제공된 도시입니다. |
| PaymentInstrument \ BillingAddress | state | string | 주소에 대해 제공된 주 또는 주입니다. |
| PaymentInstrument \ BillingAddress | 지구 | string | 주소에 대해 제공된 지구입니다. |
| PaymentInstrument \ BillingAddress | zipCode | string | 주소에 대해 제공된 우편 번호입니다. |
| PaymentInstrument \ BillingAddress | CountryRegion | string | 주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다. |
레이블
Labels API를 사용하면 추가 사기 신호 집합을 기반으로 하는 모델 학습을 위한 트랜잭션 및 이벤트의 결과에 대한 추가 정보를 공유할 수 있습니다. 이 정보에는 은행에서 받은 정보가 포함됩니다. 이 이벤트는 데이터 수집 이벤트입니다.
| 범주 | attribute | Type | Description |
|---|---|---|---|
| 이름 | string | 값은 AP입니다 . AccountLabel. | |
| 버전 | string | 값은 0.5입니다. | |
| MetaData | TrackingId | 문자열 | 각 이벤트/레코드의 고유 ID입니다. |
| MetaData | merchantTimeStamp | DateTime | 가맹점의 표준 시간대에 있는 날짜입니다. ISO 8601 형식입니다. |
| MetaData | userId | string | 사용자 식별자입니다. 이 정보는 판매자가 제공합니다. |
| 레이블 | EventTimeStamp | DateTime | 이벤트 날짜와 시간입니다. 가능한 값은 차지백 날짜 및 검토 날짜입니다. ISO 8601 형식입니다. |
| 레이블 | LabelObjectType | enum | 레이블 유형: 구매, 계정 만들기, 계정 로그인, 계정 업데이트, 사용자 지정 사기 평가, 계정, 결제 방법 또는 전자 메일. |
| 레이블 | LabelObjectId | 문자열 | 개체의 식별자 필드: PurchaseId, AccountCreationId, AccountLoginId, AccountUpdateId, UserId, MerchantPaymentInstrumentId 또는 Email. |
| 레이블 | LabelSource | enum | 레이블의 원본: 고객 에스컬레이션, 차지백, TC40_SAFE, 수동 검토, 환불, 오프라인 분석 또는 계정 보호 검토. |
| 레이블 | LabelState | enum | 레이블의 현재 상태: 문의 수락됨, 사기 행위, 이의 제기, 취소됨, 남용, 다시 제출된 요청, AccountCompromised 또는 AccountNotCompromised입니다. |
| 레이블 | LabelReasonCodes | enum | 각 레이블 유형과 연결된 이유 코드: 프로세서/은행 응답 코드, 사기 환불, 계정 전환, 결제 방법 사기, 계정 사기, 남용, 친숙한 사기, 계정 자격 증명 유출 또는 통과된 계정 보호 검사. |
| 레이블 | 프로세서 | 문자열 | TC40 또는 사기 방지를 위한 시스템(SAFE) 정보를 생성하는 은행 또는 결제 프로세서의 이름입니다. |
| 레이블 | EffectiveStartDate | DateTime | 이 레이블이 적용되는 날짜입니다. ISO 8601 형식입니다. |
| 레이블 | EffectiveEndDate | DateTime | 이 레이블의 종료 날짜입니다. ISO 8601 형식입니다. |