> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# 카드 거절 및 위험 규칙

> Whop Card 거래가 거절되는 이유와 승인 과정에서 적용되는 위험 규칙

Whop Cards는 모든 승인에 시스템 규칙, 카드 한도, 실시간 위험 검사를 적용합니다. 이 페이지에서는 Whop이 카드 거래를 거절할 수 있는 이유, 접할 수 있는 승인 코드, 그리고 적용되는 자동 위험 규칙을 설명합니다.

## 일반적인 거래 거절 사유

거절은 시스템 규칙, 카드 한도, 실시간 위험 검사 등 여러 이유로 발생할 수 있습니다. Whop이 거래를 거절하면 거래에 사유를 기록합니다.

이 목록이 전부는 아닙니다. 일부 거절은 Whop 규칙이 아니라 카드 네트워크나 처리업체에서 발생하며, 이러한 거절이 우선 적용됩니다. 이 경우 사유가 `restricted card`와 같은 일반적인 설명일 수 있으며, Whop이 사유를 받지 못할 수도 있습니다.

## 거절 시 할 수 있는 일

많은 거절은 직접 조치할 수 있는 결과입니다. 다음 표는 일반적인 사유를 원인 및 다음 단계와 연결해 보여 줍니다.

| 거절 사유 | 의미 | 할 수 있는 일 |
| - | - | - |
| `card spending limit exceeded` | 거래가 카드에 설정된 지출 한도에 도달했습니다 | 카드의 지출 제어 설정을 검토하거나 조정하세요 |
| `account credit limit exceeded` | 거래에 필요한 사용 가능 잔액이 부족합니다 | 다시 시도하기 전에 잔액에 자금을 추가하세요 |
| `card locked` / `card canceled` / `card not activated` | 카드가 활성 상태가 아닙니다 | 카드 상태를 관리하세요(필요에 따라 활성화 또는 잠금 해제) |
| `invalid pin attempt limit exceeded` | 개인 식별 번호(PIN)를 너무 여러 번 잘못 입력했습니다. 시스템이 카드를 자동으로 잠급니다 | 카드 잠금을 해제해 접근 권한을 복구하거나 Whop 지원팀에 문의하세요 |
| `transaction declined by risk rules` | 사기 위험 평가 엔진이 승인을 거절했습니다 | 엔진이 거래를 잘못 거절했다고 생각되면 Whop 지원팀에 문의하세요 |
| `restricted country` | 제한되었거나 제재 대상인 관할 지역에서 발생한 거래입니다 | 이 거절은 규정 준수 정책에 따른 것이므로 재정의할 수 없습니다 |

알아 두면 좋은 몇 가지 추가 기본 설정:

* 현금 자동 입출금기(ATM) 인출은 기본적으로 사용할 수 없습니다.
* Whop은 준현금 및 일부 송금 카테고리를 기본적으로 제한합니다.
* 3D Secure(3DS): 3DS 인증에 실패하면 거절될 수 있습니다.
* 주소 확인 서비스(<abbr title="주소 확인 서비스">AVS</abbr>): Whop은 이 서비스를 지원하며 카드별로 설정할 수 있습니다. 불일치는 거절의 원인이 될 수 있습니다.

## 승인 코드와 의미

Whop Cards는 특정 승인 코드를 사용해 각 거래의 맥락과 상태를 분류합니다. 자주 접하는 코드는 다음과 같습니다.

