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 코드(예: 미국)여야 합니다. |
|
|
메일 주소
|
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 코드(예: 미국)여야 합니다. |
|
|
메일 주소
|
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)여야 합니다. |
|
|
메일 주소
|
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 |
이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다. |
|
|
메일 주소
|
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)여야 합니다. |
|
|
메일 주소
|
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 |
이 특성은 신용/직불 카드 유형의 결제에만 사용됩니다. |
|
|
메일 주소
|
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)여야 합니다. |
|
|
메일 주소
|
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 응답 페이로드 |