다음을 통해 공유


Dynamics 365 Fraud Protection(미리 보기)

Microsoft Dynamics 365 Fraud Protection은 판매자에게 전자 상거래 구매, 사기성 계정 등록 및 온라인 스토어에서의 로그인 시도와 관련된 사기 활동에 대한 위험 평가를 얻을 수 있는 기능을 제공합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Microsoft
URL https://dynamics.microsoft.com/ai/fraud-protection/
전자 메일 dfpconnector@microsoft.com
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://docs.microsoft.com/fraud-protection-rest/api/fraud-protection-rest/
개인 정보 보호 정책 https://docs.microsoft.com/dynamics365/fraud-protection/data-processing-protection/
카테고리 AI

Microsoft Dynamics 365 Fraud Protection 커넥터는 판매자에게 전자 상거래 구매, 사기성 계정 등록 및 온라인 스토어에서의 로그인 시도와 관련된 사기 활동에 대한 위험 평가를 얻을 수 있는 기능을 제공합니다.

필수 조건

이 커넥터를 사용하려면 Dynamics 365 Fraud Protection에 프로비전된 테넌트가 이미 있어야 하며 Power App Platform에 계정이 이미 있어야 합니다.

자격 증명을 가져오는 방법

자격 증명을 가져오는 방법에 대한 단계는 다음과 같습니다. https://github.com/microsoft/Dynamics-365-Fraud-Protection-Samples/tree/master/power%20apps%20connector

커넥터 시작

시작하는 방법에 대한 자세한 내용은 Dynamics 365 Fraud Protection 샘플을 참조하세요.

알려진 문제 및 제한 사항

자세한 내용은 Dynamics 365 Fraud Protection 샘플을 참조하세요.

일반적인 오류 및 해결

커넥터를 사용하여 Dynamics 365 Fraud Protection을 호출하는 경우 몇 가지 일반적인 문제가 발생할 수 있습니다.

  • 401 권한 없음: 액세스 토큰이 잘못되었습니다. 입력한 자격 증명을 확인합니다.
  • 403 사용할 수 없음: 권한 부여에 실패했습니다. 입력한 자격 증명을 확인합니다.
  • 400 잘못된 요청: 페이로드의 일부 필수 필드가 없거나 형식이 잘못되었습니다. 자세한 오류 메시지를 확인합니다.
  • 500 내부 서버 오류: 서버 쪽에서 예외가 발생했습니다. 상관 관계 ID를 적어두고 이러한 오류에 대해 DFP 팀에 문의하세요.

자주 묻는 질문(FAQ)

자세한 내용은 Dynamics 365 Fraud Protection 샘플을 참조하세요.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

계정 로그인 상태를 업데이트합니다.

이 이벤트는 계정 로그인의 상태(예: 계정 로그인이 취소된 경우)의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

계정 로그인 시도에 대한 위험 평가를 제공합니다.

이 이벤트는 들어오는 새 계정 로그인 시도에 대한 정보와 컨텍스트를 보냅니다. 응답에는 계정 로그인에 대한 결정이 포함됩니다.

계정 만들기 상태를 업데이트합니다.

이 이벤트는 계정 만들기의 상태(예: 계정 만들기가 취소된 경우)의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

계정 만들기 시도에 대한 위험 평가를 제공합니다.

이 이벤트는 들어오는 새 계정 만들기 시도에 대한 정보와 컨텍스트를 보냅니다. 응답에는 계정 만들기에 대한 결정이 포함됩니다.

계정 보호를 위해 계정 정보를 업데이트합니다.

이 이벤트는 계정 보호 서비스에 대한 사용자 계정 정보(예: 결제 방법 추가, 주소 추가 또는 기타 사용자 특성)를 업데이트하거나 만듭니다. 데이터 수집 이벤트 전용입니다.

계정 보호를 위해 사기 레이블 정보를 업데이트합니다.

이 이벤트는 레이블의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

구매 보호를 위해 계정 정보를 업데이트합니다.

이 이벤트는 구매 보호 서비스(예: 결제 방법 추가, 주소 추가 또는 기타 사용자 특성)에 대한 사용자 계정 정보를 업데이트하거나 만듭니다. 데이터 수집 이벤트 전용입니다.

구매 보호를 위해 사기 레이블 정보를 업데이트합니다.

이 이벤트는 레이블의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

사용자 지정 이벤트에 대한 위험 평가를 제공합니다.

이 이벤트를 사용하면 규칙 평가를 위해 선택한 조건에 따라 트리거되는 자체 선택 구조를 보낼 수 있습니다. 응답에는 이벤트에 대한 결정이 포함됩니다.

업데이트 확인 사기 정보

이 이벤트는 고객이 자신의 은행에 사기로 이의를 제기한 이전 구매에 대한 정보를 보냅니다. 데이터 수집 이벤트입니다. 많은 가맹점이 대량 데이터 업로드를 사용하여 이러한 이벤트를 보냅니다.

온라인 구매 트랜잭션에 대한 위험 평가 제공

이 이벤트는 들어오는 새 구매 트랜잭션에 대한 정보와 컨텍스트를 보냅니다. 응답에는 구매 거래를 승인하거나 거부하는 결정과 가맹점이 은행에 인증 호출을 통해 보내야 하는 적절한 MID(가맹점 ID)가 포함됩니다.

온라인 구매 트랜잭션의 상태를 업데이트합니다.

이 이벤트는 예를 들어 구매가 취소된 경우 구매 상태의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

은행 인증 정보 업데이트

이 이벤트는 은행에 전송된 구매 거래가 은행 승인 또는 은행 수수료/결제에 대해 승인되거나 거부되었는지 여부를 전달합니다. 데이터 수집 이벤트 전용입니다.

환불 정보 업데이트

이 이벤트는 환불되는 이전 구매 트랜잭션에 대한 정보를 보냅니다. 데이터 수집 이벤트입니다. 많은 가맹점이 대량 데이터 업로드를 사용하여 이러한 이벤트를 보냅니다.

계정 로그인 상태를 업데이트합니다.

이 이벤트는 계정 로그인의 상태(예: 계정 로그인이 취소된 경우)의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

이름
name True string

이벤트 이름입니다. 'AP여야 합니다. AccountLogin.Status'

version
version True string

페이로드 버전입니다. "0.5"여야 합니다.

trackingId
trackingId True string

계정 로그인 상태 이벤트의 식별자입니다.

loginId
loginId True string

계정 로그인 이벤트의 식별자입니다.

merchantTimeStamp
merchantTimeStamp True date-time

이벤트에 대한 TimeStamp입니다.

userId
userId True string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

statusType
statusType True string

상태 유형: '승인됨'|' 거부됨'|' 보류 중'.

reasonType
reasonType string

이유 유형: 'None'|' ChallengeAbandoned'|' ChallengeFailed'|' ChallengePassed'|' ChallengePending'|' ReviewFailed'|' ReviewPassed'|' ReviewPendinge'. 기본값은 'None'입니다.

challengeType
challengeType string

검토 상태 유형: 'SMS'|' 전자 메일'|' 전화'|' 기타'|' 없음'. 기본값은 'None'입니다.

statusDate
statusDate True date-time

상태가 적용된 날짜 및 시간입니다. ISO 8601 형식입니다.

반환

Dynamics Fraud Protection 성공 개체

계정 로그인 시도에 대한 위험 평가를 제공합니다.

이 이벤트는 들어오는 새 계정 로그인 시도에 대한 정보와 컨텍스트를 보냅니다. 응답에는 계정 로그인에 대한 결정이 포함됩니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

이름
name True string

이벤트 이름입니다. 'AP여야 합니다. AccountLogin'

version
version True string

페이로드 버전입니다. "0.5"여야 합니다.

trackingId
trackingId True string

로그인 이벤트의 식별자입니다.

loginId
loginId True string

로그인 이벤트의 식별자입니다. trackingId와 일치시킬 수 있습니다.

평가 유형
assessmentType string

이벤트에 대한 평가 유형을 나타냅니다. 가능한 값은 'Evaluate' | '보호'. 지정하지 않으면 기본값은 'Protect'입니다.

customerLocalDate
customerLocalDate True date-time

고객의 현지 표준 시간대에 있는 계정 로그인 이벤트의 로그인 날짜입니다. ISO 8601 형식입니다.

merchantTimeStamp
merchantTimeStamp True date-time

이벤트에 대한 TimeStamp입니다.

deviceContextId
deviceContextId True string

DFP 디바이스 지문 서비스에서 제공하고 마스터하는 고객의 디바이스 ID입니다.

ipAddress
ipAddress string

고객의 IP 주소입니다.

provider
provider string

디바이스 정보의 공급자입니다. 가능한 값은 'DFPFingerprinting'|'입니다. 판매자'|' 알 수 없음'. 지정하지 않으면 기본값은 'DFPFingerprinting'입니다.

externalDeviceId
externalDeviceId string

가맹점에서 제공하고 마스터한 고객의 디바이스 ID입니다.

externalDeviceType
externalDeviceType string

가맹점에서 제공하고 마스터한 고객의 디바이스 유형입니다. 가능한 값은 'Mobile', 'Computer', 'MerchantHardware', 'Tablet', 'GameConsole'입니다.

userId
userId True string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

사용자 유형
userType string

사용자의 프로필 유형입니다. 가능한 값은 'Consumer'|'입니다. 개발자'|' Seller'|' Publisher'|' 테넌트'.

사용자 이름
username True string

사용자가 제공한 사용자 이름입니다.

authenticationProvider
authenticationProvider True string

가맹점과 다른 경우 사용자의 SSO(Single Sign-On) 인증 공급자입니다. 가능한 valuse는 'MSA'|'입니다. Facebook'|' PSN'|' MerchantAuth'|' 구글'.

표시 이름
displayName True string

가맹점과 다른 경우 사용자의 SSO(Single Sign-On) 인증 공급자입니다. 가능한 valuse는 'MSA'|'입니다. Facebook'|' PSN'|' MerchantAuth'|' 구글'.

lastPhoneNumberUpdateDate
lastPhoneNumberUpdateDate date-time

가장 최근 업데이트 또는 전화 번호의 날짜/시간을 만듭니다.

lastEmailUpdateDate
lastEmailUpdateDate date-time

전자 메일의 최신 업데이트 또는 만들기 날짜/시간입니다.

lastAddressUpdateDate
lastAddressUpdateDate date-time

가장 최근 업데이트 또는 모든 주소의 날짜/시간을 만듭니다.

lastPaymentInstrumentUpdateDate
lastPaymentInstrumentUpdateDate date-time

PaymentInstrument의 최신 업데이트 또는 만들기 날짜/시간입니다.

campaignType
campaignType string

마케팅 캠페인 유형입니다. 가능한 값은 '직접', '이메일', '추천', 'PaySearch', 'OrganicSearch', 'Advertising', 'SocialNetwork', '일반 마케팅', '알 수 없음', '기타'입니다.

trafficSourceReferrer
trafficSourceReferrer string

알려진 경우 이 사용자의 원본입니다. 기존 사용자 조회를 통해 이 경우 참조자의 원래 MerchantUserId를 제공합니다.

trafficSourceReferralLink
trafficSourceReferralLink uri

알려진 경우 이 사용자의 원본입니다. 기존 사용자 조회 대신 다른 캠페인 유형을 통해 사용하는 경우 원본 URL 링크를 제공합니다.

trafficSourceReferralSite
trafficSourceReferralSite string

트래픽의 원본 사이트입니다. 가능한 값은 'Facebook', 'Instagram', 'Twitter', 'Bing', 'Google', 'Pinterest', 'WhatsApp' 등입니다.

incentiveType
incentiveType string

새 사용자의 인센티브 유형입니다. 가능한 값은 'None', 'CashBack', 'Discount', 'FreeTrial', 'BonusPoints', 'Gift', 'Unknown', 'Other'입니다.

incentiveOffer
incentiveOffer string

정확한 인센티브 제품 이름입니다. 예: 첫 번째 주문에 $5 할인, 무료 배송, 5000 포인트.

campaignStartDate
campaignStartDate date-time

인센티브 수집을 시작하는 캠페인 날짜입니다.

campaignEndDate
campaignEndDate date-time

인센티브 컬렉션의 캠페인 만료 날짜입니다.

incentiveQuantitiyLimit
incentiveQuantitiyLimit string

가맹점에서 설정한 인센티브 수량 한도입니다. 즉, 하루 사용자당 최대 5,000포인트입니다.

반환

Dynamics Fraud Protection API에 대한 응답 개체

계정 만들기 상태를 업데이트합니다.

이 이벤트는 계정 만들기의 상태(예: 계정 만들기가 취소된 경우)의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

이름
name True string

이벤트 이름입니다. 'AP여야 합니다. AccountCreation.Status'

version
version True string

페이로드 버전입니다. "0.5"여야 합니다.

trackingId
trackingId True string

계정 만들기 상태 이벤트의 식별자입니다.

signUpId
signUpId True string

계정 만들기 이벤트의 식별자입니다.

merchantTimeStamp
merchantTimeStamp True date-time

이벤트에 대한 TimeStamp입니다.

userId
userId True string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

statusType
statusType True string

상태 유형: '승인됨'|' 거부됨'|' 보류 중'.

reasonType
reasonType string

이유 유형: 'None'|' ChallengeAbandoned'|' ChallengeFailed'|' ChallengePassed'|' ChallengePending'|' ReviewFailed'|' ReviewPassed'|' ReviewPendinge'. 기본값은 'None'입니다.

challengeType
challengeType string

검토 상태 유형: 'SMS'|' 전자 메일'|' 전화'|' 기타'|' 없음'. 기본값은 'None'입니다.

statusDate
statusDate True date-time

상태가 적용된 날짜 및 시간입니다. ISO 8601 형식입니다.

반환

Dynamics Fraud Protection 성공 개체

계정 만들기 시도에 대한 위험 평가를 제공합니다.

이 이벤트는 들어오는 새 계정 만들기 시도에 대한 정보와 컨텍스트를 보냅니다. 응답에는 계정 만들기에 대한 결정이 포함됩니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

이름
name True string

이벤트 이름입니다. 'AP여야 합니다. AccountCreation'

version
version True string

페이로드 버전입니다. "0.5"여야 합니다.

trackingId
trackingId True string

계정 만들기 이벤트의 식별자입니다.

signUpId
signUpId True string

계정 만들기 이벤트의 식별자입니다. trackingId와 일치시킬 수 있습니다.

평가 유형
assessmentType string

이벤트에 대한 평가 유형을 나타냅니다. 가능한 값은 'Evaluate' | '보호'. 지정하지 않으면 기본값은 'Protect'입니다.

customerLocalDate
customerLocalDate True date-time

고객의 현지 표준 시간대에 있는 계정 만들기 이벤트의 생성 날짜입니다. ISO 8601 형식입니다.

merchantTimeStamp
merchantTimeStamp True date-time

이벤트에 대한 TimeStamp입니다.

deviceContextId
deviceContextId True string

DFP 디바이스 지문 서비스에서 제공하고 마스터하는 고객의 디바이스 ID입니다.

ipAddress
ipAddress string

고객의 IP 주소입니다.

provider
provider string

디바이스 정보의 공급자입니다. 가능한 값은 'DFPFingerprinting'|'입니다. 판매자'|' 알 수 없음'. 지정하지 않으면 기본값은 'DFPFingerprinting'입니다.