| 코드 | 의미 |
| - | - |
| 00 | 일반 제시 |
| 01 | 고객 미대면 |
| 02 | 무인 단말기 - 단말기가 카드를 보관할 수 있음 |
| 03 | 가맹점 의심 |
| 05 | 고객 대면, 카드 미제시 |
| 06 | 사전 승인 요청 |
| 07 | 전화 장치 필요 |
| 08 | 우편/전화 주문 |
| 09 | <abbr title="판매 시점">POS</abbr> 보안 경고 |
| 10 | 고객 신원 확인됨 |
| 11 | 의심스러운 활동 |
| 12 | 보안상의 이유 |
| 13 | 항목 재제시 |
| 14 | 공공 유틸리티 단말기 |
| 15 | 고객 단말기 |
| 16 | 관리용 단말기 |
| 17 | 반환된 항목 |
| 18 | 봉투에 수표 없음 - 반환 |
| 19 | 입금액 불일치 - 반환 |
| 20 | 결제액 불일치 - 반환 |
| 21 | 수동 취소 |
| 22 | 단말기 오류 - 집계됨 |
| 23 | 단말기 오류 - 집계되지 않음 |
| 24 | 입금액 불일치 - 적용 |
| 25 | 결제액 불일치 - 적용 |
| 26 | 인출 오류 - 취소됨 |
| 27 | 무인 단말기 - 단말기가 카드를 보관할 수 없음 |
| 51 | 계좌 번호 확인 요청 |
| 59 | 공용 네트워크를 통한 전자상거래 요청 |
| 71 | 카드 제시, 마그네틱 띠 판독 불가(미국 전용) |

## 승인 과정에서 적용되는 위험 규칙

Whop Cards는 위험도가 높거나 의심스러운 거래를 막기 위해 자동 위험 탐지 규칙을 적용합니다. 각 규칙에는 시간 범위와 발동 기준이 있습니다.

