평가에 트랜잭션 이벤트 주석 추가

이 페이지에서는 평가에 트랜잭션 이벤트 주석을 추가하여 사이트별 모델을 세분화하는 방법을 설명합니다.

최상의 성능을 위해 reCAPTCHA 사기 방지에는 트랜잭션의 결제 수명 주기 이벤트에 대한 가시성이 필요합니다. 따라서 트랜잭션 데이터로 만든 평가에 대한 주석을 전송하는 것이 좋습니다. 예를 들어 다음 시나리오에서는 트랜잭션 정보를 트랜잭션 이벤트로 reCAPTCHA 사기 방지에 제공할 수 있습니다.

  • 결제 시스템 공급자가 트랜잭션을 수락하거나 거부합니다.

  • 판매자가 환불을 처리합니다.

  • 결제 기관에서 환불을 신청합니다.

주석을 전송하는 방법에 대한 자세한 내용은 평가에 주석 추가를 참조하세요.

트랜잭션 상태가 변경되는 등 데이터를 사용할 수 있는 경우 시스템에서 해당 로직의 일부로 이러한 요청을 자동으로 수행하는 것이 좋습니다.

포함된 트랜잭션 데이터로 평가를 만들면 reCAPTCHA 사기 방지에서 결과와 평가 이름을 반환합니다. 트랜잭션 이벤트 발생 시 다음과 같이 결제 수명 주기의 중요 단계에서 트랜잭션 이벤트로 평가에 주석을 추가합니다.

이벤트 유형 설명 이유 예시 값 예시
MERCHANT_APPROVE | MERCHANT_DENY 트랜잭션을 계속 진행하도록 허용할지 여부를 결정하는 경우 IN_HOUSE 해당 사항 없음
AUTHORIZATION | AUTHORIZATION_DECLINE 처리할 트랜잭션을 제출하면 카드 발급기관에서 트랜잭션 진행 여부를 결정할 수 있습니다. 82(CVV가 잘못되었음을 의미하는 이유 코드) 해당 사항 없음
CHARGEBACK 트랜잭션이 지불 거절되는 경우 Card Reported Stolen 20(통화 20단위의 부분 지불 거절 표시)

CHARGEBACK 이벤트 유형과 함께 reason 필드를 사용하여 카드 발급기관에서 제공한 지불 거절 이유 코드를 포함합니다. 또한 트랜잭션이 부분적으로 지불 거절된 경우 value 필드에 지불 거절된 금액도 포함합니다.

트랜잭션 이벤트 reason에는 이벤트 이유에 대한 추가 컨텍스트를 제공하거나 결제 네트워크 또는 카드 발급기관에서 직접 가져온 이유 코드를 제공하는 명확한 설명이 포함됩니다. 용어와 코드는 이벤트 유형에 따라 다릅니다.

다음 표에서는 트랜잭션 이벤트 유형의 전체 목록을 명시합니다.