externalDeviceId
externalDeviceId string

가맹점에서 제공하고 마스터한 고객의 디바이스 ID입니다.

externalDeviceType
externalDeviceType string

가맹점에서 제공하고 마스터한 고객의 디바이스 유형입니다. 가능한 값은 'Mobile', 'Computer', 'MerchantHardware', 'Tablet', 'GameConsole'입니다.

userId
userId string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

사용자 유형
userType string

사용자의 프로필 유형입니다. 가능한 값은 'Consumer'|'입니다. 개발자'|' Seller'|' Publisher'|' 테넌트'.

사용자 이름
username True string

사용자가 제공한 사용자 이름입니다.

이름 (첫 번째 이름)
firstName string

계정에서 사용자가 제공한 이름입니다.

lastName
lastName string

계정에서 사용자가 제공한 성입니다.

countryRegion
countryRegion string

사용자의 CountryRegion입니다. 값은 두 글자 ISO CountryRegion 코드(예: 미국)여야 합니다.

zipCode
zipCode string

사용자의 우편 번호입니다.

timeZone
timeZone string

사용자의 표준 시간대입니다.

language
language string

사용자의 언어 및 지역(예: EN-US)입니다.

membershipId
membershipId string

사용자에게 이미 가맹점과 기존 멤버 자격이 있는 경우의 멤버 자격 ID입니다.

isMembershipIdUsername
isMembershipIdUsername boolean

membershipId는 사용자 이름으로 사용할 수 있으며 기본값은 False입니다.

phoneType
phoneType True string

값은 'Primary'|'입니다. 대체', 기본값은 'Primary'입니다.

전화번호
phoneNumber True string

사용자의 전화 번호입니다. 형식은 국가/지역 코드 다음에 하이픈(-) 및 전화 번호(예: 미국, +1-1234567890)여야 합니다.

isPhoneNumberValidated
isPhoneNumberValidated boolean

사용자가 제공한 전화 번호가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

phoneNumberValidatedDate
phoneNumberValidatedDate date-time

사용자 전화 번호의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

isPhoneUsername
isPhoneUsername boolean

전화 번호는 사용자 이름으로 사용할 수 있으며 기본값은 False입니다.

emailType
emailType True string

값은 'Primary', 'Alternative'입니다.

emailValue
emailValue True string

사용자의 전자 메일 주소입니다. 이 값은 대/소문자를 구분하지 않습니다.

isEmailValidated
isEmailValidated boolean

사용자가 제공한 전자 메일 주소가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

emailValidatedDate
emailValidatedDate date-time

사용자 전자 메일의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

isEmailUsername
isEmailUsername boolean

전자 메일은 사용자 이름으로 사용할 수 있으며 기본값은 False입니다.

authenticationProvider
authenticationProvider True string

가맹점과 다른 경우 사용자의 SSO(Single Sign-On) 인증 공급자입니다. 가능한 valuse는 'MSA'|'입니다. Facebook'|' PSN'|' MerchantAuth'|' 구글'.

표시 이름
displayName True string

가맹점과 다른 경우 사용자의 SSO(Single Sign-On) 인증 공급자입니다. 가능한 valuse는 'MSA'|'입니다. Facebook'|' PSN'|' MerchantAuth'|' 구글'.

addressType
addressType True string

주소 유형입니다. 값은 'Primary'|'입니다. 청구'|' 배송'|' 대안'. 기본값은 'Primary'입니다.

이름 (첫 번째 이름)
firstName string

주소와 연결된 사용자가 제공한 이름입니다.

lastName
lastName string

주소와 연결된 사용자가 제공한 성입니다.

전화번호
phoneNumber string

주소와 연결된 사용자가 제공한 전화 번호입니다.

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

countryRegion
countryRegion string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자 ISO CountryRegion 코드(예: 미국)여야 합니다.

merchantPaymentInstrumentId
merchantPaymentInstrumentId True string

결제 방법의 식별자입니다. 이 정보는 판매자가 제공합니다.

type
type True string

결제 유형입니다. 가능한 값은 'Other'|'입니다. CreditCard'|' DirectDebit'|' PayPal'|' MobileBilling'|' OnlineBankTransfer' |' 청구서 ' |' MerchantGiftCard'|' MerchantWallet'|' CashOnDelivery'|' Paytm'|' CCAvenue'.

생성일
creationDate date-time

가맹점 시스템의 결제 수단에 대한 첫 번째 항목의 날짜입니다. ISO 8601 형식입니다.

updateDate
updateDate date-time

가맹점 시스템의 결제 수단에 대한 마지막 업데이트 날짜입니다. creationDate보다 오래되어서는 안 됩니다. ISO 8601 형식입니다.

state string

가맹점 시스템에서 PI의 현재 상태입니다. 가능한 값은 'Active'|'입니다. 차단됨'|' 만료됨'

cardType
cardType string

이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다. 가능한 값은 'Visa'|'입니다. 마스터 카드'|' Amex'|' ACH'|' SEPA'|' UnionPay'|' Inicis'|' MobileBillingCarrier'|' 검색'|' AllPay'|' JCB ' |' DiscoverDiners'.

holderName
holderName string

결제 방법 사용자의 이름입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

bin string

신용/직불 카드 통입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

유효기간
expirationDate string

가맹점 시스템의 결제 수단에 대한 만료 날짜입니다. ISO 8601 형식입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

lastFourDigits
lastFourDigits string

신용/직불 카드의 마지막 4자리 숫자입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

addressType
addressType True string

주소 유형입니다. 값은 'Primary'|'입니다. 청구'|' 배송'|' 대안'. 기본값은 'Primary'입니다.

이름 (첫 번째 이름)
firstName string

주소와 연결된 사용자가 제공한 이름입니다.

lastName
lastName string

주소와 연결된 사용자가 제공한 성입니다.

전화번호
phoneNumber string

주소와 연결된 사용자가 제공한 전화 번호입니다.

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

countryRegion
countryRegion string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자 ISO CountryRegion 코드(예: 미국)여야 합니다.

메일 주소
email string

결제 수단과 연결된 이메일 주소입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다.

billingAgreementId
billingAgreementId string

이 특성은 PayPal 유형의 지불에만 사용됩니다.

payerId
payerId string

이 특성은 PayPal 유형의 지불에만 사용됩니다.

payerStatus
payerStatus string

PayPal 지불인을 확인했는지 여부를 나타내는 값입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다.

addressStatus
addressStatus string

PayPal 지불인의 주소를 확인했는지 여부를 나타내는 값입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다.

imei
imei string

이 특성은 Mobilepayment 유형의 결제에만 사용됩니다.

campaignType
campaignType string

마케팅 캠페인 유형입니다. 가능한 값은 '직접', '이메일', '추천', 'PaySearch', 'OrganicSearch', 'Advertising', 'SocialNetwork', '일반 마케팅', '알 수 없음', '기타'입니다.

trafficSourceReferrer
trafficSourceReferrer string

알려진 경우 이 사용자의 원본입니다. 기존 사용자 조회를 통해 이 경우 참조자의 원래 MerchantUserId를 제공합니다.

trafficSourceReferralLink
trafficSourceReferralLink uri

알려진 경우 이 사용자의 원본입니다. 기존 사용자 조회 대신 다른 캠페인 유형을 통해 사용하는 경우 원본 URL 링크를 제공합니다.

trafficSourceReferralSite
trafficSourceReferralSite string

트래픽의 원본 사이트입니다. 가능한 값은 'Facebook', 'Instagram', 'Twitter', 'Bing', 'Google', 'Pinterest', 'WhatsApp' 등입니다.

incentiveType
incentiveType string

새 사용자의 인센티브 유형입니다. 가능한 값은 'None', 'CashBack', 'Discount', 'FreeTrial', 'BonusPoints', 'Gift', 'Unknown', 'Other'입니다.

incentiveOffer
incentiveOffer string

정확한 인센티브 제품 이름입니다. 예: 첫 번째 주문에 $5 할인, 무료 배송, 5000 포인트.

campaignStartDate
campaignStartDate date-time

인센티브 수집을 시작하는 캠페인 날짜입니다.

campaignEndDate
campaignEndDate date-time

인센티브 컬렉션의 캠페인 만료 날짜입니다.

incentiveQuantitiyLimit
incentiveQuantitiyLimit string

가맹점에서 설정한 인센티브 수량 한도입니다. 즉, 하루 사용자당 최대 5,000포인트입니다.

반환

Dynamics Fraud Protection AccountCreate API에 대한 응답 개체

계정 보호를 위해 계정 정보를 업데이트합니다.

이 이벤트는 계정 보호 서비스에 대한 사용자 계정 정보(예: 결제 방법 추가, 주소 추가 또는 기타 사용자 특성)를 업데이트하거나 만듭니다. 데이터 수집 이벤트 전용입니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

사용자 ID
UserId True string

계정 업데이트에 대한 사용자 ID

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

이름
name True string

이벤트 이름입니다. 'AP여야 합니다. AccountUpdate'

version
version True string

페이로드 버전입니다. "0.5"여야 합니다.

trackingId
trackingId True string

계정 업데이트 이벤트의 식별자입니다.

accountUpdateId
accountUpdateId True string

계정 업데이트 이벤트의 식별자입니다. trackingId와 일치시킬 수 있습니다.

평가 유형
assessmentType string

이벤트에 대한 평가 유형을 나타냅니다. 가능한 값은 'Evaluate' | '보호'. 지정하지 않으면 기본값은 'Protect'입니다.

customerLocalDate
customerLocalDate True date-time

고객의 현지 표준 시간대에 있는 계정 업데이트 이벤트의 생성 날짜입니다. ISO 8601 형식입니다.

merchantTimeStamp
merchantTimeStamp True date-time

이벤트에 대한 TimeStamp입니다.

deviceContextId
deviceContextId True string

DFP 디바이스 지문 서비스에서 제공하고 마스터하는 고객의 디바이스 ID입니다.

ipAddress
ipAddress string

고객의 IP 주소입니다.

provider
provider string

디바이스 정보의 공급자입니다. 가능한 값은 'DFPFingerprinting'|'입니다. 판매자'|' 알 수 없음'. 지정하지 않으면 기본값은 'DFPFingerprinting'입니다.

externalDeviceId
externalDeviceId string

가맹점에서 제공하고 마스터한 고객의 디바이스 ID입니다.

externalDeviceType
externalDeviceType string

가맹점에서 제공하고 마스터한 고객의 디바이스 유형입니다. 가능한 값은 'Mobile', 'Computer', 'MerchantHardware', 'Tablet', 'GameConsole'입니다.

userId
userId string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

사용자 유형
userType string

사용자의 프로필 유형입니다. 가능한 값은 'Consumer'|'입니다. 개발자'|' Seller'|' Publisher'|' 테넌트'.

사용자 이름
username True string

사용자가 제공한 사용자 이름입니다.

이름 (첫 번째 이름)
firstName string

계정에서 사용자가 제공한 이름입니다.

lastName
lastName string

계정에서 사용자가 제공한 성입니다.

countryRegion
countryRegion string

사용자의 CountryRegion입니다. 값은 두 글자 ISO CountryRegion 코드(예: 미국)여야 합니다.

zipCode
zipCode string

사용자의 우편 번호입니다.

timeZone
timeZone string

사용자의 표준 시간대입니다.

language
language string

사용자의 언어 및 지역(예: EN-US)입니다.

membershipId
membershipId string

사용자에게 이미 가맹점과 기존 멤버 자격이 있는 경우의 멤버 자격 ID입니다.

isMembershipIdUsername
isMembershipIdUsername boolean

membershipId는 사용자 이름으로 사용할 수 있으며 기본값은 False입니다.

phoneType
phoneType True string

값은 'Primary'|'입니다. 대체', 기본값은 'Primary'입니다.

전화번호
phoneNumber True string

사용자의 전화 번호입니다. 형식은 국가/지역 코드 다음에 하이픈(-) 및 전화 번호(예: 미국, +1-1234567890)여야 합니다.

isPhoneNumberValidated
isPhoneNumberValidated boolean

사용자가 제공한 전화 번호가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

phoneNumberValidatedDate
phoneNumberValidatedDate date-time

사용자 전화 번호의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

isPhoneUsername
isPhoneUsername boolean

전화 번호는 사용자 이름으로 사용할 수 있으며 기본값은 False입니다.

emailType
emailType True string

값은 'Primary', 'Alternative'입니다.

emailValue
emailValue True string

사용자의 전자 메일 주소입니다. 이 값은 대/소문자를 구분하지 않습니다.

isEmailValidated
isEmailValidated boolean

사용자가 제공한 전자 메일 주소가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

emailValidatedDate
emailValidatedDate date-time

사용자 전자 메일의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

isEmailUsername
isEmailUsername boolean

전자 메일은 사용자 이름으로 사용할 수 있으며 기본값은 False입니다.

authenticationProvider
authenticationProvider True string

가맹점과 다른 경우 사용자의 SSO(Single Sign-On) 인증 공급자입니다. 가능한 valuse는 'MSA'|'입니다. Facebook'|' PSN'|' MerchantAuth'|' 구글'.

표시 이름
displayName True string

가맹점과 다른 경우 사용자의 SSO(Single Sign-On) 인증 공급자입니다. 가능한 valuse는 'MSA'|'입니다. Facebook'|' PSN'|' MerchantAuth'|' 구글'.

addressType
addressType True string

주소 유형입니다. 값은 'Primary'|'입니다. 청구'|' 배송'|' 대안'. 기본값은 'Primary'입니다.

이름 (첫 번째 이름)
firstName string

주소와 연결된 사용자가 제공한 이름입니다.

lastName
lastName string

주소와 연결된 사용자가 제공한 성입니다.

전화번호
phoneNumber string

주소와 연결된 사용자가 제공한 전화 번호입니다.

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

countryRegion
countryRegion string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자 ISO CountryRegion 코드(예: 미국)여야 합니다.

merchantPaymentInstrumentId
merchantPaymentInstrumentId True string

결제 방법의 식별자입니다. 이 정보는 판매자가 제공합니다.

type
type True string

결제 유형입니다. 가능한 값은 'Other'|'입니다. CreditCard'|' DirectDebit'|' PayPal'|' MobileBilling'|' OnlineBankTransfer' |' 청구서 ' |' MerchantGiftCard'|' MerchantWallet'|' CashOnDelivery'|' Paytm'|' CCAvenue'.

생성일
creationDate date-time

가맹점 시스템의 결제 수단에 대한 첫 번째 항목의 날짜입니다. ISO 8601 형식입니다.

updateDate
updateDate date-time

가맹점 시스템의 결제 수단에 대한 마지막 업데이트 날짜입니다. creationDate보다 오래되어서는 안 됩니다. ISO 8601 형식입니다.

state string

가맹점 시스템에서 PI의 현재 상태입니다. 가능한 값은 'Active'|'입니다. 차단됨'|' 만료됨'

cardType
cardType string

이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다. 가능한 값은 'Visa'|'입니다. 마스터 카드'|' Amex'|' ACH'|' SEPA'|' UnionPay'|' Inicis'|' MobileBillingCarrier'|' 검색'|' AllPay'|' JCB ' |' DiscoverDiners'.

holderName
holderName string

