Skip to main content
사기 결제는 금액 손실, $15 분쟁 수수료, 그리고 분쟁률 악화를 초래합니다. Whop은 자체 사기 방지 통제로 체크아웃을 검사합니다. 결제 규칙은 그 위에 자체 계층을 추가합니다. 직접 작성한 조건과, 체크아웃이 모든 조건과 일치할 때 Whop이 수행하는 작업으로 구성됩니다. 규칙은 Whop의 통제 이후에 실행되며 이를 완화하지 않습니다. Whop이 차단한 결제는 계속 차단됩니다.

규칙이 작동하는 네 가지 방식

규칙은 risk_score, amount_in_usd, card_country, card_bin, customer_email, ip_address를 읽을 수 있습니다. card_bin은 결제에 사용된 카드의 은행 식별 번호(BIN)로, 카드 번호의 처음 여섯 자리입니다. List fields는 각 필드가 허용하는 연산자와 값을 반환합니다. 확실하지 않은 경우에는 차단하기보다 인증을 요구하세요. 차단은 조건에 일치하는 실제 구매자까지 거부하지만, 인증 요구는 구매자가 카드 소유자임을 증명할 수 있게 합니다.
WHOP_API_KEY가 설정된 신뢰할 수 있는 서버 환경에서 이 예제를 실행하세요. 사용하는 언어의 첫 번째 예제에 있는 import와 클라이언트 설정을 재사용하세요.

명백한 사기 차단하기

분쟁에서 가장 자주 보이는 패턴부터 시작하세요. 이 규칙은 미국 외에서 발급된 카드로 Whop 점수가 85 이상인 결제를 차단합니다.
항상 account_id를 전달하세요. 이를 생략하면 자격 증명의 기본 계정에 규칙이 적용되는데, 여러 계정을 관리하는 플랫폼에서는 실수하기 쉽습니다. 규칙은 매분 체크아웃에 게시되므로 새로 만들거나 변경한 규칙은 몇 분 내에 적용되기 시작합니다.
필요한 권한: 규칙 작성에는 payment:manage, 읽기에는 payment:basic:read가 필요합니다. 권한 가이드에서 권한을 추가하세요.

대규모 주문에 인증 요구하기

도난 카드로 이루어진 대규모 주문은 가장 피하고 싶은 차지백입니다. 실제 고객의 대규모 주문은 가장 잃고 싶지 않은 판매입니다. 3D Secure 인증은 이 둘을 구분하며, 구매자가 인증을 통과하면 결제에 three_ds_verified: true가 기록됩니다. 체크아웃에서 인증을 진행할 수 없는 경우 enforce_3ds는 건너뛰지만 결제에는 계속 기록됩니다. 여기에는 갱신과 같은 오프세션 결제, 자체 3D Secure 수준을 설정한 변형, 카드가 아닌 결제, 결제 처리업체가 인증을 요구할 수 없는 카드가 포함됩니다. American Express는 USD 결제에서만 인증을 요구합니다.

청구 전에 결제 검토하기

review 규칙은 적격 카드 결제를 매입하지 않고 승인합니다. 구매자는 체크아웃을 완료하고 승인 시점에 멤버십 액세스를 받습니다. 직접 처리하는 주문이나, 위험하지만 확실한 사기는 아닌 패턴에 사용하세요. 먼저 조치하지 않으면 Whop이 48시간 후에 자동으로 매입합니다:
  • 금액을 받으려면 매입하세요. 결제가 paid가 되고 Whop이 주문 처리 신호인 payment.succeeded를 보냅니다.
  • 보류를 해제하려면 무효화하세요. Whop이 액세스를 취소하고, 예약된 재고를 반환하고, payment.canceled를 보냅니다.
Whop은 보류가 시작될 때와 API로 요청한 승인에 대해서도 payment.authorized를 보냅니다. 보류된 결제는 status: "authorized"와 substatus: "requires_capture"로 표시됩니다. auto_capture_at은 결제 상태 조회로 확인하세요. 이 규칙은 미국 외에서 발급된 카드로 이루어진 $250 이상의 카드 결제를 보류합니다.
주문을 검토한 후 결제 ID로 매입하세요:
또는 무효화하세요:

검토 제한 사항

  • 온세션 카드만 보류할 수 있습니다. Apple Pay, Google Pay, 은행, 잔액, 그리고 갱신과 같은 오프세션 결제는 검토를 건너뜁니다. 일치 내역은 여전히 payment_rule_matches에 기록됩니다.
  • capture: false로 생성된 결제는 자체 일정을 유지합니다. 검토 규칙은 이를 재정의하지 않습니다.
  • 매입은 전부 아니면 전무입니다. 일부를 돌려주려면 이후에 환불하세요.
  • 결정하기 전에 구매자가 이미 상품을 받습니다. 무효화하는 경우 구매자에게 알리세요.

신뢰할 수 있는 구매자의 원활한 결제 유지하기

allow 규칙은 신뢰하는 구매자를 차단, 검토, 인증 요구 규칙에서 제외합니다.

규칙 강화하기

규칙의 동작은 생성 후 고정되므로, 규칙이 결정한 결제는 계속해서 그 규칙을 가리킵니다. 작업이나 조건을 변경하려면 규칙을 교체하세요. 기존 규칙은 삭제되고 새 ID를 가진 후속 규칙이 이름, metadata, 활성 상태를 이어받습니다. 이 예에서는 실제 구매자를 너무 많이 차단한 후 차단 임계값을 85에서 90으로 높입니다.
규칙을 일시 중지하려면 비활성화하고, 재개하려면 활성화하세요. 규칙을 폐기하려면 삭제하세요. 삭제된 규칙은 status: "deleted"로 계속 조회할 수 있습니다.

효과 측정하기

각 결제는 일치한 규칙을 당시의 규칙 이름과 함께 payment_rule_matches에 나열합니다.
일치 항목이 없는 결제에서 분쟁이 발생한다면 규칙이 너무 좁은 것입니다. 실제 손실보다 훨씬 많은 결제와 일치하는 규칙은 너무 넓은 것입니다. 기간별 합계는 Stats API의 payment_rule_matches 및 payment_rule_matched_volume 지표를 payment_rule_ids 또는 action별로 분류하여 확인하세요.

다음 단계

결제 규칙 레퍼런스

모든 엔드포인트, 매개변수, 응답 필드입니다.

환불 및 분쟁

여전히 통과하는 차지백에 대응하세요.