주석 이유 설명
MERCHANT_APPROVE 판매자가 트랜잭션을 승인했음을 나타냅니다. 부수적인 이유로 IN_HOUSE, ACCERTIFY, CYBERSOURCE 또는 MANUAL_REVIEW와 같은 용어가 포함될 수 있습니다.
MERCHANT_DENY 판매자가 감지한 위험으로 인해 트랜잭션이 거부되고 완료되었음을 나타냅니다. 부수적인 이유로 IN_HOUSE, ACCERTIFY, CYBERSOURCE 또는 MANUAL_REVIEW와 같은 용어가 포함될 수 있습니다.
MANUAL_REVIEW 의심 또는 위험으로 인해 사람이 트랜잭션을 평가하고 있음을 나타냅니다.
AUTHORIZATION 카드 발급기관의 승인 시도가 성공했음을 나타냅니다.
AUTHORIZATION_DECLINE 카드 발급기관의 승인 시도가 실패했음을 나타냅니다. 부수적인 이유로 카드가 만료되었음을 나타내는 Visa의 54 또는 CVV가 잘못되었음을 나타내는 82가 포함될 수 있습니다.
PAYMENT_CAPTURE 금액이 결제되어 트랜잭션이 완료되었음을 나타냅니다.
PAYMENT_CAPTURE_DECLINE 금액이 결제되지 않아 트랜잭션을 완료할 수 없음을 나타냅니다.
CANCEL 트랜잭션이 취소되었음을 나타냅니다. 취소 이유를 지정합니다. 예를 들면 INSUFFICIENT_INVENTORY입니다.
CHARGEBACK_INQUIRY 트랜잭션에 대한 사기로 인해 판매자에게 지불 거절 문의를 전송했으며, 사기로 인한 지불 거절이 공식적으로 실행되고 정식 지불 거절 알림이 전송되기 전에 추가 정보를 요청함을 나타냅니다.
CHARGEBACK_ALERT 트랜잭션에 대한 사기로 인해 판매자가 지불 거절 알림을 받았음을 나타냅니다. 결제 네트워크의 개입 없이 분쟁을 해결하는 프로세스가 시작됩니다.
FRAUD_NOTIFICATION 트랜잭션이 사기로 판단되므로 결제 수단 발급 은행에서 발송하는 트랜잭션에 대해 사기 알림이 발행되었음을 나타냅니다. 이 이벤트 유형의 reason 필드에 TC40 또는 SAFE 데이터를 포함하는 것이 좋습니다. 부분 지불 거절의 경우 value 필드에 금액을 포함하는 것이 좋습니다.
CHARGEBACK 결제 네트워크를 통해 판매자에게 사기로 인해 해당 트랜잭션에 대한 지불 거절 프로세스가 시작되었음을 알립니다. 이유 코드 예시로는 Discover의 6005 및 6041 등이 있습니다. 부분 지불 거절의 경우 value 필드에 금액을 포함하는 것이 좋습니다.
CHARGEBACK_REPRESENTMENT 사기로 인해 트랜잭션이 대한 지불 거절 프로세스가 시작되었으며 해당 판매자가 대표를 입력하도록 선택되었음을 나타냅니다. 이유 예시로는 Discover의 6005 및 6041 등이 있습니다. 부분 지불 거절의 경우 value 필드에 금액을 포함하는 것이 좋습니다.
CHARGEBACK_REVERSE 해당 트랜잭션에 불법적인 사기 지불 거절이 포함되어 결과적으로 해당 트랜잭션이 취소되었음을 나냅니다. 부분 지불 거절의 경우 value 필드에 금액을 포함하는 것이 좋습니다.
REFUND_REQUEST 판매자가 완료된 트랜잭션에 대한 환불을 받았음을 나타냅니다. 부분 환불의 경우 value 필드에 금액을 포함하는 것이 좋습니다. 이유 예시는 FRAUD입니다.
REFUND_DECLINE 판매자가 이 트랜잭션에 대한 환불 요청을 받았지만 거부했음을 나타냅니다. 부분 환불의 경우 value 필드에 금액을 포함하는 것이 좋습니다. 이유 예시는 FRAUD입니다.
REFUND 판매자가 완료된 트랜잭션을 환불했음을 나타냅니다. 부분 환불의 경우 value 필드에 금액을 포함하는 것이 좋습니다. 이유 예시는 PROACTIVE_FRAUD입니다.
REFUND_REVERSE 판매자가 완료된 트랜잭션을 환불했으며 이 환불이 취소되었음을 나타냅니다. 부분 환불의 경우 value 필드에 금액을 포함하는 것이 좋습니다.

다음 예시에서는 트랜잭션 이벤트가 포함된 샘플 주석 페이로드를 보여줍니다. 자세한 내용은 평가 주석 추가를 참조하세요.

POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
{
  "transaction_event": {
    "event_type": "CHARGEBACK",
    "reason": "Card Reported Stolen",
    "value": 20
  }
}

다음 단계