결제 방법 사용자의 이름입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

bin string

신용/직불 카드 통입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

유효기간
expirationDate string

가맹점 시스템의 결제 수단에 대한 만료 날짜입니다. ISO 8601 형식입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

lastFourDigits
lastFourDigits string

신용/직불 카드의 마지막 4자리 숫자입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

addressType
addressType True string

주소 유형입니다. 값은 'Primary'|'입니다. 청구'|' 배송'|' 대안'. 기본값은 'Primary'입니다.

이름 (첫 번째 이름)
firstName string

주소와 연결된 사용자가 제공한 이름입니다.

lastName
lastName string

주소와 연결된 사용자가 제공한 성입니다.

전화번호
phoneNumber string

주소와 연결된 사용자가 제공한 전화 번호입니다.

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

countryRegion
countryRegion string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자 ISO CountryRegion 코드(예: 미국)여야 합니다.

메일 주소
email string

결제 수단과 연결된 이메일 주소입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다.

billingAgreementId
billingAgreementId string

이 특성은 PayPal 유형의 지불에만 사용됩니다.

payerId
payerId string

이 특성은 PayPal 유형의 지불에만 사용됩니다.

payerStatus
payerStatus string

PayPal 지불인을 확인했는지 여부를 나타내는 값입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다.

addressStatus
addressStatus string

PayPal 지불인의 주소를 확인했는지 여부를 나타내는 값입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다.

imei
imei string

이 특성은 Mobilepayment 유형의 결제에만 사용됩니다.

반환

Dynamics Fraud Protection 성공 개체

계정 보호를 위해 사기 레이블 정보를 업데이트합니다.

이 이벤트는 레이블의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

사용자 ID
UserId True string

레이블 Api의 사용자 ID

Contect 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

이름
name True string

이벤트 이름입니다. 'AP여야 합니다. 레이블'

version
version True string

페이로드 버전입니다. "0.5"여야 합니다.

trackingId
trackingId True string

각 이벤트/레코드의 고유 ID입니다.

userId
userId True string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

merchantTimeStamp
merchantTimeStamp True date-time

이벤트에 대한 TimeStamp입니다.

eventTimeStamp
eventTimeStamp True date-time

이벤트의 날짜 및 시간입니다. 가능한 값: 차지백 날짜 또는 검토 날짜입니다. ISO 8601 형식입니다.

labelObjectType
labelObjectType True string

이 필드는 레이블의 유형을 나타냅니다. '구매'|' AccountCreation'|' AccountLogin'|' AccountUpdate'|' CustomFraudEvaluation'|' 계정'|' PaymentInstrument'|' 전자 메일'.

labelObjectId
labelObjectId True string

개체의 식별자 필드인 PurchaseId, AccountCreationId, AccountLoginId, AccountUpdateId, UserId, MerchantPaymentInstrumentId 또는 Email입니다.

labelSource
labelSource string

이 필드는 레이블의 원본을 나타냅니다. 'CustomerEscalation'|' 차지백'|' TC40_SAFE'|' ManualReview'|' 환불'|' OfflineAnalysis'|' AccountProtectionReview'.

labelState
labelState True string

이 필드는 레이블의 현재 상태를 나타냅니다. 'InquiryAccepted'|' 사기'|' 이의 제기'|' 역방향'|' 학대'|' ResubmittedRequest'|' AccountCompromised'|' AccountNotCompromised'.

labelReasonCode
labelReasonCode string

이 필드는 'ProcessorResponseCode'|' 레이블의 각 형식과 연결된 이유 코드를 나타냅니다. BankResponseCode'|' FraudRefund'|' AccountTakeOver'|' PaymentInstrumentFraud'|' AccountFraud'|' 학대'|' FriendlyFraud'|' AccountCredentialsLeaked'|' PassedAccountProtectionChecks'

프로세서
processor string

TC40 또는 SAFE 정보를 생성하는 은행 또는 결제 프로세서의 이름입니다.

유효 시작일
effectiveStartDate date-time

이 레이블이 적용되는 날짜입니다. ISO 8601 형식입니다.

유효 종료 날짜
effectiveEndDate date-time

이 레이블의 종료 날짜입니다. ISO 8601 형식입니다. effectiveStartDate보다 오래되어서는 안 됩니다.

반환

Dynamics Fraud Protection 성공 개체

구매 보호를 위해 계정 정보를 업데이트합니다.

이 이벤트는 구매 보호 서비스(예: 결제 방법 추가, 주소 추가 또는 기타 사용자 특성)에 대한 사용자 계정 정보를 업데이트하거나 만듭니다. 데이터 수집 이벤트 전용입니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

userId
userId True string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

생성일
creationDate date-time

사용자 계정의 생성 날짜입니다. ISO 8601 형식입니다.

updateDate
updateDate date-time

사용자 데이터가 마지막으로 변경된 날짜입니다. ISO 8601 형식입니다.

이름 (첫 번째 이름)
firstName string

계정에서 사용자가 제공한 이름입니다.

lastName
lastName string

계정에서 사용자가 제공한 성입니다.

country
country string

사용자의 국가 또는 지역입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

zipCode
zipCode string

사용자의 우편 번호입니다.

timeZone
timeZone string

사용자의 표준 시간대입니다.

language
language string

사용자의 언어 및 지역(예: EN-US)입니다.

전화번호
phoneNumber string

사용자의 전화 번호입니다. 형식은 국가/지역 코드 다음에 하이픈(-) 및 전화 번호(예: 미국, +1-1234567890)여야 합니다.

메일 주소
email string

사용자의 전자 메일 주소입니다. 이 값은 대/소문자를 구분하지 않습니다.

membershipId
membershipId string

사용자에게 이미 가맹점과 기존 멤버 자격이 있는 경우의 멤버 자격 ID입니다.

프로필 유형
profileType string

사용자의 프로필 유형입니다. 가능한 값 'Consumer' | 'Seller' | 'Publisher' | 'Tenant' | '개발자'

profileName
profileName string

profileType에 따라 프로필 이름입니다.

authenticationProvider
authenticationProvider string

사용자의 인증 공급자(가맹점과 다른 경우)입니다. 가능한 valuse 'MSA' | 'Facebook' | 'PSN' | 'MerchantAuth' | 'Google'

인증 방법
authenticationMethod string

구매 전/구매 중에 고객이 인증된 방식입니다. 몇 가지 가능한 값은 PASSWORD-BASED, MULTI-FACTOR, BIOMETRIC, TOKEN-BASED,

표시 이름
displayName string

사용자의 표시 이름입니다. 예: Xbox 게이머태그 값

isEmailValidated
isEmailValidated boolean

사용자가 제공한 전자 메일 주소가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

emailValidatedDate
emailValidatedDate date-time

사용자 전자 메일의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

isPhoneNumberValidated
isPhoneNumberValidated boolean

사용자가 제공한 전화 번호가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

phoneNumberValidatedDate
phoneNumberValidatedDate date-time

사용자 전화 번호의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

membershipType
membershipType string

고객의 멤버 자격 상태 또는 유형입니다. 프리미엄, 이그제큐티브 등 다양한 수준의 유료를 지정할 수 있습니다. 가능한 값은 FREE, PAY, PREMIUM입니다.

loginInputMethod
loginInputMethod string

고객이 자격 증명을 입력하는 방식입니다. 가능한 값은 MANUALINPUT, AUTOFILL, SCRIPT, COPYPASTE, SELECTPROFILE입니다.

lastPasswordUpdatedDate
lastPasswordUpdatedDate date-time

고객의 암호가 마지막으로 업데이트된 경우

firstPurchaseDate
firstPurchaseDate date-time

고객이 처음 구매한 경우

loginChallengeType
loginChallengeType string

시작된 챌린지-응답 테스트의 유형입니다. 가능한 값은 텍스트 SMS, 전화 SMS, 전자 메일 PIN, CAPTCHA입니다.

type
type string

가능한 값 'Shipping' | '청구' | '등록'

이름 (첫 번째 이름)
firstName string

주소와 연결된 사용자가 제공한 이름입니다.

lastName
lastName string

주소와 연결된 사용자가 제공한 성입니다.

전화번호
phoneNumber string

주소와 연결된 사용자가 제공한 전화 번호입니다.

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

merchantPaymentInstrumentId
merchantPaymentInstrumentId string

결제 방법의 식별자입니다. 이 정보는 판매자가 제공합니다.

결제 수단
paymentMethod string

최상위 결제 방법 범주입니다. 가능한 값은 카드, 현금, DIRECTDEBIT, E-WALLET, MOBILE, E-BANKING, 청구서, 바우처입니다.

type
type True string

결제 유형입니다. 가능한 값 'CreditCard' | 'DirectDebit' | 'PayPal' | 'MobileBilling' | 'OnlineBankTransfer' | 'Invoice' | 'MerchantGiftCard' | 'MerchantWallet' | 'CashOnDelivery' | 'Paytm' | 'CCAvenue'

생성일
creationDate date-time

가맹점 시스템의 결제 수단에 대한 첫 번째 항목의 날짜입니다. ISO 8601 형식입니다.

updateDate
updateDate date-time

가맹점 시스템의 결제 수단에 대한 마지막 업데이트 날짜입니다. ISO 8601 형식입니다.

paymentCheckoutProvider
paymentCheckoutProvider string

eWallet 체크 아웃 공급자입니다.

isLowLiabilityPIType
isLowLiabilityPIType boolean

결제 방법이 낮은 책임인지 여부를 나타내는 True/False 값입니다.

state string

가맹점 시스템에서 PI의 현재 상태입니다. 가능한 값 'Active' | '비활성'

cardType
cardType string

이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다. 카드가 제공되는 네트워크입니다. 가능한 값 'Visa' | '마스터 카드' | 'Amex' | 'ACH' | 'SEPA' | 'UnionPay' | 'Inicis' | 'MobileBillingCarrier' | 'Discover' | 'AllPay' | 'JCB' | 'DiscoverDiners'

holderName
holderName string

결제 방법 사용자의 이름입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

holderCompanyName
holderCompanyName string

비즈니스 또는 회사 카드를 제공하는 조직의 이름입니다(비즈니스 구매에만 해당).

settlementApprovalRequired
settlementApprovalRequired boolean

SEPA 트랜잭션에 승인이 필요한지 여부를 나타내는 True/False 값입니다.

bin string

이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

binName
binName string

BIN 표시 이름입니다.

binCountryISO
binCountryISO string

BIN과 연결된 ISO 국가 코드입니다.

binCardType
binCardType string

BIN 카드 유형입니다. 가능한 값은 DEBIT, CREDIT, PREPAID, FLEET, CREDITDEBIT입니다.

binCardAssociation
binCardAssociation string

BIN 카드 연결입니다. 몇 가지 가능한 값은 VISA, MASTERCARD, AMEX, DISCOVER, MAESTRO, JCB, UNIONPAY, DINERSCLUB입니다.

binBankGroup
binBankGroup string

BIN 은행 그룹입니다.

유효기간
expirationDate string

가맹점 시스템의 결제 수단에 대한 만료 날짜입니다. ISO 8601 형식입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

lastFourDigits
lastFourDigits string

이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

메일 주소
email string

결제 수단과 연결된 이메일 주소입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다.

billingAgreementId
billingAgreementId string

이 특성은 PayPal 유형의 지불에만 사용됩니다.

payerId
payerId string

이 특성은 PayPal 유형의 지불에만 사용됩니다.

payerStatus
payerStatus string

PayPal 지불인을 확인했는지 여부를 나타내는 값입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다. 가능한 값 '확인됨' | '확인되지 않음'

addressStatus
addressStatus string

PayPal 지불인의 주소를 확인했는지 여부를 나타내는 값입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다. 가능한 값 'Confirmed' | '확인되지 않음'

imei
imei string

이 특성은 Mobilepayment 유형의 결제에만 사용됩니다.

currency
currency string

선택한 결제 수단의 통화 코드입니다.

isInternationalMoneyTransfer
isInternationalMoneyTransfer boolean

국제 송금이 발생했는지 여부를 나타내는 True/False 값입니다.

bankIdentifierCode
bankIdentifierCode string

은행 식별자 코드(BIC 또는 SWIFT 코드)

bankName
bankName string

은행 이름

bankZipCode
bankZipCode string

은행 우편 번호

bankState
bankState string

은행 주

bankCountryISO
bankCountryISO string

은행 ISO 국가

paymentCollectionDate
paymentCollectionDate date-time

결제 수금의 예상 날짜입니다(주로 결제 서비스 공급자에 사용됨).

instantPaymentSettlement
instantPaymentSettlement boolean

은행 리디렉션을 나타내는 True/False 값입니다(CSV 결제를 지원하는 데 사용됨).

autoCaptureEnabled
autoCaptureEnabled boolean

카드 결제를 위해 결제가 자동으로 캡처되었는지 여부를 나타내는 True/False 값입니다. 리디렉션 지불의 경우 이것은 단순히 자동으로 자금을 인출할지 여부를 파트너 은행에 나타내는 지표입니다.

계정 유형
accountType string

트랜잭션에 대해 청구할 계정 유형을 나타냅니다. UNSPECIFIED가 기본값입니다. CHEQUE_ACCOUNT 카드를 직불 카드로 사용합니다. CREDIT_FACILITY 카드를 신용 카드로 사용합니다.

authorizationType
authorizationType string

권한 부여 유형입니다. 마스터카드와 비자는 이제 판매자가 권한 부여 시도를 사전 승인 또는 최종 권한 부여로 정의하도록 요구합니다. 가능한 값은 PRE_AUTHORIZATION, FINAL_AUTHORIZATION

authorizationResultCode
authorizationResultCode string

권한 부여 결정의 은행 응답입니다. 가능한 값은 APPROVE, DECLINE, PENDING입니다.

authorizationResultText
authorizationResultText string

권한 부여 결정에 대한 이유; 특히 거부되거나 보류 중인 트랜잭션의 경우 가능한 값은 MISMATCH_CVV, MISMATCH_ADDRESS, MISMATCH_EXPIRATIONDATE, NOACCOUNT, INVALIDPIN, LOWFUND, OVERLIMIT SUSPICIOUSACCOUNT입니다.

acquirerId
acquirerId string

기관 식별 코드 획득

acquirerCountryISO
acquirerCountryISO string

기관 국가 코드 획득

cvvVerify
cvvVerify string

CVV 확인을 사용할 수 있는지 여부 및/또는 원활하게 확인할 수 있는지 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

avsVerify
avsVerify string

추가 기능 확인을 사용할 수 있는지 여부 및/또는 sucessfully 확인 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

cavVerify
cavVerify string

카드 소유자 인증 확인을 사용할 수 있는지 여부 및/또는 sucessfully 확인 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

piInputMethod
piInputMethod string

N/A

encryptedCreditCardNumber
encryptedCreditCardNumber string

해시되거나 암호화된 신용 카드 번호입니다.

이름 (첫 번째 이름)
firstName string

주소와 함께 제공된 이름

lastName
lastName string

주소와 함께 제공된 성

전화번호
phoneNumber string

주소와 함께 제공되는 전화 번호

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

deviceContextId
deviceContextId True string

고객의 지문 세션 ID 또는 세션을 사용할 수 없는 경우 이벤트 ID입니다.

ipAddress
ipAddress string