| 규칙 이름 | 설명 | 시간 범위 | 발동 기준 |
| - | - | - | - |
| 차단 국가 | 차단된 국가에서의 모든 거래를 거절합니다 | 즉시 | 해당 없음 |
| 고위험 <abbr title="가맹점 카테고리 코드">MCC</abbr> | 고위험 가맹점 카테고리 코드의 거래를 거절합니다 | 즉시 | 해당 없음 |
| 고위험 전자상거래 | 플래그가 지정된 온라인 가맹점의 거래를 거절합니다 | 즉시 | 해당 없음 |
| 카드 제시 급속 거래 | 5분 안에 2건을 초과하는 거래를 시도하면 카드 제시 거래의 급증을 차단합니다 | 5분 | 거래 2건 |
| 카드 속도 | 개인 카드 전용. 같은 카드에서 짧은 시간에 몰린 거래를 거절합니다 | 15분 / 1시간 | 거래 40 / 60건 |
| 카드-MCC 속도 | 개인 카드 전용. 하나의 <abbr title="가맹점 카테고리 코드">MCC</abbr> 내에서 같은 카드로 짧은 시간에 몰린 거래를 거절합니다 | 15분 / 1시간 | 거래 35 / 50건 |
| 카드 건수 및 금액 속도 | 개인 카드 전용. 같은 카드가 시간 범위 내에서 거래 건수와 총액을 모두 초과하면 거절합니다 | 15분 / 1시간 / 24시간 | 30건 및 $2,000 / 45건 및 $3,000 / 300건 및 \$15,000 |
| 카드-MCC 건수 및 금액 속도 | 개인 카드 전용. 같은 카드가 시간 범위 내에서 하나의 <abbr title="가맹점 카테고리 코드">MCC</abbr> 안에서 거래 건수와 총액을 모두 초과하면 거절합니다 | 15분 / 1시간 / 24시간 | 25건 및 $2,000 / 40건 및 $3,000 / 250건 및 \$12,000 |
| 카드-가맹점 일일 속도 | 24시간 안에 같은 카드와 가맹점 간 거래가 200건을 초과하면 거래를 거절합니다. `transaction declined by risk rules`로 표시됩니다 | 24시간 | 거래 200건 |
| 카드-가맹점 인증 15분 급증 속도 | 같은 카드와 가맹점 간 거래가 14분 안에 20건을 초과하면 Google 임시 보류(인증) 청구를 거절합니다 | 14분 | 거래 20건 |
| <abbr title="자동 주유기">AFD</abbr> 승인 보류 | \$175 미만의 주유(<abbr title="가맹점 카테고리 코드">MCC</abbr> 5542) 승인을 거절하는 대신 초과 승인 보류로 처리합니다 | 즉시 | \$175 <abbr title="미국 달러">USD</abbr> |
| 게임 한도 | \$2,000를 초과하는 단일 비디오 게임 또는 디지털 상품(<abbr title="가맹점 카테고리 코드">MCC</abbr> 5816/7994) 거래를 거절합니다 | 즉시 | \$2,000 <abbr title="미국 달러">USD</abbr> |
| 게임 속도 | 2일 안에 게임 거래가 25건을 초과하면 거절합니다 | 2일 | 거래 25건 |
| 광고 서비스 한도 | \$10,000를 초과하는 단일 광고 서비스(<abbr title="가맹점 카테고리 코드">MCC</abbr> 7311) 거래를 거절합니다 | 즉시 | \$10,000 <abbr title="미국 달러">USD</abbr> |
| 광고 서비스 속도 | 24시간 안에 40건을 초과하는 광고 서비스(<abbr title="가맹점 카테고리 코드">MCC</abbr> 7311) 거래를 거절합니다 | 24시간 | 거래 40건 |
| 성인 콘텐츠 한도 | \$200를 초과하는 단일 성인 콘텐츠(<abbr title="가맹점 카테고리 코드">MCC</abbr> 5967) 거래를 거절합니다 | 즉시 | \$200 <abbr title="미국 달러">USD</abbr> |
| 성인 콘텐츠 속도 | 24시간 안에 10건을 초과하는 성인 콘텐츠(<abbr title="가맹점 카테고리 코드">MCC</abbr> 5967) 거래를 거절합니다 | 24시간 | 거래 10건 |
| <abbr title="카드 확인 값">CVV</abbr> 보안 | 24시간 안에 카드 확인 값을 4번 잘못 입력하면 거래를 차단합니다 | 24시간 | 거래 4건 |
| <abbr title="현금 자동 입출금기">ATM</abbr> 인출 한도 | \$250를 초과하는 현금 자동 입출금기 인출(<abbr title="가맹점 카테고리 코드">MCC</abbr> 6011) 거래를 차단합니다 | 즉시 | \$250 <abbr title="미국 달러">USD</abbr> |
| <abbr title="현금 자동 입출금기">ATM</abbr> 인출 속도 | 24시간 안에 3건을 초과하는 거래를 시도하면 현금 자동 입출금기 인출(<abbr title="가맹점 카테고리 코드">MCC</abbr> 6011)을 차단합니다 | 24시간 | 거래 3건 |
| 고속도 – EA Sports FC | 24시간 안에 Google EA Sports FC에서 같은 카드로 5건을 초과하는 거래가 발생하면 거절합니다 | 24시간 | 거래 5건 |
| 고속도 – Discord | 7일 안에 Discord 가맹점에서 같은 카드로 10건을 초과하는 거래가 발생하면 거절합니다 | 7일 | 거래 10건 |
| 고속도 – Free Fire MAX | 24시간 안에 Google Free Fire MAX에서 같은 카드로 10건을 초과하는 거래가 발생하면 거절합니다 | 24시간 | 거래 10건 |

표에는 기본 기준이 표시되어 있습니다. 위험 규칙이 바뀌면 Whop이 기준을 업데이트할 수 있습니다.

이러한 규칙과 함께 사기 위험 엔진이 거래를 평가합니다. Whop은 고위험 승인을 `transaction_declined_by_risk_rules`로 거절합니다.

## 차단된 카테고리 및 가맹점

Whop Cards는 기본적으로 특정 가맹점 카테고리 코드와 특정 가맹점을 차단합니다. 전체 목록은 [차단된 카테고리 및 가맹점](https://docs.whop.com/ko/whop-finance/blocked-categories-and-merchants.md)을 참고하세요.

## 다음 단계

> [card] [차단된 카테고리 및 가맹점](https://docs.whop.com/ko/whop-finance/blocked-categories-and-merchants.md)
>
> Whop Cards가 기본적으로 차단하는 가맹점 카테고리와 가맹점을 확인하세요

> [card] [Whop Cards](https://docs.whop.com/ko/whop-finance/cards.md)
>
> 잔액을 즉시 사용하고 일부 가맹점에서 캐시백을 받으세요