고객의 IP 주소(판매자가 제공)

provider
provider string

디바이스 정보의 공급자입니다. 가능한 값은 'DFPFingerPrinting' | '상인'. DFP 지문 JS 스크립트를 사용하는 경우 모든 데이터가 제대로 연결되려면 'DFPFingerPrinting'을 전달해야 합니다.

deviceContextDC
deviceContextDC string

사용되지 않음: DFP 지문에 더 이상 필요하지 않습니다. 고객의 DFP 지문 세션(DFP 지문 JS 스크립트에서 제공)을 저장하는 데이터 센터입니다.

externalDeviceId
externalDeviceId string

가맹점에서 제공하고 마스터한 고객의 디바이스 ID입니다.

externalDeviceType
externalDeviceType string

가맹점에서 제공하고 마스터한 고객의 디바이스 유형입니다. 가능한 값 'Mobile' | 'Computer' | 'MerchantHardware' | 'Tablet' | 'GameConsole'

trackingId
trackingId string

이벤트에 대한 TrackingId

merchantTimeStamp
merchantTimeStamp date-time

이벤트에 대한 TimeStamp

반환

결과 세부 정보

구매 보호를 위해 사기 레이블 정보를 업데이트합니다.

이 이벤트는 레이블의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

labelObjectType
labelObjectType True string

이 레이블 엔터티가 적용되는 EntityName입니다. 전자 메일로 설정하면 사용자 ID가 Email LabelObjectId에서 조회됩니다. 가능한 값은 PURCHASE, SIGNUP, CUSTOMFRAUDEVALUATION, ACCOUNT, PI, EMAIL입니다.

labelObjectId
labelObjectId True string

이 레이블 엔터티가 적용되는 LabelObjectType 내의 ID 값입니다.

labelSource
labelSource string

이 레이블의 LabelReasonCodes 또는 LabelState를 발급하는 기관입니다. 가능한 값 'CustomerEscalation' | 'Chargeback' | 'TC40_SAFE' | 'ManualReview' | '환불' | 'OfflineAnalysis'

labelReasonCodes
labelReasonCodes string
labelState
labelState string

LabelSource에 상태 전환이 있는 경우 이 레이블의 현재 상태입니다. 예: 이전 사기 의혹이 지워졌다는 것을 의미하는 "수락". 가능한 값 'Inquiry' | '수락됨' | '사기' | '이의 제기' | 'Reversed' | 'ResubmittedRequest'

프로세서
processor string

LabelReasonCodes를 발급하는 특정 LabelSource 기관입니다.

eventTimeStamp
eventTimeStamp date-time

LabelSource/Processor에서 보고된 이벤트의 최종 생성입니다. 형식이 ISO8601.

유효 시작일
effectiveStartDate date-time

이 레이블이 가맹점 표준 시간대에 적용되는 경우의 시작입니다(MerchantLocalDate와 다른 경우). 형식이 ISO8601.

유효 종료 날짜
effectiveEndDate date-time

이 레이블이 가맹점 표준 시간대에 적용되는 경우의 끝 또는 해당되지 않거나 확정되지 않은 경우 null입니다. 형식이 ISO8601.

분량
amount double

이 레이블이 관련한 금액(예: 부분 환불)입니다. 통화 필드에 지정된 단위입니다.

currency
currency string

금액이 있는 통화(예: "USD")

trackingId
trackingId string

이벤트에 대한 TrackingId

merchantTimeStamp
merchantTimeStamp date-time

이벤트에 대한 TimeStamp

반환

결과 세부 정보

사용자 지정 이벤트에 대한 위험 평가를 제공합니다.

이 이벤트를 사용하면 규칙 평가를 위해 선택한 조건에 따라 트리거되는 자체 선택 구조를 보낼 수 있습니다. 응답에는 이벤트에 대한 결정이 포함됩니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

평가 API 이름
assessment-api-name True string

평가의 api 이름

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

이름
name True string

평가 이벤트 이름입니다. 이름은 평가를 만드는 동안 API 이름과 URL의 '{assessment-API-name}과 일치해야 합니다.

version
version True string

페이로드 버전입니다. "1.0"이어야 합니다.

trackingId
trackingId True string

계정 만들기 이벤트의 식별자입니다.

merchantTimeStamp
merchantTimeStamp True date-time

이벤트에 대한 TimeStamp입니다.

userId
userId string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

countryRegion
countryRegion string

사용자의 CountryRegion입니다. 값은 두 글자 ISO CountryRegion 코드(예: 미국)여야 합니다.

zipCode
zipCode string

사용자의 우편 번호입니다.

timeZone
timeZone string

사용자의 표준 시간대입니다.

language
language string

사용자의 언어 및 지역(예: EN-US)입니다.

sampleString
sampleString string

사용자 유형을 확장할 수 있는 방법의 예입니다.

isEmployee
isEmployee boolean

기본 형식의 예입니다.

분량
amount integer

예제 필드입니다.

available
available integer

예제 필드입니다.

반환

Dynamics Fraud Protection API에 대한 응답 개체

업데이트 확인 사기 정보

이 이벤트는 고객이 자신의 은행에 사기로 이의를 제기한 이전 구매에 대한 정보를 보냅니다. 데이터 수집 이벤트입니다. 많은 가맹점이 대량 데이터 업로드를 사용하여 이러한 이벤트를 보냅니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

chargebackId
chargebackId True string

이 차지백 이벤트를 식별하는 고유 문자열

이유
reason string

은행에서 제공하는 이유

status
status string

가능한 값 'Inquiry' | '수락됨' | '이의 제기' | 'Reversed' | 'ResubmittedRequest'

bankEventTimestamp
bankEventTimestamp date-time

은행의 타임스탬프

분량
amount double

차지백 금액

currency
currency string

차지백 금액에 사용되는 통화입니다.

purchaseId
purchaseId True string

원래 구매 ID

userId
userId string

사용자를 식별하는 고유 문자열

trackingId
trackingId string

이벤트에 대한 TrackingId

merchantTimeStamp
merchantTimeStamp date-time

이벤트에 대한 TimeStamp

반환

결과 세부 정보

온라인 구매 트랜잭션에 대한 위험 평가 제공

이 이벤트는 들어오는 새 구매 트랜잭션에 대한 정보와 컨텍스트를 보냅니다. 응답에는 구매 거래를 승인하거나 거부하는 결정과 가맹점이 은행에 인증 호출을 통해 보내야 하는 적절한 MID(가맹점 ID)가 포함됩니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

purchaseId
purchaseId True string

가맹점 시스템의 트랜잭션(또는 구매/주문) 식별자입니다.

평가 유형
assessmentType string

이벤트에 대한 평가 유형을 나타냅니다. 가능한 값은 'Evaluate' 또는 'Protect'입니다. 지정하지 않으면 기본값은 'Protect'입니다.

originalOrderId
originalOrderId string

월간 구독과 같은 반복 청구에 대한 결제에 대한 가맹점 시스템의 원래 주문 식별자입니다.

customerLocalDate
customerLocalDate date-time

고객 현지 표준 시간대에 따라 구매 생성 날짜입니다. 형식이 ISO8601

merchantLocalDate
merchantLocalDate True date-time

판매자 표준 시간대에 따라 구매 생성 날짜입니다. 형식이 ISO8601

merchantIdentifier
merchantIdentifier string

은행의 MID(가맹점 식별자)

merchantCategoryCode
merchantCategoryCode string

은행의 MCC(가맹점 범주 코드)

merchantBusinessType
merchantBusinessType string

이 구매에 대한 가맹점 비즈니스 유형

merchantBusinessSegment
merchantBusinessSegment string

이 구매를 위한 가맹점 비즈니스 세그먼트

isTest
isTest boolean

구매가 테스트 구매임을 나타냅니다.

isFreeProductIncluded
isFreeProductIncluded boolean

무료 제품이 이 구매의 일부인지를 나타냅니다.

isRecurringCharge
isRecurringCharge boolean

구매가 반복 요금인지를 나타냅니다.

isGuestCheckout
isGuestCheckout boolean

gueest 체크 아웃을 통해 구매가 이루어지고 있는지 여부를 나타냅니다.

isPostAuthCheck
isPostAuthCheck boolean

구매가 은행 인증 후 DFP로 전송되는지를 나타냅니다.

isRetryOrder
isRetryOrder boolean

구매가 이전에 실패한 시도의 재시도인지를 나타냅니다.

recurringChargeFrequencyInDays
recurringChargeFrequencyInDays integer

요금이 재귀된 후의 일 수

recurringChargeStartDate
recurringChargeStartDate date-time

이 구매의 시작 날짜(되풀이되는 경우)

recurringChargeEndDate
recurringChargeEndDate date-time

이 구매의 종료 날짜(되풀이되는 경우)

isPostpaid
isPostpaid boolean

구매가 유료인지를 나타냅니다.

distinctItemCount
distinctItemCount double

구매의 일부로 판매된 고유 제품 수

totalItemCount
totalItemCount double

구매의 일부로 판매된 총 제품 수

orderType
orderType string

순서 유형(예: 테이크아웃)

discountAmount
discountAmount double

총 금액을 파생하기 전에 원래 구매 시 제공된 할인

tipAmount
tipAmount double

구매 시 제공되는 팁

totalAmount
totalAmount double

고객에게 청구되는 총 금액입니다. 세금 및 배송이 포함됩니다. 할인 및 쿠폰은 선택적으로 포함할 수 있습니다. 현재 별도의 필드가 없습니다. 판매자가 제공합니다.

판매세
salesTax double

거래에 대해 부과된 판매세입니다. 판매자가 제공합니다.

currency
currency string

ISO 4217 코드 형식(USD, GBP 등)의 원래 구매 통화입니다.

shippingMethod
shippingMethod string

구매를 배송하는 데 사용되는 방법을 나타냅니다. 가능한 값 'InStorePickup' | 'Standard' | 'Express' | 'DirectEntitlement' | 'DigitalToken'

transactionProcessingOrder
transactionProcessingOrder string

트랜잭션 흐름 중에 사기 평가를 수행한 순서입니다. 가능한 값은 사전 인증, POSTAUTHORIZATION, BEFORE3DS, AFTER3DS

recurringSubscriptionId
recurringSubscriptionId string

되풀이 요금의 고유 ID

recurringChargeSequence
recurringChargeSequence string

이 고객에 대해 되풀이 요금이 발생한 시간(1, 2, 3...)입니다.

midName
midName string

MID(가맹점 식별자)와 연결된 가맹점 이름입니다.

transactionDescription
transactionDescription string

트랜잭션 처리 유형입니다. Possilbe 값은 SUBSCRIPTIONFEE, DELAYEDCHARGES, NOSHOW, DEPOSIT입니다.

shippingEmail
shippingEmail string

사용자의 배송 전자 메일 주소

사용자 정의 데이터
customData object

규칙 등을 사용하기 위해 전달할 수 있는 키-값 쌍입니다. https://docs.microsoft.com/dynamics365/fraud-protection/schema#download-sample-data에서 자세히 알아보세요.

shippingDate
shippingDate date-time

주문이 배송된 날짜입니다.

orderInitiatedChannel
orderInitiatedChannel string

트랜잭션이 만들어진 채널(예: 'AppStore', 'Web', 'MobileWeb', 'App', 'InGamePurchase')

orderInitiatedChannelName
orderInitiatedChannelName string

트랜잭션이 만들어진 앱 이름 또는 웹 URL

orderInitiatedChannelRegionORCountry
orderInitiatedChannelRegionORCountry string

트랜잭션이 만들어진 시장(예: 앱 마켓)

merchantBusinessSegmentL2
merchantBusinessSegmentL2 string

두 번째 수준 비즈니스 또는 산업 부문

lastUpdateYear
lastUpdateYear integer

항목이 마지막으로 업데이트된 연도

userId
userId True string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

생성일
creationDate date-time

사용자 계정의 생성 날짜입니다. ISO 8601 형식입니다.

updateDate
updateDate date-time

사용자 데이터가 마지막으로 변경된 날짜입니다. ISO 8601 형식입니다.

이름 (첫 번째 이름)
firstName string

계정에서 사용자가 제공한 이름입니다.

lastName
lastName string

계정에서 사용자가 제공한 성입니다.

country
country string

사용자의 국가 또는 지역입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

zipCode
zipCode string

사용자의 우편 번호입니다.

timeZone
timeZone string

사용자의 표준 시간대입니다.

language
language string

사용자의 언어 및 지역(예: EN-US)입니다.

전화번호
phoneNumber string

사용자의 전화 번호입니다. 형식은 국가/지역 코드 다음에 하이픈(-) 및 전화 번호(예: 미국, +1-1234567890)여야 합니다.

메일 주소
email string

사용자의 전자 메일 주소입니다. 이 값은 대/소문자를 구분하지 않습니다.

membershipId
membershipId string

사용자에게 이미 가맹점과 기존 멤버 자격이 있는 경우의 멤버 자격 ID입니다.

프로필 유형
profileType string

사용자의 프로필 유형입니다. 가능한 값 'Consumer' | 'Seller' | 'Publisher' | 'Tenant' | '개발자'

profileName
profileName string

profileType에 따라 프로필 이름입니다.

authenticationProvider
authenticationProvider string

사용자의 인증 공급자(가맹점과 다른 경우)입니다. 가능한 valuse 'MSA' | 'Facebook' | 'PSN' | 'MerchantAuth' | 'Google'

인증 방법
authenticationMethod string

구매 전/구매 중에 고객이 인증된 방식입니다. 몇 가지 가능한 값은 PASSWORD-BASED, MULTI-FACTOR, BIOMETRIC, TOKEN-BASED,

표시 이름
displayName string

사용자의 표시 이름입니다. 예: Xbox 게이머태그 값

isEmailValidated
isEmailValidated boolean

사용자가 제공한 전자 메일 주소가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

emailValidatedDate
emailValidatedDate date-time

사용자 전자 메일의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

isPhoneNumberValidated
isPhoneNumberValidated boolean

사용자가 제공한 전화 번호가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

phoneNumberValidatedDate
phoneNumberValidatedDate date-time

사용자 전화 번호의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

membershipType
membershipType string

고객의 멤버 자격 상태 또는 유형입니다. 프리미엄, 이그제큐티브 등 다양한 수준의 유료를 지정할 수 있습니다. 가능한 값은 FREE, PAY, PREMIUM입니다.

loginInputMethod
loginInputMethod string

고객이 자격 증명을 입력하는 방식입니다. 가능한 값은 MANUALINPUT, AUTOFILL, SCRIPT, COPYPASTE, SELECTPROFILE입니다.

lastPasswordUpdatedDate
lastPasswordUpdatedDate date-time

고객의 암호가 마지막으로 업데이트된 경우

firstPurchaseDate
firstPurchaseDate date-time

고객이 처음 구매한 경우

loginChallengeType
loginChallengeType string

시작된 챌린지-응답 테스트의 유형입니다. 가능한 값은 텍스트 SMS, 전화 SMS, 전자 메일 PIN, CAPTCHA입니다.

deviceContextId
deviceContextId True string

고객의 지문 세션 ID 또는 세션을 사용할 수 없는 경우 이벤트 ID입니다.

provider
provider string

디바이스 정보의 공급자입니다. 가능한 값은 'DFPFingerPrinting' | '상인'. DFP 지문 JS 스크립트를 사용하는 경우 모든 데이터가 제대로 연결되려면 'DFPFingerPrinting'을 전달해야 합니다.

deviceContextDC
deviceContextDC string

사용되지 않음: DFP 지문에 더 이상 필요하지 않습니다. 고객의 DFP 지문 세션(DFP 지문 JS 스크립트에서 제공)을 저장하는 데이터 센터입니다.

externalDeviceId
externalDeviceId string

가맹점에서 제공하고 마스터한 고객의 디바이스 ID입니다.

externalDeviceType
externalDeviceType string

가맹점에서 제공하고 마스터한 고객의 디바이스 유형입니다. 가능한 값 'Mobile' | 'Computer' | 'MerchantHardware' | 'Tablet' | 'GameConsole'

ipAddress
ipAddress string

고객의 IP 주소(판매자가 제공)

httpSignature
httpSignature string

HTTP 메시지의 디지털 서명입니다.

httpUserAgent
httpUserAgent string

애플리케이션, 운영 체제, 공급업체 및/또는 버전을 식별하는 데 사용되는 요청 헤더입니다.

browserHeader
browserHeader string

브라우저에서 보낸 요청 헤더의 전체 목록입니다.

browserResolution
browserResolution string

브라우저 해상도입니다.

browserLanguage
browserLanguage string

브라우저 기본 언어 기본 설정입니다.

tcpSignature
tcpSignature string

TCP 애플리케이션 서명입니다.

sslSignature
sslSignature string

SSL 서명입니다.

enabledCookies
enabledCookies boolean

쿠키를 사용할 수 있는지 여부를 나타내는 True/False 값입니다.

enabledFlash
enabledFlash boolean

Flash를 사용할 수 있는지 여부를 나타내는 True/False 값입니다.

enabledJavaScript
enabledJavaScript boolean

Javascript를 사용할 수 있는지 여부를 나타내는 True/False 값입니다.

screenAspectRatio
screenAspectRatio string

브라우저의 가로 세로 비율입니다.

screenColorDepth
screenColorDepth string

화면의 색 깊이입니다.

screenResolution
screenResolution string

픽셀 단위의 디바이스 화면 해상도

siteHostName
siteHostName string

사이트의 호스트 이름입니다.

운영 체제
os string

디바이스 운영 체제입니다.

oSFonts
oSFonts string

운영 체제의 기본 글꼴입니다.

deviceProcessor
deviceProcessor string

디바이스 프로세서입니다.

세션 ID
sessionId string

고유한 세션 ID입니다.

trueIp
trueIp string

디바이스 지문으로 식별된 디바이스의 진정한 IP 주소

proxyIp
proxyIp string

프록시 디바이스의 IP 주소입니다.

deviceId
deviceId string

디바이스 지문으로 생성된 디바이스당 고유 GUID

timeZone
timeZone string

GMT와 관련하여 현지 표준 시간대의 오프셋(시간)

userAgentDetails
userAgentDetails string

추가 사용자 에이전트 또는 브라우저 세부 정보입니다.

appVersion
appVersion string

애플리케이션 버전입니다.

browserPackagesList
browserPackagesList string

디바이스에 설치된 패키지 목록입니다.

buildManufacturer
buildManufacturer string

디바이스의 제조업체입니다.

buildModel
buildModel string

최종 제품의 최종 사용자 바이시빌 이름입니다.

buildSdkVersion
buildSdkVersion string

빌드 버전입니다.

dataNetworkType
dataNetworkType string

모바일 데이터 네트워크의 유형입니다.

deviceModelName
deviceModelName string

디바이스 모델.

deviceSystemName
deviceSystemName string

컴퓨터의 디바이스 이름입니다.

deviceSystemVersion
deviceSystemVersion string

디바이스 버전입니다.

isBluetoothEnabled
isBluetoothEnabled boolean

bluetooth를 사용할 수 있는지 여부를 나타내는 True/False 값입니다.

simNetworkCountryISO
simNetworkCountryISO string

모바일 서비스 공급자에 대한 ISO 국가 코드입니다.

simNetworkType
simNetworkType string

모바일 네트워크 유형입니다.

systemUpTime
systemUpTime string

디바이스가 작동하고 사용 가능한 기간입니다.

merchantPaymentInstrumentId
merchantPaymentInstrumentId string

결제 방법의 식별자입니다. 이 정보는 판매자가 제공합니다.

결제 수단
paymentMethod string

최상위 결제 방법 범주입니다. 가능한 값은 카드, 현금, DIRECTDEBIT, E-WALLET, MOBILE, E-BANKING, 청구서, 바우처입니다.

type
type True string

결제 유형입니다. 가능한 값 'CreditCard' | 'DirectDebit' | 'PayPal' | 'MobileBilling' | 'OnlineBankTransfer' | 'Invoice' | 'MerchantGiftCard' | 'MerchantWallet' | 'CashOnDelivery' | 'Paytm' | 'CCAvenue'

생성일
creationDate date-time

가맹점 시스템의 결제 수단에 대한 첫 번째 항목의 날짜입니다. ISO 8601 형식입니다.

updateDate
updateDate date-time

가맹점 시스템의 결제 수단에 대한 마지막 업데이트 날짜입니다. ISO 8601 형식입니다.

paymentCheckoutProvider
paymentCheckoutProvider string

eWallet 체크 아웃 공급자입니다.

isLowLiabilityPIType
isLowLiabilityPIType boolean

결제 방법이 낮은 책임인지 여부를 나타내는 True/False 값입니다.

state string

가맹점 시스템에서 PI의 현재 상태입니다. 가능한 값 'Active' | '비활성'

cardType
cardType string

이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다. 카드가 제공되는 네트워크입니다. 가능한 값 'Visa' | '마스터 카드' | 'Amex' | 'ACH' | 'SEPA' | 'UnionPay' | 'Inicis' | 'MobileBillingCarrier' | 'Discover' | 'AllPay' | 'JCB' | 'DiscoverDiners'

holderName
holderName string

결제 방법 사용자의 이름입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

holderCompanyName
holderCompanyName string

비즈니스 또는 회사 카드를 제공하는 조직의 이름입니다(비즈니스 구매에만 해당).

settlementApprovalRequired
settlementApprovalRequired boolean

SEPA 트랜잭션에 승인이 필요한지 여부를 나타내는 True/False 값입니다.

bin string

이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

binName
binName string

BIN 표시 이름입니다.

binCountryISO
binCountryISO string

BIN과 연결된 ISO 국가 코드입니다.

binCardType
binCardType string

BIN 카드 유형입니다. 가능한 값은 DEBIT, CREDIT, PREPAID, FLEET, CREDITDEBIT입니다.

binCardAssociation
binCardAssociation string

BIN 카드 연결입니다. 몇 가지 가능한 값은 VISA, MASTERCARD, AMEX, DISCOVER, MAESTRO, JCB, UNIONPAY, DINERSCLUB입니다.

binBankGroup
binBankGroup string

BIN 은행 그룹입니다.

유효기간
expirationDate string

가맹점 시스템의 결제 수단에 대한 만료 날짜입니다. ISO 8601 형식입니다. 이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

lastFourDigits
lastFourDigits string

이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다.

메일 주소
email string

결제 수단과 연결된 이메일 주소입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다.

billingAgreementId
billingAgreementId string

이 특성은 PayPal 유형의 지불에만 사용됩니다.

payerId
payerId string

이 특성은 PayPal 유형의 지불에만 사용됩니다.

payerStatus
payerStatus string

PayPal 지불인을 확인했는지 여부를 나타내는 값입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다. 가능한 값 '확인됨' | '확인되지 않음'

addressStatus
addressStatus string

PayPal 지불인의 주소를 확인했는지 여부를 나타내는 값입니다. 이 특성은 PayPal 유형의 지불에만 사용됩니다. 가능한 값 'Confirmed' | '확인되지 않음'

imei
imei string

이 특성은 Mobilepayment 유형의 결제에만 사용됩니다.

currency
currency string

선택한 결제 수단의 통화 코드입니다.

isInternationalMoneyTransfer
isInternationalMoneyTransfer boolean

국제 송금이 발생했는지 여부를 나타내는 True/False 값입니다.

bankIdentifierCode
bankIdentifierCode string

은행 식별자 코드(BIC 또는 SWIFT 코드)

bankName
bankName string

은행 이름

bankZipCode
bankZipCode string

은행 우편 번호

bankState
bankState string

은행 주

bankCountryISO
bankCountryISO string

은행 ISO 국가

paymentCollectionDate
paymentCollectionDate date-time

결제 수금의 예상 날짜입니다(주로 결제 서비스 공급자에 사용됨).

instantPaymentSettlement
instantPaymentSettlement boolean

은행 리디렉션을 나타내는 True/False 값입니다(CSV 결제를 지원하는 데 사용됨).

autoCaptureEnabled
autoCaptureEnabled boolean

카드 결제를 위해 결제가 자동으로 캡처되었는지 여부를 나타내는 True/False 값입니다. 리디렉션 지불의 경우 이것은 단순히 자동으로 자금을 인출할지 여부를 파트너 은행에 나타내는 지표입니다.

계정 유형
accountType string

트랜잭션에 대해 청구할 계정 유형을 나타냅니다. UNSPECIFIED가 기본값입니다. CHEQUE_ACCOUNT 카드를 직불 카드로 사용합니다. CREDIT_FACILITY 카드를 신용 카드로 사용합니다.

authorizationType
authorizationType string

권한 부여 유형입니다. 마스터카드와 비자는 이제 판매자가 권한 부여 시도를 사전 승인 또는 최종 권한 부여로 정의하도록 요구합니다. 가능한 값은 PRE_AUTHORIZATION, FINAL_AUTHORIZATION

authorizationResultCode
authorizationResultCode string

권한 부여 결정의 은행 응답입니다. 가능한 값은 APPROVE, DECLINE, PENDING입니다.

authorizationResultText
authorizationResultText string

권한 부여 결정에 대한 이유; 특히 거부되거나 보류 중인 트랜잭션의 경우 가능한 값은 MISMATCH_CVV, MISMATCH_ADDRESS, MISMATCH_EXPIRATIONDATE, NOACCOUNT, INVALIDPIN, LOWFUND, OVERLIMIT SUSPICIOUSACCOUNT입니다.

acquirerId
acquirerId string

기관 식별 코드 획득

acquirerCountryISO
acquirerCountryISO string

기관 국가 코드 획득

cvvVerify
cvvVerify string

CVV 확인을 사용할 수 있는지 여부 및/또는 원활하게 확인할 수 있는지 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

avsVerify
avsVerify string

추가 기능 확인을 사용할 수 있는지 여부 및/또는 sucessfully 확인 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

cavVerify
cavVerify string

카드 소유자 인증 확인을 사용할 수 있는지 여부 및/또는 sucessfully 확인 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

piInputMethod
piInputMethod string

N/A

encryptedCreditCardNumber
encryptedCreditCardNumber string

해시되거나 암호화된 신용 카드 번호입니다.

purchaseAmount
purchaseAmount double

트랜잭션에 이 PI를 사용하는 총 구매 금액

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

이름 (첫 번째 이름)
firstName string

주소와 함께 제공된 이름

lastName
lastName string

주소와 함께 제공된 성

전화번호
phoneNumber string

주소와 함께 제공되는 전화 번호

organizationId
organizationId True string

가맹점 또는 조직의 고유 식별자입니다.

이름
name True string

조직의 이름

zipCode
zipCode string

조직이 있는 위치의 우편 번호

state string

조직이 있는 상태

countryISO
countryISO string

조직이 있는 countryISO

organizationId
organizationId True string

가맹점 또는 조직의 고유 식별자입니다.

이름
name True string

조직의 이름

zipCode
zipCode string

조직이 있는 위치의 우편 번호

state string

조직이 있는 상태

countryISO
countryISO string

조직이 있는 countryISO

organizationId
organizationId True string

가맹점 또는 조직의 고유 식별자입니다.

이름
name True string

조직의 이름

zipCode
zipCode string

조직이 있는 위치의 우편 번호

state string

조직이 있는 상태

countryISO
countryISO string

조직이 있는 countryISO

isThreeDSAuth
isThreeDSAuth boolean

이 트랜잭션이 3DS를 통해 인증되는지 여부를 나타내는 True/False 값입니다.

messageCategory
messageCategory string

특정 사용 사례에 대한 메시지의 범주를 식별합니다. 허용되는 값: 01 = PA, 02 = NPA, 03-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS용으로 예약됨

deviceChannel
deviceChannel string

트랜잭션을 시작하는 데 사용되는 채널 인터페이스의 형식을 나타냅니다. 허용되는 값: 01 = 앱 기반(APP), 02 = 브라우저(BRW), 03 = 3DS 요청자 시작(3RI), 04-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS용으로 예약됨

threeDSServerTransId
threeDSServerTransId string

단일 트랜잭션을 식별하기 위해 3DS 서버에서 할당한 범용 고유 트랜잭션 식별자입니다.

threeDSRequestorAuthenticationInd
threeDSRequestorAuthenticationInd string
threeDSRequestorChallengeInd
threeDSRequestorChallengeInd string

이 트랜잭션에 대한 챌린지가 요청되었는지 여부를 나타냅니다. 허용되는 값: 01 = 기본 설정 없음, 02 = 챌린지 요청 없음, 03 = 요청된 챌린지(3DS 요청자 기본 설정), 04 = 챌린지 요청됨(위임), 05 = 챌린지 요청 없음(트랜잭션 위험 분석이 이미 수행됨), 06 = 요청된 챌린지 없음(데이터 공유에만 해당), 07 = 요청된 챌린지 없음(강력한 소비자 인증이 이미 수행됨), 08 = 챌린지 요청 없음(챌린지 필요 없는 경우 허용 예외 목록 활용), 09 = 요청된 과제(챌린지가 필요한 경우 요청된 허용 목록 프롬프트)

threeRIInd
threeRIInd string

3RI 요청의 형식을 나타냅니다. 허용되는 값: 01 = 되풀이 트랜잭션, 02 = 할부 트랜잭션, 03 = 카드 추가, 04 = 카드 정보 유지 관리, 05 = 계정 확인, 06 = 분할,지연 배송, 07 = 상향식, 08 = 메일 주문, 09 = 전화 주문, 10 = 허용 목록 상태 확인, 11 = 기타 지불, 12-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS 사용을 위해 예약됨

threeDSReqPriorAuthMethod
threeDSReqPriorAuthMethod string

Cardholder가 이전에 3DS 요청자에 인증하는 데 사용하는 메커니즘입니다. 허용되는 값: 01 = ACS에서 발생한 마찰 없는 인증, 02 = ACS에서 발생한 카드 소유자 챌린지, 03 = AVS 확인됨, 04 = 기타 발급자 메서드, 05-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS용으로 예약됨

transStatus
transStatus string

트랜잭션이 인증된 트랜잭션 또는 계정 확인으로 자격이 있는지 여부를 나타냅니다. 허용되는 값: Y = 인증 확인에 성공했습니다. N = 인증되지 않음, 계정이 확인되지 않음; 트랜잭션이 거부되었습니다. U = 인증, 계정 확인을 수행할 수 없습니다. ARes 또는 RReq에 표시된 기술 또는 기타 문제 A = 수행된 처리 시도; 인증되지 않음, 확인되었지만 인증 시도 증명, 확인이 제공됩니다. C = 챌린지 필요; CReq,CRes를 사용하여 추가 인증이 필요합니다. D = 챌린지 필요; 분리된 인증이 확인되었습니다. R = 인증, 계정 확인 거부됨; 발급자가 인증, 확인 및 승인 시도를 거부합니다. I = 정보만; 3DS 요청자 챌린지 기본 설정이 승인되었습니다.

transStatusReason
transStatusReason string

트랜잭션 상태 필드에 지정된 값이 있는 이유에 대한 정보를 제공합니다. 허용되는 값: 01 = 카드 인증 실패, 02 = 알 수 없는 디바이스, 03 = 지원되지 않는 디바이스, 04 = 인증 빈도 제한을 초과합니다. 05 = 만료된 카드, 06 = 잘못된 카드 번호, 07 = 잘못된 트랜잭션, 08 = 카드 레코드 없음, 09 = 보안 오류, 10 = 도난 당한 카드, 11 = 사기 의심, 12 = 카드 소유자에게 트랜잭션이 허용되지 않음, 13 = 카드 소유자 서비스에 등록되지 않은 카드 소유자, 14 = ACS에서 트랜잭션 시간 초과, 15 = 신뢰도가 낮음, 16 = 보통 신뢰도, 17 = 높은 신뢰도, 18 = 매우 높은 신뢰도, 19 = ACS 최대 챌린지 초과, 20 = 미결제 트랜잭션이 지원되지 않음, 21 = 3RI 트랜잭션이 지원되지 않음, 22 = ACS 기술 문제, 23 = ACS에서 필요하지만 3DS 요청자가 요청하지 않은 인증 분리, 24 = 3DS 요청자 분리 최대 만료 시간 초과, 25 = 분리된 인증은 카드 소유자를 인증하는 데 충분한 시간을 제공했습니다. ACS는 시도하지 않습니다. 26 = 인증을 시도했지만 카드 소유자에 의해 수행되지 않음, 27-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS용으로 예약됨

threeDSCompInd
threeDSCompInd string

3DS 메서드가 성공적으로 완료되었는지 여부를 나타냅니다. 허용되는 값: Y = 성공적으로 완료됨, N = 완료되지 않음, U = Unavailabl 3DS 메서드 URL이 카드 소유자 계정 번호와 연결된 카드 범위에 대한 PRes 메시지 데이터에 없습니다.

acsChallengeMandated
acsChallengeMandated string

지역/지역 위임 또는 기타 변수로 인해 트랜잭션을 승인하기 위해 챌린지가 필요한지 여부를 나타냅니다. 허용되는 값: Y = 챌린지가 위임됨, N = 챌린지가 위임되지 않음

eci
eci string

ECI(전자 상거래 지표). 카드 소유자를 인증하려는 시도의 결과를 나타내기 위해 ACS 또는 DS에서 제공하는 결제 시스템별 값입니다. 허용되는 값: 02(마스터 카드)/05(비자)= 성공적인 인증 01(마스터 카드)/06/07(비자) = 기타 모든 항목

shipNameIndicator
shipNameIndicator string

계정의 카드 소유자 이름이 이 트랜잭션에 사용되는 배송 이름과 동일한지 나타냅니다. 허용되는 값: 01 = 배송 이름과 동일한 계정 이름, 02 = 배송 이름과 다른 계정 이름

challengeCompletionInd
challengeCompletionInd string

ACS 챌린지 주기의 상태 및 챌린지가 완료되었는지 또는 추가 메시지가 필요한지 여부를 나타냅니다. 허용되는 값: Y = 챌린지가 완료되었으며 추가 챌린지 메시지 교환이 필요하지 않습니다. N = 챌린지가 완료되지 않았으며 추가 챌린지 메시지 교환이 필요합니다.

chAccPwChangeInd
chAccPwChangeInd string

3DS 요청자가 있는 카드 소유자의 계정에 암호 변경 또는 계정 재설정이 있었던 이후의 기간을 나타냅니다. 허용되는 값: 01 = 변경 없음, 02 = 이 트랜잭션 중에 변경됨, 03 = 30일 미만, 04 = 30-60일, 05 = 60일 이상

chAccAgeInd
chAccAgeInd string

카드 소유자에게 3DS 요청자가 있는 계정이 있는 기간입니다. 허용되는 값: 01 = 계정 없음(게스트 체크 아웃), 02 = 이 트랜잭션 중에 생성됨, 03 = 30일 미만, 04 = 30-60일, 05 = 60일 이상

provisionAttemptsDay
provisionAttemptsDay string

지난 24시간 동안 카드 추가 시도 횟수입니다. 길이: 최대 3자 예제 값: 2, 02, 002

exemptionRaised
exemptionRaised string

PSD2 면제 요청, Y - 면제됨, N - 면제되지 않음

suspiciousAccActivity
suspiciousAccActivity string

3DS 요청자가 카드 소유자 계정에서 의심스러운 활동(이전 사기 포함)을 경험했는지 여부를 나타냅니다. 허용되는 값: 01 = 의심스러운 활동이 관찰되지 않았습니다. 02 = 의심스러운 활동이 관찰되었습니다.

제품 ID
productId True string

가맹점 시스템의 제품 식별자입니다.

제품 이름
productName string

사용자가 읽을 수 있는 제품 이름입니다.

type
type string

판매된 제품의 유형입니다. 가능한 값 'Digital' | '물리적'

sku
sku string

제품 SKU

카테고리
category string

제품 범주입니다. 가능한 값 'Subscription' | 'Game' | 'GameConsumable' | 'GameDLC' | 'HardwareDevice' | 'HardwareAccessory' | 'SoftwareToken' | 'SoftwareDirectEntitlement' | 'ClothingShoes' | 'RecreationalEquipment' | '쥬얼리' | 'Hotel' | 'Ticket' | 'VehicleRental' | 'GiftCard' | 'Movies' | 'Music' | 'GarageIndustrial' | 'HomeGarden' | '도구' | 'Books' | 'HealthBeauty' | '가구' | 'Toys' | 'FoodGrocery'

merchantProductCategory
merchantProductCategory string

시스템에서 가맹점이 정의한 제품 범주

시장
market string

제품이 제공되는 시장

productBrand
productBrand string

제품의 브랜드 이름

buyItAgainOrder
buyItAgainOrder boolean

사용자가 이전 주문을 다시 주문할 때 True입니다(해당 주문의 제품만이 아님).

preOrderAvailabilityDate
preOrderAvailabilityDate date-time

제품을 선주문에 처음 사용할 수 있었던 경우

salesPrice
salesPrice double

판매된 항목의 가격(세금 포함 안 됨). 판매자가 제공합니다.

currency
currency string

판매 가격에 사용되는 통화입니다. 판매자가 제공합니다.

톱니
cogs double

판매 상품의 비용 - 항목의 원료 비용. 판매자가 제공합니다.

isRecurring
isRecurring boolean

제품이 되풀이 구독인지를 나타냅니다.

isFree
isFree boolean

제품이 무료로 제공되는지 나타냅니다.

language
language string

제품이 설명되는 언어입니다.

purchasePrice
purchasePrice double

구매 시 품목에 대한 가격입니다.

여백
margin double

항목의 판매로 얻은 마진입니다.

수량
quantity integer

구매한 항목의 수량

isPreorder
isPreorder boolean

제품이 예약 주문용으로 제공되는지 나타냅니다.

shippingMethod
shippingMethod string

제품을 배송하는 데 사용되는 메서드를 나타냅니다. 가능한 값 'InStorePickup' | 'Standard' | 'Express' | 'DirectEntitlement' | 'DigitalToken'

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

이름 (첫 번째 이름)
firstName string

주소와 함께 제공된 이름

lastName
lastName string

주소와 함께 제공된 성

전화번호
phoneNumber string

주소와 함께 제공되는 전화 번호

storeId
storeId True string

가맹점 시스템의 스토어 식별자

storeName
storeName string

가맹점 시스템의 스토어 이름

terminalId
terminalId string

판매 지점 터미널의 고유 식별자입니다.

terminalName
terminalName string

판매 지점 터미널 이름

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

userId
userId True string

사용자 식별자입니다. 이 정보는 판매자가 제공합니다.

생성일
creationDate date-time

사용자 계정의 생성 날짜입니다. ISO 8601 형식입니다.

updateDate
updateDate date-time

사용자 데이터가 마지막으로 변경된 날짜입니다. ISO 8601 형식입니다.

이름 (첫 번째 이름)
firstName string

계정에서 사용자가 제공한 이름입니다.

lastName
lastName string

계정에서 사용자가 제공한 성입니다.

country
country string

사용자의 국가 또는 지역입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

zipCode
zipCode string

사용자의 우편 번호입니다.

timeZone
timeZone string

사용자의 표준 시간대입니다.

language
language string

사용자의 언어 및 지역(예: EN-US)입니다.

전화번호
phoneNumber string

사용자의 전화 번호입니다. 형식은 국가/지역 코드 다음에 하이픈(-) 및 전화 번호(예: 미국, +1-1234567890)여야 합니다.

메일 주소
email string

사용자의 전자 메일 주소입니다. 이 값은 대/소문자를 구분하지 않습니다.

membershipId
membershipId string

사용자에게 이미 가맹점과 기존 멤버 자격이 있는 경우의 멤버 자격 ID입니다.

프로필 유형
profileType string

사용자의 프로필 유형입니다. 가능한 값 'Consumer' | 'Seller' | 'Publisher' | 'Tenant' | '개발자'

profileName
profileName string

profileType에 따라 프로필 이름입니다.

authenticationProvider
authenticationProvider string

사용자의 인증 공급자(가맹점과 다른 경우)입니다. 가능한 valuse 'MSA' | 'Facebook' | 'PSN' | 'MerchantAuth' | 'Google'

인증 방법
authenticationMethod string

구매 전/구매 중에 고객이 인증된 방식입니다. 몇 가지 가능한 값은 PASSWORD-BASED, MULTI-FACTOR, BIOMETRIC, TOKEN-BASED,

표시 이름
displayName string

사용자의 표시 이름입니다. 예: Xbox 게이머태그 값

isEmailValidated
isEmailValidated boolean

사용자가 제공한 전자 메일 주소가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

emailValidatedDate
emailValidatedDate date-time

사용자 전자 메일의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

isPhoneNumberValidated
isPhoneNumberValidated boolean

사용자가 제공한 전화 번호가 사용자가 소유한 것으로 확인되었는지 여부를 나타내는 True/False 값입니다.

phoneNumberValidatedDate
phoneNumberValidatedDate date-time

사용자 전화 번호의 유효성 검사 날짜입니다. ISO 8601 형식입니다.

membershipType
membershipType string

고객의 멤버 자격 상태 또는 유형입니다. 프리미엄, 이그제큐티브 등 다양한 수준의 유료를 지정할 수 있습니다. 가능한 값은 FREE, PAY, PREMIUM입니다.

loginInputMethod
loginInputMethod string

고객이 자격 증명을 입력하는 방식입니다. 가능한 값은 MANUALINPUT, AUTOFILL, SCRIPT, COPYPASTE, SELECTPROFILE입니다.

lastPasswordUpdatedDate
lastPasswordUpdatedDate date-time

고객의 암호가 마지막으로 업데이트된 경우

firstPurchaseDate
firstPurchaseDate date-time

고객이 처음 구매한 경우

loginChallengeType
loginChallengeType string

시작된 챌린지-응답 테스트의 유형입니다. 가능한 값은 텍스트 SMS, 전화 SMS, 전자 메일 PIN, CAPTCHA입니다.

airlineIncluded
airlineIncluded boolean

항공료가 포함되는지 여부를 나타내는 True/False 값입니다.

carRentalIncluded
carRentalIncluded boolean

렌터카가 포함되는지 여부를 나타내는 True/False 값입니다.

lodgingIncluded
lodgingIncluded boolean

숙박이 포함되는지 여부를 나타내는 True/False 값입니다.

travelType
travelType string

여행 범주 또는 유형입니다.

isRoundTrip
isRoundTrip boolean

이동이 왕복인지 여부를 나타내는 True/False 값입니다.

isDiscountOffered
isDiscountOffered boolean

할인이 제공되었는지 여부를 나타내는 True/False 값입니다.

isPackagedTour
isPackagedTour boolean

패키지된 투어인지 여부를 나타내는 True/False 값입니다.

issueDateTime
issueDateTime date-time

티켓이 발행된 날짜 및 시간입니다.

travelDateTime
travelDateTime date-time

여행 시작 날짜 및 시간입니다.

returnDateTime
returnDateTime date-time

여행 종료 또는 반환 날짜 및 시간입니다.

bookingType
bookingType string

예약 유형입니다. 몇 가지 가능한 값은 WEBSITE, AGENT입니다.

webUrl
webUrl string

여행을 예약한 URL입니다.

fromCity
fromCity string

고객이 여행하는 도시입니다.

fromState
fromState string

고객이 여행하는 상태입니다.

fromCountryISO
fromCountryISO string

고객이 여행하는 ISO 국가입니다.

fromZipCode
fromZipCode string

고객이 이동하는 우편 번호입니다.

toCity
toCity string

고객이 여행하는 도시입니다.

toState
toState string

고객이 여행하는 상태입니다.

toCountryISO
toCountryISO string

고객이 여행하는 ISO 국가입니다.

toZipCode
toZipCode string

고객이 이동하는 우편 번호입니다.

ticketNumber
ticketNumber string

고유한 티켓 번호입니다.

placeOfIssue
placeOfIssue string

티켓이 발급된 위치입니다.

isRestrictedTicket
isRestrictedTicket boolean

티켓이 제한되는지 여부를 나타내는 True/False 값입니다.

rewardsOrVoucherApplied
rewardsOrVoucherApplied boolean

주문에 보상 또는 바우처가 적용되었는지 여부를 나타내는 True/False 값입니다.

totalRewardsApplied
totalRewardsApplied integer

주문에 적용된 총 보상입니다.

totalFees
totalFees double

주문에 적용되는 총 수수료입니다.

purchaserProfileType
purchaserProfileType string

고객의 프로필 또는 멤버 자격 유형입니다. 가능한 값은 CORPORATE, INDIVIDUAL입니다.

isThirdParty
isThirdParty boolean

주문이 타사 사이트를 통해 배치되었는지 여부를 나타내는 True/False 값입니다.

isPurchaserFrequentFlyer
isPurchaserFrequentFlyer boolean

주문이 타사 사이트를 통해 배치되었는지 여부를 나타내는 True/False 값입니다.

passengerCount
passengerCount integer

총 승객 수입니다.

numberOfStops
numberOfStops integer

항공편의 정차 또는 경유 횟수입니다.

airlineCode
airlineCode string

항공사 코드입니다.

airlineName
airlineName string

항공사 이름입니다.

operatedBy
operatedBy string

플라이트를 운영하는 조직입니다.

flightNumber
flightNumber string

항공편 번호입니다.

departureDateTime
departureDateTime date-time

출발 날짜 및 시간입니다.

arrivalDateTime
arrivalDateTime date-time

도착 날짜 및 시간입니다.

fromAirportCode
fromAirportCode string

항공편이 비행하는 공항 코드입니다.

fromAirportCity
fromAirportCity string

고객이 여행하는 공항 도시입니다.

fromAirportState
fromAirportState string

고객이 여행하는 공항 상태입니다.

fromAirportZipcode
fromAirportZipcode string

고객이 여행하는 공항 우편 번호입니다.

fromAirportCountryISO
fromAirportCountryISO string

고객이 여행하는 공항 ISO 국가입니다.

toAirportCode
toAirportCode string

항공편이 비행하는 공항 코드입니다.

toAirportCity
toAirportCity string

고객이 여행하는 공항 도시입니다.

toAirportState
toAirportState string

고객이 여행하는 공항 상태입니다.

toAirportZipcode
toAirportZipcode string

고객이 여행하는 공항 우편 번호입니다.

toAirportCountryISO
toAirportCountryISO string

고객이 여행하는 공항 ISO 국가입니다.

travelClass
travelClass string

좌석 클래스 또는 캐빈입니다.

segmentSequence
segmentSequence integer

지정된 비행 레그의 시퀀스 번호(예: 비행의 두 번째 다리의 경우 2)입니다.

이름 (첫 번째 이름)
firstName string

승객 이름입니다.

lastName
lastName string

승객 성입니다.

folioNumber
folioNumber string

숙박 속성의 고유 식별자입니다.

checkInDate
checkInDate date-time

숙박에 대한 체크인 날짜입니다.

checkOutDate
checkOutDate date-time

숙박에 대한 체크 아웃 날짜입니다.

reservationConfirmed
reservationConfirmed boolean

예약이 확인되었는지 여부를 나타내는 True/False 값입니다.

membershipDetails
membershipDetails string

고객의 멤버 자격 상태에 대한 추가 세부 정보입니다.

discountProgram
discountProgram string

숙박 주문에 적용되는 할인 프로그램입니다.

adultCount
adultCount integer

숙박에 포함된 성인 수입니다.

kidCount
kidCount integer

숙박에 포함된 어린이 수입니다.

nightsCount
nightsCount integer

숙박에 포함된 숙박 횟수입니다.

roomCount
roomCount integer

숙박에 포함된 객실 수입니다.

bedType
bedType string

침대 유형 또는 범주입니다.

roomType
roomType string

회의실 유형 또는 범주입니다.

paymentDescription
paymentDescription string

숙박 결제에 대한 추가 세부 정보입니다.

이름
name string

시설 이름입니다.

type
type string

시설 유형입니다.

연락처전화번호
contactPhoneNumber string

시설에 연락하는 데 사용되는 전화 번호입니다.

연락처이메일
contactEmail string

시설에 연락하는 데 사용되는 이메일 주소입니다.

dailyRoomRate
dailyRoomRate double

시설의 일일 객실 요금입니다.

currency
currency string

시설에서 지원하는 통화입니다.

dailyRoomTaxAmount
dailyRoomTaxAmount double

시설로 청구되는 일별 객실세 금액입니다.

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

pickupLocation
pickupLocation string

렌터카 픽업 위치입니다.

pickupDateTime
pickupDateTime date-time

렌터카 픽업 날짜 및 시간입니다.

dropOffLocation
dropOffLocation string

렌터카 드롭오프 위치입니다.

dropOffDateTime
dropOffDateTime date-time

렌터카 드롭오프 날짜 및 시간

discountProgram
discountProgram string

렌터카 주문에 적용되는 할인 프로그램입니다.

carType
carType string

자동차 종류 또는 범주입니다.

isPrepaid
isPrepaid boolean

렌터카가 선불인지 여부를 나타내는 True/False 값입니다.

insuranceIncluded
insuranceIncluded boolean

보험이 포함되었는지 여부를 나타내는 True/False 값입니다.

연락처이메일
contactEmail string

렌터카의 이메일 주소입니다.

연락처전화번호
contactPhoneNumber string

렌터카 임대인의 전화 번호입니다.

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

agencyCode
agencyCode string

여행사 코드입니다.

agencyName
agencyName string

여행사 이름입니다.

agentCode
agentCode string

N/A

agencyContactPhone
agencyContactPhone string

N/A

agencyContactEmail
agencyContactEmail string

N/A

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

organizationId
organizationId True string

클라우드 서비스 또는 조직의 고유 식별자입니다.

companyName
companyName string

클라우드 서비스 이름입니다.

companyType
companyType string

클라우드 회사 유형입니다.

companySize
companySize integer

클라우드 회사 크기입니다.

entityId
entityId string

조직의 법인에 대한 고유 식별자입니다.

primaryContactFirstName
primaryContactFirstName string

비즈니스에 대한 기본 연락처의 이름입니다.

primaryContactLastName
primaryContactLastName string

비즈니스에 대한 기본 연락처의 성입니다.

primaryContactEmail
primaryContactEmail string

비즈니스에 대한 기본 연락처의 전자 메일 주소입니다.

primaryContactPhoneNumber
primaryContactPhoneNumber string

비즈니스에 대한 기본 연락처의 전화 번호입니다.

subscriptionCount
subscriptionCount integer

사용 가능한 총 구독 수입니다.

street1
street1 string

주소에 대해 제공된 첫 번째 행입니다.

street2
street2 string

주소에 대해 제공된 두 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

street3
street3 string

주소에 대해 제공된 세 번째 행입니다. (이 값은 비어 있을 수 있습니다.)

city
city string

주소로 제공된 도시입니다.

state string

주소에 대해 제공된 주 또는 주입니다.

지구
district string

주소에 대해 제공된 지구입니다.

zipCode
zipCode string

주소에 대해 제공된 우편 번호입니다.

country
country string

주소에 대해 제공된 국가/지역 코드입니다. 값은 두 글자로 된 ISO 국가/지역 코드(예: 미국)여야 합니다.

trackingId
trackingId string

이벤트에 대한 TrackingId

merchantTimeStamp
merchantTimeStamp date-time

이벤트에 대한 TimeStamp

반환

결과 세부 정보

온라인 구매 트랜잭션의 상태를 업데이트합니다.

이 이벤트는 예를 들어 구매가 취소된 경우 구매 상태의 업데이트를 보냅니다. 데이터 수집 이벤트 전용입니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

purchaseId
purchaseId True string

가맹점 시스템의 트랜잭션(또는 구매/주문) 식별자입니다.

statusType
statusType True string

상태의 형식입니다. 가능한 값 '승인됨' | '보류 중' | 'Rejected' | '실패' | 'Canceled'

statusDate
statusDate True date-time

이 상태가 적용된 DateTime

이유
reason string

상태 전환의 이유입니다. 가능한 값 'RuleEngine' | 'MerchantOverride' | 'ChallengeSolved' | 'ChallengeFailed' | 'CustomerRequest' | 'FufillmentFailed' | 'InlineManualReview_General' | 'InlineManualReview_Fraud' | 'InlineManualReview_AccountCompromise' | 'OfflineManualReview_General' | 'OfflineManualReview_Fraud' | 'OfflineManualReview_AccountCompromise' | 'Safelist' | '차단 목록'

trackingId
trackingId string

이벤트에 대한 TrackingId

merchantTimeStamp
merchantTimeStamp date-time

이벤트에 대한 TimeStamp

반환

결과 세부 정보

은행 인증 정보 업데이트

이 이벤트는 은행에 전송된 구매 거래가 은행 승인 또는 은행 수수료/결제에 대해 승인되거나 거부되었는지 여부를 전달합니다. 데이터 수집 이벤트 전용입니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

bankEventId
bankEventId True string

이 Bank 이벤트를 식별하는 고유 문자열

type
type True string

은행 이벤트 유형입니다. 가능한 값 'Auth' | 'AuthCancel' | 'ChargeReversal' | '요금'

bankEventTimestamp
bankEventTimestamp date-time

은행의 타임스탬프

status
status string

가능한 값 '승인됨' | '알 수 없음' | '거부됨'

bankResponseCode
bankResponseCode string

응답의 은행 코드

paymentProcessor
paymentProcessor string

프로세서 이름입니다. 가능한 값 'FDC' | 'Adyen' | 'TSYS' | 'WorldPay' | 'Chase' | 'Stripe' | 'PayPal'

mrn
mrn string

가맹점 쪽에서 거래를 식별하는 데 사용되는 가맹점 참조 번호

중간
mid string

은행에 보낸 MID(가맹점 ID) 및/또는 그로부터 다시 수신되었습니다.

merchantPaymentInstrumentId
merchantPaymentInstrumentId string

결제 방법의 식별자입니다. 이 정보는 판매자가 제공합니다.

결제 수단
paymentMethod string

결제 방법의 그룹화/범주입니다. 가능한 값은 카드, 현금, DIRECTDEBIT, E-WALLET, MOBILE, E-BANKING, 청구서, 바우처입니다.

cardType
cardType string

결제 유형입니다. 가능한 값은 VISA, MASTERCARD, AMEX, ACH, SEPA, UNIONPAY, INICIS, MOBILEBILLINGCARRIER, DISCOVER, ALLPAY, JCB, DISCOVERDINERS입니다.

updatedPI
updatedPI boolean

구매의 PI와 다른 PI 사용

cvvVerify
cvvVerify string

CVV 확인을 사용할 수 있는지 여부 및/또는 원활하게 확인할 수 있는지 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

avsVerify
avsVerify string

추가 기능 확인을 사용할 수 있는지 여부 및/또는 sucessfully 확인 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

cavVerify
cavVerify string

카드 소유자 인증 확인을 사용할 수 있는지 여부 및/또는 sucessfully 확인 여부를 나타냅니다. Y = 성공적으로 확인됨, N = 성공적으로 수정되지 않음, U = 사용할 수 없음, A = 사용 가능하지만 확인 없음

authResultCode
authResultCode string

권한 부여 결정의 은행 응답입니다. 가능한 값은 APPROVE, DECLINE, PENDING입니다.

authResultText
authResultText string

권한 부여 결정에 대한 이유; 특히 거부되거나 보류 중인 트랜잭션의 경우 가능한 값은 MISMATCH_CVV, MISMATCH_ADDRESS, MISMATCH_EXPIRATIONDATE, NOACCOUNT, INVALIDPIN, LOWFUND, OVERLIMIT SUSPICIOUSACCOUNT입니다.

purchaseId
purchaseId True string

구매를 식별하는 고유 문자열

isThreeDSAuth
isThreeDSAuth boolean

이 트랜잭션이 3DS를 통해 인증되는지 여부를 나타내는 True/False 값입니다.

messageCategory
messageCategory string

특정 사용 사례에 대한 메시지의 범주를 식별합니다. 허용되는 값: 01 = PA, 02 = NPA, 03-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS용으로 예약됨

deviceChannel
deviceChannel string

트랜잭션을 시작하는 데 사용되는 채널 인터페이스의 형식을 나타냅니다. 허용되는 값: 01 = 앱 기반(APP), 02 = 브라우저(BRW), 03 = 3DS 요청자 시작(3RI), 04-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS용으로 예약됨

threeDSServerTransId
threeDSServerTransId string

단일 트랜잭션을 식별하기 위해 3DS 서버에서 할당한 범용 고유 트랜잭션 식별자입니다.

threeDSRequestorAuthenticationInd
threeDSRequestorAuthenticationInd string
threeDSRequestorChallengeInd
threeDSRequestorChallengeInd string

이 트랜잭션에 대한 챌린지가 요청되었는지 여부를 나타냅니다. 허용되는 값: 01 = 기본 설정 없음, 02 = 챌린지 요청 없음, 03 = 요청된 챌린지(3DS 요청자 기본 설정), 04 = 챌린지 요청됨(위임), 05 = 챌린지 요청 없음(트랜잭션 위험 분석이 이미 수행됨), 06 = 요청된 챌린지 없음(데이터 공유에만 해당), 07 = 요청된 챌린지 없음(강력한 소비자 인증이 이미 수행됨), 08 = 챌린지 요청 없음(챌린지 필요 없는 경우 허용 예외 목록 활용), 09 = 요청된 과제(챌린지가 필요한 경우 요청된 허용 목록 프롬프트)

threeRIInd
threeRIInd string

3RI 요청의 형식을 나타냅니다. 허용되는 값: 01 = 되풀이 트랜잭션, 02 = 할부 트랜잭션, 03 = 카드 추가, 04 = 카드 정보 유지 관리, 05 = 계정 확인, 06 = 분할,지연 배송, 07 = 상향식, 08 = 메일 주문, 09 = 전화 주문, 10 = 허용 목록 상태 확인, 11 = 기타 지불, 12-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS 사용을 위해 예약됨

threeDSReqPriorAuthMethod
threeDSReqPriorAuthMethod string

Cardholder가 이전에 3DS 요청자에 인증하는 데 사용하는 메커니즘입니다. 허용되는 값: 01 = ACS에서 발생한 마찰 없는 인증, 02 = ACS에서 발생한 카드 소유자 챌린지, 03 = AVS 확인됨, 04 = 기타 발급자 메서드, 05-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS용으로 예약됨

transStatus
transStatus string

트랜잭션이 인증된 트랜잭션 또는 계정 확인으로 자격이 있는지 여부를 나타냅니다. 허용되는 값: Y = 인증 확인 성공, N = 인증되지 않음, 계정이 확인되지 않음; 트랜잭션이 거부됨, U = 인증, 계정 확인을 수행할 수 없습니다. ARes 또는 RReq에 표시된 기술 또는 기타 문제, A = 수행된 처리 시도; 인증되지 않음, 확인되었지만 인증 시도 증명, 확인이 제공됨, C = 챌린지 필요; CReq, CRes, D = Challenge Required를 사용하여 추가 인증이 필요합니다. 인증이 분리됨, R = 인증, 계정 확인이 거부됨; 발급자가 인증을 거부하고 인증을 시도하지 않도록 요청하고, I = 정보 전용입니다. 3DS 요청자 챌린지 기본 설정이 승인되었습니다.

transStatusReason
transStatusReason string

트랜잭션 상태 필드에 지정된 값이 있는 이유에 대한 정보를 제공합니다. 허용되는 값: 01 = 카드 인증 실패, 02 = 알 수 없는 디바이스, 03 = 지원되지 않는 디바이스, 04 = 인증 빈도 제한을 초과합니다. 05 = 만료된 카드, 06 = 잘못된 카드 번호, 07 = 잘못된 트랜잭션, 08 = 카드 레코드 없음, 09 = 보안 오류, 10 = 도난 당한 카드, 11 = 사기 의심, 12 = 카드 소유자에게 트랜잭션이 허용되지 않음, 13 = 카드 소유자 서비스에 등록되지 않은 카드 소유자, 14 = ACS에서 트랜잭션 시간 초과, 15 = 신뢰도가 낮음, 16 = 보통 신뢰도, 17 = 높은 신뢰도, 18 = 매우 높은 신뢰도, 19 = ACS 최대 챌린지 초과, 20 = 미결제 트랜잭션이 지원되지 않음, 21 = 3RI 트랜잭션이 지원되지 않음, 22 = ACS 기술 문제, 23 = ACS에서 필요하지만 3DS 요청자가 요청하지 않은 인증 분리, 24 = 3DS 요청자 분리 최대 만료 시간 초과, 25 = 분리된 인증은 카드 소유자를 인증하는 데 충분한 시간을 제공했습니다. ACS는 시도하지 않습니다. 26 = 인증을 시도했지만 카드 소유자에 의해 수행되지 않음, 27-79 = EMVCo 향후 사용을 위해 예약됨(EMVCo에서 정의할 때까지 유효하지 않은 값), 80-99 = DS용으로 예약됨

threeDSCompInd
threeDSCompInd string

3DS 메서드가 성공적으로 완료되었는지 여부를 나타냅니다. 허용되는 값: Y = 성공적으로 완료됨, N = 완료되지 않음, U = Unavailabl 3DS 메서드 URL이 카드 소유자 계정 번호와 연결된 카드 범위에 대한 PRes 메시지 데이터에 없습니다.

acsChallengeMandated
acsChallengeMandated string

지역/지역 위임 또는 기타 변수로 인해 트랜잭션을 승인하기 위해 챌린지가 필요한지 여부를 나타냅니다. 허용되는 값: Y = 챌린지가 위임됨, N = 챌린지가 위임되지 않음

eci
eci string

ECI(전자 상거래 지표). 카드 소유자를 인증하려는 시도의 결과를 나타내기 위해 ACS 또는 DS에서 제공하는 결제 시스템별 값입니다. 허용되는 값: 02(마스터 카드)/05(비자)= 성공적인 인증 01(마스터 카드)/06/07(비자) = 기타 모든 항목

shipNameIndicator
shipNameIndicator string

계정의 카드 소유자 이름이 이 트랜잭션에 사용되는 배송 이름과 동일한지 나타냅니다. 허용되는 값: 01 = 배송 이름과 동일한 계정 이름, 02 = 배송 이름과 다른 계정 이름

challengeCompletionInd
challengeCompletionInd string

ACS 챌린지 주기의 상태 및 챌린지가 완료되었는지 또는 추가 메시지가 필요한지 여부를 나타냅니다. 허용되는 값: Y = 챌린지가 완료되었으며 추가 챌린지 메시지 교환이 필요하지 않습니다. N = 챌린지가 완료되지 않았으며 추가 챌린지 메시지 교환이 필요합니다.

chAccPwChangeInd
chAccPwChangeInd string

3DS 요청자가 있는 카드 소유자의 계정에 암호 변경 또는 계정 재설정이 있었던 이후의 기간을 나타냅니다. 허용되는 값: 01 = 변경 없음, 02 = 이 트랜잭션 중에 변경됨, 03 = 30일 미만, 04 = 30-60일, 05 = 60일 이상

chAccAgeInd
chAccAgeInd string

카드 소유자에게 3DS 요청자가 있는 계정이 있는 기간입니다. 허용되는 값: 01 = 계정 없음(게스트 체크 아웃), 02 = 이 트랜잭션 중에 생성됨, 03 = 30일 미만, 04 = 30-60일, 05 = 60일 이상

provisionAttemptsDay
provisionAttemptsDay string

지난 24시간 동안 카드 추가 시도 횟수입니다. 길이: 최대 3자 예제 값: 2, 02, 002

exemptionRaised
exemptionRaised string

PSD2 면제 요청, Y - 면제됨, N - 면제되지 않음

suspiciousAccActivity
suspiciousAccActivity string

3DS 요청자가 카드 소유자 계정에서 의심스러운 활동(이전 사기 포함)을 경험했는지 여부를 나타냅니다. 허용되는 값: 01 = 의심스러운 활동이 관찰되지 않았습니다. 02 = 의심스러운 활동이 관찰되었습니다.

trackingId
trackingId string

이벤트에 대한 TrackingId

merchantTimeStamp
merchantTimeStamp date-time

이벤트에 대한 TimeStamp

반환

결과 세부 정보

환불 정보 업데이트

이 이벤트는 환불되는 이전 구매 트랜잭션에 대한 정보를 보냅니다. 데이터 수집 이벤트입니다. 많은 가맹점이 대량 데이터 업로드를 사용하여 이러한 이벤트를 보냅니다.

매개 변수

Name 필수 형식 Description
hosturl
hostUrl True string

호스트 URL

콘텐츠 형식
Content-Type True string

application/json

상관 관계 ID
x-ms-correlation-id string

요청당 unqiue Correlation-Id 런타임 문제를 추적하는 데 도움이 됩니다.

환경 ID
x-ms-dfpenvid string

EnvironmentId

refundId
refundId True string

이 환불 이벤트를 식별하는 고유 문자열

이유
reason string

사용자가 이유를 제공했습니다. 가능한 값 'FraudRefund' | 'CustomerRequest' | 'NonFraudRefund'

status
status string

가능한 값 '승인됨' | '거부됨' | '알 수 없음'

bankEventTimestamp
bankEventTimestamp date-time

은행의 타임스탬프

분량
amount double

환불 금액

currency
currency string

판매 가격 금액에 사용되는 통화입니다.

userId
userId string

사용자를 식별하는 고유 문자열

purchaseId
purchaseId True string

원래 구매 ID

trackingId
trackingId string

이벤트에 대한 TrackingId

merchantTimeStamp
merchantTimeStamp date-time

이벤트에 대한 TimeStamp

반환

결과 세부 정보

정의

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateEnrichment

클래스는 계정 만들기 평가에 대한 보강 기능을 나타냅니다.

Name 경로 형식 Description
deviceAttributes
deviceAttributes Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

사용자의 디바이스 특성에서 파생된 기능을 나타내는 클래스입니다.

calculatedFeatures
calculatedFeatures Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.CalculatedFeatures

평가 중에 계산된 기능을 나타내는 클래스

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateResponseSuccessDetails

Dynamics Fraud Protection AccountCreate API에 대한 응답 개체

Name 경로 형식 Description
이름
name string

N/A

version
version string

N/A

코드
code string

N/A

description
description string

N/A

resultDetails
resultDetails array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResultDetail

AssessmentResultDetail 컬렉션

transactionReferenceId
transactionReferenceId string

개별 트랜잭션을 식별하는 고유 ID

enrichment
enrichment Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountCreateEnrichment

클래스는 계정 만들기 평가에 대한 보강 기능을 나타냅니다.

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountProtectionEnrichment

보강 기능을 나타내는 클래스

Name 경로 형식 Description
deviceAttributes
deviceAttributes Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

사용자의 디바이스 특성에서 파생된 기능을 나타내는 클래스입니다.

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.CalculatedFeatures

평가 중에 계산된 기능을 나타내는 클래스

Name 경로 형식 Description
emailDomain
emailDomain string

평가 페이로드에서 구문 분석된 전자 메일 도메인

emailPattern
emailPattern string

전자 메일에서 계산된 전자 메일 핸들의 패턴입니다. 전자 메일 접두사에 있는 모든 대문자는 'U'로, 소문자는 'I'로, 숫자는 'd'로 바뀝니다. 반복된 'I' 및 'U'는 축소되고 나머지 문자는 변경되지 않은 상태로 유지됩니다. 예를 들어 전자 메일 ''kAyla.277@contoso.com은 전자 메일 패턴 'lUl.ddd'를 반환합니다.

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.DeviceAttributes

사용자의 디바이스 특성에서 파생된 기능을 나타내는 클래스입니다.

Name 경로 형식 Description
trueIp
trueIp string

디바이스 지문으로 식별된 디바이스의 진정한 IP 주소

proxyIp
proxyIp string

디바이스 지문으로 식별되는 디바이스 프록시의 프록시 IP 주소

realtimeTimezoneOffset
realtimeTimezoneOffset string

일광 절약 일정을 고려한 표준 시간대 오프셋

sld
sld string

True IP와 관련된 두 번째 수준 도메인

timeZone
timeZone string

그리니치 표준시와 관련하여 표준 시간대 오프셋

proxyLastDetected
proxyLastDetected string

디바이스 IP가 활성 프록시로 식별된 가장 최근 날짜

deviceId
deviceId string

디바이스 지문으로 생성된 고유 deviceid

deviceCountryCode
deviceCountryCode string

실제 IP의 디바이스 위치 국가

deviceState
deviceState string

실제 IP의 디바이스 위치 상태

deviceCity
deviceCity string

실제 IP의 디바이스 위치 도시

devicePostalCode
devicePostalCode string

실제 IP의 디바이스 위치 우편 번호

deviceAsn
deviceAsn string

디바이스 지문으로 식별되는 디바이스의 ASN

플랫폼
platform string

디바이스의 운영 체제 플랫폼

browserUserAgentLanguages
browserUserAgentLanguages string

사용자 에이전트에 저장된 언어

browserUserAgent
browserUserAgent string

세션에서 사용되는 브라우저

tcpDistance
tcpDistance string

연결 중인 네트워크 홉 수

항공모함
carrier string

식별된 실제 IP의 ISP

ipRoutingType
ipRoutingType string

IP의 라우팅 유형

프록시
proxy string

호출자가 프록시인지 여부를 결정하는 플래그

proxyType
proxyType string

검색된 경우 프록시의 형식

userAgentPlatform
userAgentPlatform string

브라우저 버전

userAgentBrowser
userAgentBrowser string

브라우저 패밀리

userAgentOperatingSystem
userAgentOperatingSystem string

운영 체제 버전

sdkType
sdkType string

디바이스에서 호출하는 데 사용하는 SDK(Android, iOS 또는 웹)

dataNetworkType
dataNetworkType string

사용되는 네트워크 유형(Wifi 또는 Mobile)입니다. Android 및 iOS 디바이스의 경우

localIpv4
localIpv4 string

디바이스의 로컬 IPV4 주소입니다. Android 및 iOS 디바이스의 경우

isDeviceEmulator
isDeviceEmulator string

디바이스가 에뮬레이트되는지 여부를 나타냅니다. Android 및 iOS 디바이스의 경우

isDeviceRooted
isDeviceRooted string

디바이스가 루팅되었는지 여부를 나타냅니다. Android 및 iOS 디바이스의 경우

isWifiEnabled
isWifiEnabled string

디바이스의 Wi-Fi를 사용할 수 있는지 여부를 나타냅니다. Android 디바이스의 경우

deviceSystemVersion
deviceSystemVersion string

운영 체제의 현재 버전입니다. iOS 디바이스의 경우

deviceModelName
deviceModelName string

디바이스 모델 이름입니다. iOS 디바이스의 경우

localIpv6
localIpv6 string

디바이스의 로컬 IPV6 주소입니다. iOS 디바이스의 경우

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccess

Dynamics Fraud Protection 성공 개체

Name 경로 형식 Description
이름
name string

N/A

version
version string

N/A

코드
code string

N/A

description
description string

N/A

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResponseSuccessDetails

Dynamics Fraud Protection API에 대한 응답 개체

Name 경로 형식 Description
이름
name string

N/A

version
version string

N/A

코드
code string

N/A

description
description string

N/A

resultDetails
resultDetails array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResultDetail

AssessmentResultDetail 컬렉션

transactionReferenceId
transactionReferenceId string

개별 트랜잭션을 식별하는 고유 ID

enrichment
enrichment Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.AccountProtectionEnrichment

보강 기능을 나타내는 클래스

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.ResultDetail

AssessmentResultDetail

Name 경로 형식 Description
결정
decision string

결정된 결정의 유형

challengeType
challengeType string

챌린지 유형

이유
reasons array of string

이유 목록

rule
rule string

페이로드가 일치하는 규칙

clauseName
clauseName string

결정을 내린 규칙 절 친숙한 이름

supportMessages
supportMessages array of string

결정을 지원하는 메시지 목록

other
other object

추가 데이터

점수
scores array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.Score

다른 점수 목록

ruleEvaluations
ruleEvaluations array of Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.RuleEvaluation

이 결정에 도달하기 위해 협의된 규칙 집합의 경로

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.RuleEvaluation

으로 가는 길에 규칙 집합 실행의 레코드

Name 경로 형식 Description
rule
rule string

규칙 집합의 친숙한 이름

clauseNames
clauseNames array of string

이 규칙이 순서대로 실행되고 마지막 삭제에 도달한 절입니다.

Microsoft.DynamicsFraudProtection.Models.AccountProtection.Response.Score

Score 개체

Name 경로 형식 Description
scoreType
scoreType string

점수 유형

scoreValue
scoreValue double

점수 값입니다. 최대값은 999입니다.

이유
reason string

점수 값의 이유

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEvent

Name 경로 형식 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEventResponseWrapper

결과 세부 정보

Name 경로 형식 Description
resultDetails
resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.BankEventActivity.BankEvent

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.Chargeback

Name 경로 형식 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.ChargebackResponseWrapper

결과 세부 정보

Name 경로 형식 Description
resultDetails
resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.ChargebackActivity.Chargeback

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.Label

Name 경로 형식 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.LabelResponseWrapper

결과 세부 정보

Name 경로 형식 Description
resultDetails
resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.LabelActivity.Label

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseResponseWrapper

결과 세부 정보

Name 경로 형식 Description
resultDetails
resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseWrapper

구매 응답 페이로드

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseActivity.PurchaseWrapper

구매 응답 페이로드

Name 경로 형식 Description
riskScore
riskScore integer

-1에서 1000까지의 범위에서 Fraud Protection 위험 모델로 계산된 위험 점수입니다. -1은 위험 점수를 결정하는 오류를 나타냅니다.

merchantRuleDecision
merchantRuleDecision string

거래에 대한 위험 점수를 얻은 후 가맹점 규칙에 의해 결정됩니다. 가능한 값 '승인' | '거부'

ruleEvaluations
ruleEvaluations array of

결정에 올 것으로 평가되는 규칙의 이름을 포함합니다.

clauseName
clauseName string

결정을 내린 절의 이름을 포함합니다.

midFlag
midFlag string

권장되는 MID(가맹점 ID) 플래그입니다. 가능한 값 'Program' | 'Standard' | 'Control'

reasonCodes
reasonCodes string

결정을 설명하는 이유 코드입니다.

policyApplied
policyApplied string

가맹점 규칙 결정으로 이어지는 가맹점 규칙 또는 기본 규칙의 이름입니다.

bankName
bankName string

DFP가 이 거래에 대해 호출한 은행(발급자)입니다.

hashedEvaluationId
hashedEvaluationId string

DFP에서 계산한 HashedEvaluationId

diagnostics
diagnostics object

네임스페이스로 키가 지정된 진단 개체

purchaseId
purchaseId string

가맹점 시스템의 트랜잭션(또는 구매/주문) 식별자입니다.

deviceAttributes
deviceAttributes object

DFP 지문의 디바이스 특성

성공했다
succeeded string

요청 성공

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatus

Name 경로 형식 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatusResponseWrapper

결과 세부 정보

Name 경로 형식 Description
resultDetails
resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.PurchaseStatusActivity.PurchaseStatus

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.Refund

Name 경로 형식 Description
object

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.RefundResponseWrapper

결과 세부 정보

Name 경로 형식 Description
resultDetails
resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.RefundActivity.Refund

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccount

UpdateAccount 응답 페이로드

Name 경로 형식 Description
deviceAttributes
deviceAttributes object

DFP 지문의 디바이스 특성

성공했다
succeeded string

요청 성공

Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccountResponseWrapper

결과 세부 정보

Name 경로 형식 Description
resultDetails
resultDetails Microsoft.DynamicsFraudProtection.v1.MerchantResponse.Models.UpdateAccountActivity.UpdateAccount

UpdateAccount 응답 페이로드