Api-Version-Date를 전달하지 않고 저장된 API 키 고정 버전도 없다면 안정적인 API 모델이 사용됩니다. 둘 다 없는 요청은 버전 관리 이전의 동작으로 처리되므로 기존 연동은 변경 없이 계속 작동합니다. 최신 API를 사용하려면 날짜 버전을 고정하세요.API 키 버전 고정
API 키는 자체 API 버전 고정 값을 가집니다. API 키로 인증된 요청은Api-Version-Date를 생략하면 해당 고정 버전을 사용합니다. 저장된 고정 버전이 없는 기존 키는 2025-01-01을 사용합니다. 새로 생성된 키는 최신 릴리스 버전을 사용합니다.
명시적인 Api-Version-Date 헤더는 항상 API 키의 고정 버전보다 우선하므로, 저장된 버전을 변경하기 전에 업그레이드를 테스트할 수 있습니다.
모든 버전은 새 엔드포인트와 선택적 필드를 자동으로 받습니다. 호환성을 깨는 변경 사항은 새로운 날짜 버전을 생성하며, 아래 변경 로그에 나열됩니다.
업그레이드할 때는 대상 월의 항목만이 아니라 현재 고정 버전 이후부터 대상 버전까지의 모든 항목을 검토하세요. 특히 2026-07-20에서 9월로 업그레이드하면 2026-07-23의 멤버 및 멤버십 마이그레이션을 거치게 됩니다.
변경 로그
아래에 나열된 TypeScript SDK 릴리스는 기본적으로 해당 항목의 API 버전을 사용합니다.apiVersionDate를 재정의하면 응답 버전은 변경되지만 SDK 타입은 변경되지 않습니다.
Retrieve user 및 Retrieve account의
level에는 이제 current, points, points_by_source, resets_at이 있으며, 계정에는 account_level도 있습니다.다음 필드는 level에서 제거됩니다: levels, points_to_next, monthly_qualifying_spend, monthly_card_spend, monthly_ads_spend, monthly_trading_volume. 계정의 level에서 boosted가 제거됩니다. 계정의 account_level이 current보다 낮으면 해당 계정은 부스트된 상태입니다.Retrieve user 및 Retrieve account에서
level.applied_level의 이름이 level.current로 변경됩니다. 값은 변경되지 않습니다: 적용되는 레벨로, 0부터 10까지입니다.GET /partners/referred_users는 2026년 11월 17일 이후 응답을 중단합니다. 11월 18일부터 모든 버전이 410을 반환합니다. 그때까지 각 응답에는 Deprecation 및 Sunset 헤더가 포함됩니다. 이 목록에는 대체 항목이 없습니다.파트너는 더 이상 사용자에게 기여 요청을 보낼 수 없습니다. 이는 이 버전뿐만 아니라 모든 API 버전에 적용됩니다.Create a partner referral request는
target_user_id, target_username, target_email을 code가 user_referral_requests_retired인 400으로 거부합니다. 비즈니스에 대한 기여를 요청하려면 account_id 또는 account_url을 전송하세요. 사용자에게 보낸 요청은 더 이상 목록에 표시되거나 조회되지 않으며, list partner referral requests의 target_user_id 필터는 요청을 반환하지 않고, 요청의 user는 항상 null입니다.Retrieve user는 본인뿐만 아니라 계정이 Whop Levels에 속한 모든 사용자에 대해
level을 반환합니다. level.applied_level은 사용자의 레벨로, 0부터 10까지입니다.points, points_by_source, monthly_* 금액, levels 등 level의 다른 필드는 예약된 ID me로 본인을 조회하고 잔액 읽기 스코프가 있는 경우가 아니면 null입니다. 읽기 전에 null인지 확인하세요.사용자 자격 증명으로 list payments에
user_id=me를 사용하면 본인의 결제가 반환됩니다. 여기에는 모든 계정에서의 구매와 판매를 대행하는 계정에서의 결제가 포함됩니다. 구매한 계정의 account_id를 추가하면 해당 구매만 나열됩니다. Retrieve payment는 본인이 구매한 결제를 반환합니다.구매에는 구매자로서 볼 수 있는 정보가 표시됩니다. amount_after_fees, usd_total, holds, metadata 같은 계정 측 필드는 null이거나 비어 있습니다. amount_charged는 구매자 수수료를 포함하여 청구된 금액을 나타냅니다.팀 멤버에는 더 이상 최상위
account_id가 없습니다. 계정 ID는 account.id에서 읽으세요. account 객체에는 계정의 title, route, logo_url도 있습니다./leads 엔드포인트는 지원 중단되었으며 더 이상 API 레퍼런스에 나열되지 않습니다. 이 버전 이상에서는 410을 반환합니다. 이전 버전은 2026년 11월 20일까지 Deprecation, Sunset 및 후속 Link 헤더와 함께 계속 작동합니다. 그 이후에는 모든 버전이 410을 반환합니다.각 리드는 해당 비즈니스의 멤버이기도 하며, 멤버의 metadata에 리드 ID가 lead_id로 있습니다. 리드 목록 대신 List members를 사용하세요. 이메일로 멤버를 추가하려면 Create member를 사용하세요. 멤버를 읽거나 업데이트하려면 Retrieve member와 Update member를 사용하세요.GET /partners/referred_users는 지원 중단되었으며 더 이상 API 레퍼런스에 나열되지 않습니다. 기존 연동을 위해 모든 응답에 Deprecation 헤더와 함께 계속 응답하며, 대체 항목은 없습니다.청구서를 생성하거나 항목을 교체하면 첫 번째 청구서에 반복 변형의
initial_price와 renewal_price가 청구됩니다. 갱신 청구서에는 renewal_price만 청구됩니다. 다른 필드를 편집해도 청구서에 저장된 가격은 유지됩니다.첫 번째 청구서를 결제하면 변형의 체험 기간 없이 즉시 유료 청구 기간이 시작됩니다. 유한한 결제 횟수에는 해당 청구서가 포함됩니다: $75 선불 수수료와 $40 할부 3회의 경우 $115, $40, $40이 청구됩니다.TypeScript SDK:
@whop/sdk@2.8.0.Retrieve account preferences의 economic_intelligence_offers에 있는 갱신 오퍼의 키가 이제 3_days입니다. 3일마다 갱신됩니다. 활성화하려면 Update account preferences에 economic_intelligence_duration_key: "3_days"를 전송하세요. weekly 키는 거부됩니다.Create ad stats에서
clicks 필드가 제거됩니다. 시간별 clicks는 Whop 픽셀이 기록한 광고의 페이지 조회수이며, 어떤 버전에서든 전송된 clicks 값은 무시됩니다.앱에 채팅을 구축하세요. 채널은 다이렉트 메시지, 그룹 채팅, 커뮤니티 채팅, 지원 채팅을 다룹니다. 채널 멤버는 사람을 추가하고 제거합니다. 메시지는 전송, 편집, 고정, 반응, 투표가 가능합니다.이 버전부터
/messages의 형태가 변경됩니다. 메시지에는 user 대신 channel_id와 author가, is_edited와 is_pinned 대신 edited와 pinned가 있습니다. 업데이트 대신 POST /messages/{id}/pin 및 /unpin으로 고정하세요. Delete message는 204를 반환합니다. 반응과 투표는 POST /messages/{id}/react, /unreact, /vote로 하세요.Iron 은행 입금은
line_type이 onchain_deposit인 원장 활동 라인이며, source.sender_address는 iron입니다. 금융 활동 및 금융 보고서의 line_types 필터는 더 이상 bank_transfer를 받지 않습니다.List saved payout methods에는 계정의 Whop Card가 포함됩니다. List payouts에는 자금을 Whop Card로 옮긴 지급이 포함됩니다. 저장된 지급 수단과 지급의
payout_method에는 type이 있습니다. external은 자금을 Whop 외부로 보냅니다. whop_card는 자금을 계정 자체의 Whop Card로 옮깁니다. 사용자가 출금 위치를 선택하는 목록에서는 whop_card 수단을 제외하세요.증거가 결제 처리업체에 있고 아직 수락되지 않은 분쟁은
under_review 대신 generating_response를 보고합니다. 처리업체가 이를 수락하면 분쟁은 under_review로 이동합니다. 처리업체가 거부하면 분쟁은 needs_response로 돌아가며, 조회 시 submission_failure_reason이 제공됩니다. 두 이동 모두 dispute.updated로 전송됩니다.사용자와 계정의
level에서 current는 이제 applied_level이며, processing_rate_percentage는 제거됩니다. 레벨의 표준 카드 처리 비율은 levels의 해당 항목에서, 계정 자체의 요율은 Retrieve account fees에서 읽으세요. 계정의 level에는 계정 자체 포인트가 도달한 레벨인 account_level도 추가됩니다.Whop은 더 이상 광고 인증을 제공하지 않습니다. Retrieve account preferences 및 Update account preferences는 더 이상
ads_certifications를 반환하지 않으며, 업데이트에서도 더 이상 받지 않습니다.플랫폼 하위 계정은 subaccount라고 부릅니다. List payments와 List disputes, 그리고 해당 요약 엔드포인트에서
include_connected_accounts는 이제 include_subaccounts입니다. Update account preferences에서 covers_connected_account_negative_balances는 응답과 업데이트 본문 모두에서 이제 covers_subaccount_negative_balances입니다. connected_accounts 그룹화를 사용하던 금융 보고서 행은 이제 subaccounts를 사용합니다.Create a payout에 이제
quote_token이 필요합니다. 먼저 POST /payouts/quotes를 호출한 다음, 견적이 만료되기 전에 동일한 지급 세부 정보와 함께 해당 토큰을 제출하세요. 견적이 없거나 유효하지 않으면 invalid_payout_quote와 함께 400이 반환됩니다. 불확실한 지급을 재시도할 때는 원래 토큰과 Idempotency-Key를 다시 전송하여 견적이 만료된 후에도 기존 지급을 복구할 수 있도록 하세요.Update invoice에서 초안의 현재 고객과 다른
member_id는 null을 포함하여 400을 반환합니다. 다른 사람에게 청구하려면 먼저 초안을 무효화하세요. 그런 다음 새 청구서를 생성하세요. 고객 없이 저장된 초안은 여전히 고객을 지정할 수 있습니다.Connect an External Account는
advertise 스코프를 사용하던 마지막 플랫폼인 snapchat을 더 이상 받지 않으므로, scopes 필드도 제거되었습니다. snapchat이나 scopes를 전송하면 400이 반환됩니다.광고 캠페인은 더 이상
bid_type을 받거나 반환하지 않습니다. 각 광고 네트워크가 자체 캠페인 입찰 방식을 선택하며, desired_cost_per_result는 모든 네트워크에서 목표값입니다: 광고 입찰 방식을 절대 변경하지 않습니다. bid_type을 전송하면 400이 반환됩니다.광고는 Whop 자체 페이지와 프로필로 운영되므로 더 이상 광고를 위해 계정을 연결하지 않습니다. Connect an External Account는 더 이상
meta_business를 받지 않으며, tiktok은 더 이상 advertise 스코프를 받지 않습니다. 둘 중 하나를 전송하면 400이 반환됩니다.전환 가치 규칙이 제거되며, 광고 네트워크는 각 전환의 원래 값을 받습니다. 전환 가치 규칙 목록 조회는 지원 중단되었습니다: 빈 목록을 반환하고, 더 이상 문서화되지 않으며, 응답에
Deprecation 헤더가 포함됩니다. 다른 모든 전환 가치 규칙 엔드포인트는 410을 반환합니다.더 이상 소셜 참여로 오디언스를 구축할 수 없습니다. 기존 참여 오디언스는 여전히
source_type engagement로 나열되지만, 더 이상 engagement를 반환하지 않습니다. Create audience에 engagement를 전송하거나 source_type으로 engagement를 전송하면 400이 반환됩니다. 전환 가치 규칙 대상은 더 이상 platform을 받거나 반환하지 않습니다. 각 대상은 Whop이 운영하는 모든 네트워크를 다루며, 대상에 platform을 전송하면 400이 반환됩니다.파트너십 광고는 더 이상 사용할 수 없습니다. 외부 계정의 파트너 목록 조회는 빈 목록을 반환합니다. 파트너를 추가하거나 제거하면
400이 반환됩니다. 이 엔드포인트는 더 이상 문서화되지 않으며, 응답에 Deprecation 헤더가 포함됩니다.광고 캠페인, 광고 그룹, 광고를 복제할 때 더 이상
preserve_engagement를 받지 않습니다. Duplicate an Ad Campaign, Duplicate an Ad Group, Duplicate an Ad에 이를 전송하면 400이 반환됩니다. 외부 계정의 게시물 또는 리드 양식 목록 조회는 지원 중단되었습니다: 둘 다 빈 목록을 반환하고, 더 이상 문서화되지 않으며, 응답에 Deprecation 헤더가 포함됩니다.광고는 더 이상
post_id를 반환하지 않습니다. 광고 그룹 타기팅 옵션 검색과 광고 그룹 도달 범위 추정은 지원 중단되었습니다: 둘 다 계속 작동하지만 더 이상 문서화되지 않으며, 응답에 Deprecation 헤더가 포함됩니다. 전환 가치 규칙 대상은 platform을 생략하여 Whop이 운영하는 모든 네트워크를 다룰 수 있습니다.광고 캠페인, 광고 그룹, 광고는 더 이상
platform을 반환하지 않으며, Create an Ad Campaign은 더 이상 이를 받지 않습니다. 새 캠페인은 awareness 목표를 사용할 수 없습니다. 기존 인지도 캠페인은 여전히 이를 반환합니다. 광고는 더 이상 existing_post_id, post_source, external_accounts, translations를 받거나 반환하지 않으며, 더 이상 post_thumbnail_url을 반환하지 않습니다. Create an Ad Campaign, Create ad, Update ad에 제거된 필드나 목표로 awareness를 전송하면 400이 반환됩니다.광고 캠페인은 더 이상
optimization_goal을 반환하지 않습니다. 광고 그룹은 더 이상 optimization_goal, conversion_location, message_apps, minimum_daily_spend, dynamic_creative, placements, frequency_cap, detailed_targeting을 받거나 반환하지 않으며, Whop은 캠페인의 objective에 따라 게재를 설정합니다. 광고는 더 이상 messaging_config, multi_advertiser_ads, lead_form, lead_form_id, music을 받거나 반환하지 않습니다. 이 중 하나를 Create ad group, Update ad group, Create ad, Update ad에 전송하면 해당 필드를 명시한 400이 반환됩니다.account_id를 사용한 List variants는 레거시 청구서용으로 생성된 변형(이후 청구서가 삭제된 변형 포함)을 제외합니다. 이를 읽으려면 ID로 변형을 조회하세요. 지원 중단된 GET /plans 목록도 동일하게 동작합니다.Create swap에서 지갑의
from_token 잔액을 초과하는 소수 amount는 400을 반환합니다. 오류에는 사용 가능한 잔액이 명시됩니다. 이전 버전은 스왑을 시작한 다음 온체인에서 실패합니다. 잔액을 읽을 수 없는 경우 확인을 건너뜁니다. USDT 스왑은 카드 잔액에서도 인출할 수 있으므로 USDT는 확인하지 않습니다.멤버십, 멤버, 대기자 명단 항목. 멤버십과 대기자 명단 항목에서
plan_id는 이제 variant_id이며, 대기자 명단 항목에 포함된 변형에서 plan_type은 이제 billing_type입니다. Invite to a membership과 Create waitlist entry는 variant_id를 받고, Approve all waitlist entries는 variant_id를 받고 반환합니다. List memberships는 variant_id와 variant_ids로, List members는 variant_ids로, List waitlist entries는 variant_id로 필터링하며, plan_id와 plan_ids는 사용하지 않습니다.결제, 청구서, 분쟁. 결제, 분쟁, Resolution Center 케이스에서 plan_id는 이제 variant_id이며, 해당 line_items에서 plan_id와 plan_title은 이제 variant_id와 variant_title입니다. 결제 견적 및 청구서 line_items에서 plan_id는 이제 variant_id입니다. List payments는 plan_ids 대신 variant_ids로 필터링합니다. Create payment와 Create payment quote는 본문과 line_items의 각 항목에서 plan_id와 plan 대신 variant_id와 variant를 받습니다. 청구서 생성 및 업데이트는 items의 각 항목에서 plan_id와 plan 대신 variant_id와 variant를 받습니다. 인라인 variant는 plan_type 대신 billing_type을 받습니다. 이벤트에서 related.plan은 이제 related.variant입니다.체크아웃. 체크아웃 구성에서 plan은 이제 variant이며, 그 plan_type은 이제 billing_type입니다. Create checkout configuration은 plan_id 대신 variant_id를, plan 대신 인라인 variant(billing_type 포함)를 받으며, List checkout configurations는 variant_id로 필터링합니다. 체크아웃 세션 요청 및 응답은 items[].plan 대신 items[].variant를 사용합니다.프로모션 코드 및 파트너. List promo codes는 plan_ids 대신 variant_ids로 필터링하며, Create promo code는 variant_ids를 받습니다.상품에서
default_plan은 이제 default_variant입니다. 변형과 상품에 포함된 변형에서 plan_type은 이제 billing_type입니다. Create variant는 billing_type을 받으며, List variants와 List products는 plan_types 대신 billing_types로 필터링합니다./plans 대신 /variants와 variants SDK 네임스페이스를 사용하세요. /plans 엔드포인트는 모든 버전에서 Deprecation 및 후속 Link 헤더와 함께 계속 응답합니다. 세금을 미리 보려면 같은 방식으로 지원 중단된 POST /variants/{id}/calculate_tax 또는 POST /plans/{id}/calculate_tax를 호출하는 대신 결제 견적을 생성하세요.변형 ID는 plan_ 접두사를 유지하며, plan:* 권한 스코프와 plan.* 웹훅 이벤트 이름은 변경되지 않습니다.Create team member가 멤버를 추가하는 대신 초대를 보내는 경우,
202 응답은 이제 대기 중인 팀 멤버입니다. status는 pending이며 ID는 ausri_로 시작합니다. 응답에는 더 이상 object나 invitation_sent가 포함되지 않습니다.네이티브 Invoices API는
pay_ ID와 인라인 변형 생성을 포함한 변형 기반 items를 사용합니다. 생성 시 초안이 저장됩니다. 초안을 업데이트할 수 있으며, 더 이상 필요 없는 초안은 무효화할 수 있습니다. 청구 대상 고객은 멤버입니다. Whop 사용자에 속하지 않은 이메일은 새 사용자를 생성합니다. recipient_emails는 청구 대상 멤버와 별개인 청구서 자체의 전달 주소입니다. 구매자 수수료는 조정 가능한 비율입니다.Create verification과
owners의 소유자에서 document_type은 소문자 값을 받습니다: passport, id_card, drivers, residence_permit. 신분 증명 문서 가이드에 국가별로 허용되는 문서가 나열되어 있습니다.Create deposit에서 저장된 결제 수단에 대한 청구가 최상위
card에서 bank 및 crypto 옆의 methods.card로 이동했습니다. 필드는 변경되지 않았으며, payment_method_id가 전달되지 않으면 여전히 null입니다. 이전 버전에 고정된 호출자는 최상위 card를 유지합니다.결제 수단 도메인 엔드포인트는 지원 중단되었으며 더 이상 API 레퍼런스에 나열되지 않습니다. 대신 도메인 API의
apple_pay 기능으로 Apple Pay 도메인을 추가, 확인, 제거하세요:GET /payment_method_domains:apple_pay=any를 사용한GET /domains, 또는 인증된 도메인의 경우apple_pay=ready.hostname대신domain으로 호스트 이름을 필터링하세요.GET /payment_method_domains/{id}:GET /domains/{id}.POST /payment_method_domains:domain,account_id,apple_pay: {}를 사용한POST /domains. 계정에 이미 도메인이 있다면apple_pay: {}를 사용한PATCH /domains/{id}.POST /payment_method_domains/{id}/verify:POST /domains/{id}/check.DELETE /payment_method_domains/{id}:apple_pay: null을 사용한PATCH /domains/{id}.DELETE /domains/{id}는 해당 도메인의 모든 웹사이트를 포함하여 도메인 전체를 제거합니다.status: verified는apple_pay.state: ready입니다.status: pending은 Whop이 도메인을 등록하는 동안에는apple_pay.state: pending이고, 연결 파일을 호스팅하고 도메인을 확인할 때까지는action_required입니다.
pending이 반환됩니다. apple_pay.state가 ready 또는 action_required가 될 때까지 도메인을 조회하세요./payment_method_domains 엔드포인트는 모든 버전에서 Deprecation 및 후속 Link 헤더와 함께 계속 응답합니다. 도메인은 ID를 유지하므로 /domains/{id}는 결제 수단 도메인이 반환한 ID를 받습니다. 도메인 API에는 company:manage_checkout 대신 domain:read 및 domain:manage 권한이 필요합니다.TypeScript SDK:
@whop/sdk@2.5.0.리뷰는 이제 네이티브 리소스를 사용합니다.- 리뷰 목록 조회 및 조회는 게시된 리뷰만 반환합니다. 대기 중이거나 제거된 리뷰를 조회하면
404가 반환됩니다. - 조회된 리뷰는
company대신account를 반환합니다. - 리뷰 목록 조회는
account_id또는product_id로 필터링하고,order와direction으로 정렬하며, 기본적으로 페이지당 20개의 리뷰를 반환합니다. 필터 없이 사용하면 사용자는 자신이 작성한 리뷰를, 계정 또는 앱 API 키는 해당 계정의 리뷰를 나열합니다. company_id는 더 이상 허용되지 않습니다.account_id를 사용하세요.DELETE /reviews/{id}는 로그인한 사용자가 작성한 리뷰를 삭제하며review:delete스코프가 필요합니다.
계정에 더 이상
industry_group이 포함되지 않으며, PATCH /accounts/{id}는 더 이상 이를 받지 않습니다. business_type과 industry_type이 계정을 분류합니다.계정 분류는 읽기 전용입니다. Whop이 business_type과 industry_type을 설정하며, PATCH /accounts/{id}는 더 이상 이를 받지 않습니다.TypeScript SDK:
@whop/sdk@2.4.0.앱에 더 이상 previous_hosted_urls가 포함되지 않습니다. 앱의 주소는 앱을 제공하는 도메인입니다: GET /domains로 나열하거나 앱의 domains를 읽으세요.이체는
name과 logo_url이 포함된 origin 및 destination 프로필을 반환합니다. amount와 fee 금액 객체에는 수신자 입금액과 모든 이체 수수료가 포함됩니다. 응답에는 사용 가능한 실패 타임스탬프와 추적 URL도 포함됩니다. 알 수 없는 과거 금액 및 전환 시간은 null입니다.계정 필터 없이 GET /transfers는 호출자가 권한을 가진 계정과 개인 지갑 전체의 이체를 나열합니다. 계정 범위 자격 증명은 해당 계정으로 계속 제한됩니다.POST /transfers에는 balance 또는 claim_link 중 하나인 type이 필요합니다. 이것이 없는 요청은 400을 반환합니다. ledger 유형의 이름은 balance로 변경되고, wallet_send는 제거됩니다. 이전 버전은 ledger와 wallet_send를 받으며, type이 생략되면 balance 이체를 생성합니다.결제에 더 이상
pdf_url이 포함되지 않습니다. 결제 영수증을 PDF로 받으려면 POST /payments/{id}/generate_pdf를 호출하세요. 파일을 다운로드할 url과 해당 링크가 만료되는 expires_at을 반환합니다.TypeScript SDK:
@whop/sdk@2.3.0.계정의 payment_controls.undated_pending_reason은 compliance_review일 수 있습니다. 이는 판매자가 이미 제출한 인증이 검토 중이므로, 검토가 완료될 때까지 대기 중인 자금이 대기 상태로 유지된다는 의미입니다. 이전 버전에 고정된 호출자는 이 상태에서 null을 봅니다.economic_intelligence_offers에는 끌 때까지 매주 갱신되는 weekly 오퍼가 포함됩니다. 각 오퍼에는 auto_renew가 있으며, weekly가 권장 오퍼입니다. 활성화하려면 PATCH /accounts/{account_id}/preferences에 economic_intelligence_duration_key: "weekly"를 전송하세요.economic_intelligence_offers는 계정이 지금 선택할 수 있는 항목만 나열합니다. Economic Intelligence가 켜져 있는 동안에도 더 이상 null이 아닙니다: 약정 기간 중에는 업그레이드로서 weekly만 나열하고, weekly가 갱신 중일 때는 비어 있습니다. 이전 버전은 Economic Intelligence가 켜져 있는 동안 null을 유지하고, weekly를 제외하며, 1_day를 권장합니다.return_url이 있는 저장된 결제 수단 청구(member_id 및 payment_method_id)는 이제 구매자가 있는 것으로 간주합니다. 이는 off_session을 생략한 경우에 적용됩니다. 카드 발급사가 구매자에게 인증을 요청하면 결제는 next_action과 함께 requires_action 상태가 됩니다. 자체 일정에 따른 갱신처럼 구매자 없이 카드를 청구하는 경우 off_session: true를 전달하세요.recipient로 지급 수단을 생성하면 발신자의 원장에 연결된 기본이 아닌 수신자 지급 계정이 생성됩니다. Whop 사용자, Whop 계정, 수신자 원장은 생성되지 않습니다. 수신자 응답에는 first_name, last_name, country가 포함됩니다. 더 이상 user_id는 포함되지 않습니다. 이전 API 버전은 Whop 사용자가 없을 때 수신자 세부 정보를 생략합니다. 이전 버전은 기존 수신자의 사용자 ID를 유지합니다.지표의 시계열은
GET /stats/time_series/{metric}에서 조회하세요. GET /stats/{metric}도 여전히 이를 제공하며 Deprecation 헤더에 후속 경로를 명시합니다.소셜 계정은 이제 외부 계정입니다.
/external_accounts와 externalAccounts SDK 네임스페이스를 사용하세요. 이전 /social_accounts 엔드포인트는 모든 버전에서 Deprecation 및 후속 Link 헤더와 함께 계속 응답합니다. 외부 계정 ID는 sacc_ 접두사를 유지하며, social_account:* 권한 스코프는 변경되지 않습니다.광고는 요청과 응답 모두에서 계정을 social_accounts 대신 external_accounts로 명명합니다. 오디언스 참여 규칙은 계정을 social_account_id 대신 external_account_id로 명명합니다. /external_accounts에서 Instagram 계정을 소유한 페이지는 parent_social_account 대신 parent_external_account입니다. 고정된 API 버전이 없는 광고 웹훅은 external_accounts를 받습니다.설정 인텐트를 생성하면 이제
processing 상태로 반환되며 결제 수단은 백그라운드에서 저장됩니다. 결제 생성은 이미 이 방식으로 작동합니다. 결과를 확인하려면 설정 인텐트를 폴링하거나 client_secret을 handleNextAction에 전달하세요. 최종적으로 저장되거나, 거부되거나, 구매자의 단계를 기다리게 됩니다. 이전 버전은 요청 중에 계속 저장합니다.TypeScript SDK:
@whop/sdk@2.1.0, @whop/sdk@2.2.0.판정 전에 고객이 환불받은 분쟁은 이제 closed 대신 status: prevented입니다. 환불은 카드 네트워크(Visa RDR) 또는 이전 환불에서 이루어졌습니다.Whop AI가 수행 중인 추천은
status: running입니다. 실행이 끝나면 executed가 되며, 추천을 수행하지 못하고 끝난 경우 incomplete가 됩니다. 이전 버전은 실행 중인 추천을 ready로, 미완료 추천을 superseded로 표시합니다.추천은 run_started_at, run_ended_at, run_by_user_id, result_url, acknowledged_at도 반환합니다. 추천을 직접 실행하려면 PATCH /economic_intelligence/{id}에 status: running을 전송한 다음, status: executed(선택적 result_url 포함) 또는 status: incomplete를 전송하세요. 실행 완료된 실행을 확인한 것으로 표시하려면 status: acknowledged를 전송하세요. 추천은 executed 상태로 유지되며 acknowledged_at을 기록합니다.Economic Intelligence를 켜려면
PATCH /accounts/{account_id}/preferences에 economic_intelligence_duration_days 대신 economic_intelligence_duration_key를 전송하세요. economic_intelligence_offers에 있는 항목의 key를 사용하세요.economic_intelligence_offers의 각 항목에는 duration_days 대신 key, duration, duration_unit이 있습니다. 기간은 hours 또는 days 단위로 계산할 수 있습니다.광고의
primary_texts, headlines, descriptions는 요청과 응답에서 { language, text } 객체의 배열입니다. 번역이 없는 광고에서는 language를 생략하세요. API는 일반 문자열을 거부하므로 대신 [{ "text": "…" }]를 전송하세요.Meta 광고는 다른 언어로도 운영할 수 있습니다. translations: { source_language, automatic_languages }를 광고 자체 문구의 언어와 Meta가 자동으로 번역할 언어로 설정하세요. 그러면 해당 광고의 모든 문구와 creatives 항목은 language를 명시합니다. 광고 자체의 문구와 크리에이티브는 source_language를 사용하며, 직접 작성하는 각 언어에는 primary_texts와 headlines 항목, 그리고 선택적으로 descriptions와 creatives 항목이 있습니다. translations: null은 다른 언어를 끕니다.이전 API 버전은 번역이 있는 광고를 업데이트할 수 없습니다. 이 버전을 명시한 400을 받습니다.Economic Intelligence를 켜려면
PATCH /accounts/{account_id}/preferences에 economic_intelligence_duration_days를 전송하세요. 각 기간의 수수료가 나열된 economic_intelligence_offers에서 기간을 선택하세요. Economic Intelligence는 economic_intelligence_ends_at까지 변경하거나 끌 수 없으며, 그때 자동으로 꺼집니다.economic_intelligence는 읽기 전용입니다. 이를 전송하면 400 오류가 반환됩니다.TypeScript SDK:
@whop/sdk@2.0.0.GET /permissions는 계정의 권한 작업을 나열하거나 확인할 때 crypto_wallet:trade와 crypto_wallet:trade:read를 포함합니다.Economic Intelligence 추천은
expected_tool_calls를 tool_name과 description이 있는 객체의 정렬된 배열로 반환합니다. 설명은 계획된 작업과 영향을 받는 리소스를 식별합니다. 이전 추천의 설명은 null입니다.파트너 추천 요청은 보상 유무와 관계없이 링크에
request_type: "link"를 사용합니다. 링크를 생성하거나 필터링할 때 link를 사용하세요. 승인된 직원만 보상을 구성할 수 있습니다.Retrieve Account는
rewards에 파트너 보상 마일스톤을 반환합니다. 각 마일스톤에는 해당 계정의 자격 진행 상황과 지급 상태가 포함됩니다. 일치하는 보상이 없거나 호출자에게 잔액 또는 통계 읽기 액세스가 없으면 이 필드는 빈 배열입니다.레거시 온보딩 보상 형식은 종료됩니다. 이전 API 버전은 계정 응답에서 rewards를 생략합니다.네이티브 Payments API가 이제
POST /setup_intents, GET /setup_intents, GET /setup_intents/{id}를 제공합니다. Setup Intent 객체는 다른 모든 네이티브 리소스와 같은 형태를 갖습니다.- 관련 레코드는 포함된 객체 대신 외래 키 ID입니다:
account_id(이전company),member_id(이전member),payment_method_id(이전payment_method),checkout_configuration_id(이전checkout_configuration). 구매자는user요약(id,username,name,profile_picture)입니다. error_message는 Retrieve setup status가 반환하는 것과 동일한{ code, message }블록인last_setup_error로 이동합니다. 무언가 실패하기 전까지null로 유지되며, 설정이 성공하면 제거됩니다.return_url,payment_method_type,updated_at이 새로 추가됩니다.created_at과updated_at은 ISO 8601 타임스탬프입니다.- Payment 객체가 이미 포함하고 있는 표시용 수단인
payment_instrument가 Setup Intent에도 있으므로, 저장된 카드를 두 번째 요청 없이 렌더링할 수 있습니다. 두 리소스 모두에서card에exp_month와exp_year가 추가됩니다.card.brand는null일 수 있습니다: 저장소에 네트워크가 기록되지 않은 저장된 카드는card객체 전체를 잃는 대신 마지막 네 자리와 만료일을 유지합니다. - 설정 인텐트를 생성하면
201 Created(이전200)로 응답하고,Idempotency-Key를 준수하며,confirmation_token또는payment_method_id중 정확히 하나가 필요합니다. 다른 계정의 확인 토큰은404입니다. client_secret은 생성 및 조회 시 반환되며, 이 API를 통해 생성된 설정에 대해서만 반환됩니다. 설정에 대해 작업할 수 있는 호출자가 필요합니다: 계정의payment:charge자격 증명 또는 구매자 자신의 토큰. 목록 행은 항상null입니다.- 이 버전 이상으로 고정된
setup_intent.requires_action,setup_intent.succeeded,setup_intent.canceled웹훅은 이 동일한 Setup Intent 객체를data로 전달합니다. 이전 버전으로 고정된 웹훅과 고정되지 않은 웹훅은 이전 페이로드를 유지합니다. GET /setup_intents는 표준{ data, page_info }봉투와 커서 페이지네이션으로 나열합니다.account_id는 선택 사항입니다: 계정 API 키는 자체 계정을, 사용자 토큰은 읽을 수 있는 모든 계정을 나열합니다.status는 새 필터이며, 유효하지 않은 값은400입니다.created_before와created_after는 이전과 같이 작동합니다.
POST /ad_campaigns/{id}/retry_payment는 410 Gone을 반환합니다. 모든 캠페인에 대한 결제 재시도를 한 번 대기열에 추가하려면 계정의 biz_ ID로 POST /accounts/{id}/retry_ads_payment를 사용하세요. 재시도가 접수되었다고 해서 결제 성공이 확인되는 것은 아닙니다. 결과는 캠페인의 delivery_status와 issues를 확인하세요.TypeScript SDK:
@whop/sdk@1.1.5.계정, 변형, 체크아웃 구성, 체크아웃 세션은 세 가지 3D Secure 선택 사항을 제공합니다:mandate_challenge는 지원되는 온세션 카드 결제를 처리하기 전에 챌린지를 요청합니다.mandate_if_required는 결제 처리업체가 요구하는 경우에만 챌린지를 의무화합니다.frictionless_if_required는 일반 무마찰 3DS 흐름을 사용합니다.
mandate_if_required를 사용합니다. 위험 및 인증 복구 요구 사항이 설정을 재정의할 수 있습니다. 명시적인 필수 챌린지는 플랫폼에서 활성화될 때까지 거부됩니다.이전 API 버전은 기존 값을 유지합니다: 새로운 mandate_challenge 선택은 조건부로 유지되고, 기존 필수 설정은 보존되며, frictionless는 frictionless로 유지됩니다. 이전 버전의 계정은 무마찰을 null로 나타냅니다.금융 보고서 행은
trading_account_deposit, trading_account_withdrawal 및 해당 _offset 항목을 다른 온체인 이체와 구분합니다. 금액과 잔액은 변경되지 않습니다.이전 버전은 기존 카테고리를 유지합니다: 계정 입금은 topup, 계정 출금은 onchain_withdrawal. 전역 보고서는 해당하는 onchain_deposit, onchain_withdrawal, _offset 카테고리를 사용합니다. 일치하는 행은 이체 금액을 누락하지 않고 합산됩니다.계정 설정의
ads_triple_whale_integration.status는 requires_shopify_store 대신 requires_shop_domain을 보고합니다. 이제 연동에서 shop_domain을 명시적으로 설정할 수 있으므로, 연결된 Shopify 스토어가 더 이상 이를 제공하는 유일한 방법이 아닙니다.TypeScript SDK:
@whop/sdk@1.1.4.계정의 business_type, industry_group, industry_type은 고정된 열거형 대신 Whop의 비즈니스 카테고리 테이블에서 가져온 문자열입니다. 새 카테고리는 새 API 버전 없이 표시됩니다. 비즈니스 유형 및 업종 용어집에 현재 값이 나열되어 있습니다.coaching_and_courses는 이제education,physical_product는 이제ecommerce,marketplace는 이제platform입니다.- 업종 그룹과 유형은 8개의 비즈니스 유형 아래로 재구성되었습니다.
PATCH /accounts/{id}는 용어집 슬러그만 받습니다. 알 수 없는 값은400을 반환합니다.
null로 반환됩니다.실험을 생성하려면
biz_ 접두사가 붙은 소유 account_id가 필요합니다. 실험은 선택적 리소스 참조와 계정에 로컬인 플래그 키도 받습니다. 목록 조회는 하나의 계정에 대한 실험을 반환하며, 읽거나 관리하려면 계정 권한이 필요합니다. 계정 실험은 팀 태그를 지원하지 않으며 보고 공급자를 프로비저닝하지 않습니다.평가는 subject[account_id], subject[anonymous_id], subject[user_id]를 통해 대상을 식별합니다. 이전 버전의 호출자는 기존 평가 식별 매개변수를 유지합니다. 타기팅 properties는 JSON 쿼리 값으로 전달하세요. 기존 중첩 속성 쿼리 키도 계속 지원됩니다. 노출은 선택적 자격 증명을 받으며 이벤트에 해당 신원을 기록합니다.TypeScript SDK:
@whop/sdk@1.1.3.Whop이 출금을 차단한 경우 계정의 payment_controls.undated_pending_reason은 withdrawals_disabled일 수 있으며, 이 경우 해당 대기 중인 자금은 사용 가능 상태가 될 수 없습니다.kyc_incomplete, pending_information_request, 그리고 아직 정산 중인 자금에 대한 null은 변경되지 않습니다.POST /audiences는 타입이 지정된 engagement 정의를 통해 동영상, 리드 양식, Instagram 프로필, Facebook 페이지와의 참여를 지원합니다.- 명시적인
source_type값은 필수 소스 필드가 있는지, 충돌하는 소스 필드가 없는지 검증합니다. - 오디언스 응답에는
engagement가 포함되며,source_type은engagement일 수 있습니다. 참여 오디언스는 유사 오디언스 소스로도 사용할 수 있습니다. GET /social_accounts/{id}/posts에는 플랫폼 식별자를 수동으로 찾지 않고도 동영상을 선택할 수 있도록video_id와caption이 포함됩니다.
POST /experiments/{id}/end는 요청 본문에 findings가 필요합니다. 이는 무엇을 배웠는지, 실험이 왜 그렇게 끝났는지에 대한 짧은 설명입니다.이전 버전에 고정된 호출자는 여전히 이를 생략할 수 있습니다. 400 대신 이들을 대신하여 자리 표시자 결과 값이 기록됩니다.TypeScript SDK:
@whop/sdk@1.1.1, @whop/sdk@1.1.2.POST /deposits는 destination 계정 ID 문자열(biz_… 또는 user_…)만 받습니다.- 원시 지갑 주소는 더 이상 허용되지 않습니다. 계정에 자금을 넣고
methods.crypto에서 주소를 읽으세요. destination의 객체 형식({ account_id }/{ address, network })이 제거됩니다. 계정 ID만 전송하세요.- 최상위
network재정의가 제거됩니다. 이는 응답을 변경한 적이 없습니다: 모든 입금은 이미 지원되는 모든 네트워크의 주소를 반환하므로methods.crypto에서 원하는 것을 선택하세요. - 요청과 응답 모두에서
metadata가 제거됩니다. 이 값은 그대로 반환될 뿐 저장되지 않았으므로 이후 입금을 대조하는 데 사용할 수 없었습니다. - 이제 모든 대상이 계정을 지정하므로 응답의
account_id는 더 이상 null이 아닙니다.
metadata가 포함됩니다(전송한 값이 아닌 빈 객체로). 지갑 주소는 모든 버전에서 거부됩니다: 계정을 식별한 적이 없으므로 계속 제공할 이전 형태가 없습니다. payment_method_id와 함께 전송된 metadata는 카드 청구에 첨부되므로 모든 버전에서 유지됩니다.TypeScript SDK:
@whop/sdk@1.1.0.POST /payments, GET /payments, GET /payments/{id}는 이제 네이티브 Payments API에서 제공되며, Payment 객체는 다른 모든 네이티브 리소스와 같은 형태를 갖습니다.- 관련 레코드는 포함된 객체 대신 외래 키 ID입니다:
account_id(이전company),plan_id,product_id,membership_id,member_id,promo_code_id,shipment_id,payment_method_id. 구매자는user요약(id,username,name,profile_picture)입니다. - 금액은 단순 숫자 대신 금액 객체(
{ amount, currency, decimals, display_decimals })입니다:total,subtotal,tax_amount,refunded_amount,tax_refunded_amount,amount_after_fees,usd_total.settlement_amount,settlement_currency,settlement_exchange_rate는total과currency에 통합됩니다.refunded_amount와tax_refunded_amount는 각 환불이 발행될 때 적용된 환율로 정산된 그대로 표시되며,tax_refunded_amount는 이제 조회뿐만 아니라 목록 응답에도 있습니다. - 분쟁, 환불, Resolution Center 케이스는 더 이상 포함되지 않습니다.
?payment_id=와 함께 각자의 엔드포인트에서 나열하세요. 포함된 금융 거래와 애플리케이션 수수료는 네이티브 형태로 이전되지 않습니다. last_payment_attempt/next_payment_attempt는last_payment_attempt_at/next_payment_attempt_at입니다. 카드 정보는payment_instrument에 있습니다.- 결제를 생성할 때
account_id(이전company_id)를 받고,201 Created로 응답하며,Idempotency-Key를 준수하고, 승인 보류를 걸기 위한capture: false를 받습니다. - 네이티브 결제 읽기는 계정 범위입니다: 자격 증명은 계정의 결제를 읽을 수 있어야 합니다(팀 멤버의 토큰 또는 계정의 API 키). 고정된 프록시 버전에서 본인 결제를 읽기 위해 허용되는 구매자 자신의 사용자 토큰은 아직 네이티브로 지원되지 않으므로, 구매자는 고정된 버전에서 계속 작동합니다.
GET /payments/{id}/fees행은 금액 객체가 포함된{ type, origin, label, description, amount, settlement_amount, collected_at }입니다(이전name/amount/currency/type).GET /refunds와GET /refunds/{id}는 네이티브 Refund를 반환합니다: 포함된 결제 대신payment_id와account_id, 결제 정산 통화로 된 금액 객체amount, 처리업체 통화로 된original_amount.company_id필터는account_id이며,company_id를 전송하면 400입니다.POST /payments/{id}/refund,POST /payments/{id}/retry,POST /payments/{id}/void도 네이티브이며, 동일한 Payment 객체를 반환합니다. 환불은 여전히 선택적partial_amount를 받습니다.GET /payments는 표준{ data, page_info }봉투와 커서 페이지네이션으로 나열합니다. 필터는 프록시의 복수 배열 대신 단수 동등 매개변수(status,billing_reason,currency,plan_id,product_id,membership_id,member_id,user_id,account_id)입니다. 프록시와 마찬가지로billing_reason=subscription_cycle은subscription_update로 기록된 갱신도 일치시킵니다. 금액이 0인 결제가 포함되므로 프록시의include_free는 없어졌습니다. 유효하지 않은status는 필터링되지 않은 페이지가 아닌400이며, 프록시 전용 필터(substatuses,updated_before/updated_after,checkout_configuration_ids, 복수 배열)도 마찬가지입니다.query구매자 검색은 이전과 같이 작동합니다.created_before/created_after기간은 결제 생성 시간만 대상으로 합니다. 프록시는 결제 시간이 있는 경우 결제 시간으로 필터링했습니다. 목록 행에서settlement_time_at은 null이므로, 이를 확인하려면 결제를 조회하세요.
레거시
GET /ad_reports 엔드포인트는 네이티브 Stats 지표와 광고 엔터티 엔드포인트로 대체되어 지원 중단되었습니다. 이 버전에서는 더 이상 제공되지 않습니다.GET /ad_reports는error.type이gone인410 Gone을 반환합니다. 시간에 따른spend,impressions,clicks는whop:adcamp_xxx:*같은source경로로 범위를 지정하여GET /stats/time_series/ad_delivery를 사용하세요. 기여 전환은GET /stats/time_series/events를 사용하세요.- 기간별 엔터티 성과는 엔터티 엔드포인트에 있습니다.
GET /ad_campaigns,GET /ad_groups,GET /ads는stats_from과stats_to를 받고 각 행에spend,results,return_on_ad_spend를 반환합니다. - 레거시 엔드포인트의 모든 응답은 버전에 관계없이 이제
Deprecation및Link: <…/stats/ad_delivery>; rel="successor-version"헤더를 포함합니다. 이전 버전에 고정된 요청과 버전이 없는 요청은Sunset헤더가 모든 버전에서 응답이 중단되는 날짜를 알릴 때까지 변경 없이 계속 작동합니다.
GET /financial_reports와 GET /financial_reports/breakdown은 이제 보고서 기간에 from 및 to ISO 8601 타임스탬프를 사용합니다.from_date와to_date의 이름이from과to로 변경됩니다.- 날짜만 있는 값은 더 이상 허용되지 않습니다. 두 타임스탬프 모두에 시간과 오프셋을 포함하세요.
GET /apps는 이제 공개 웹사이트 목록에서 verified가 없는 것을 verified=false로 처리하는 대신 선택적 동등 필터로 사용합니다.- 두 인증 상태 모두에서 공개적으로 검색 가능한 웹사이트 블루프린트를 반환하려면
verified를 생략하세요. - Whop 인증 블루프린트는
verified=true로, 커뮤니티 블루프린트는verified=false로 설정하세요. recommended=true는 인증 상태와 관계없이 추천 앱을 필터링합니다.
레거시
/withdrawals 엔드포인트는 네이티브 Payouts API로 대체되어 지원 중단되었으며 이 버전에서는 더 이상 제공되지 않습니다.GET /withdrawals와POST /withdrawals는error.type이gone인410 Gone을 반환합니다. 대신GET /payouts와POST /payouts를 사용하세요. 지급 ID는 동일한wdrl_ID이므로 기존 식별자는 계속 확인됩니다.GET /withdrawals/{id}는 이 버전에서도 계속 응답합니다. 새 작업에는GET /payouts/{id}를 사용하세요.- 레거시 엔드포인트의 모든 응답은 버전에 관계없이 이제
Deprecation및Link: <…/payouts>; rel="successor-version"헤더를 포함합니다.Sunset헤더가 모든 버전에서 응답이 중단되는 날짜를 알릴 것입니다. 그때까지 이전 버전에 고정된 요청과 버전이 없는 요청은 변경 없이 계속 작동합니다.
광고의
post_id는 이제 광고 제작 방식에 관계없이 광고 네트워크가 제공하는 게시물을 지정합니다.post_id는 광고에 대한 네트워크의 게시물을 반환합니다. 이는 업로드된 크리에이티브에 대해 Meta가 생성한 게시물이거나 홍보 중인 게시물입니다. 이전에는 업로드된 크리에이티브로 만든 모든 광고에서null이었습니다.- 광고가 가리키는 게시물은 응답과 생성/업데이트 본문 모두에서
existing_post_id로 이동했습니다.post_source와post_thumbnail_url은 해당 필드를 설명합니다.
TypeScript SDK:
@whop/sdk@1.0.14.POST /files와 GET /files/{id}는 재설계된 파일 객체와 함께 네이티브로 제공되며, 멀티파트 업로드는 새로운 POST /files/{id}/complete를 통해 완료됩니다.- 파일 응답은 표준 봉투를 포함합니다:
object,visibility, ISO 8601created_at.size와url필드는 업로드가ready가 될 때까지null입니다. GET /files/{id}는 본인이 생성한 파일만 확인하며, 다른 호출자는 404를 받습니다.
TypeScript SDK:
@whop/sdk@1.0.13.지급 객체의 수명 주기 용어가 재구성되고 금액 필드는 소수 문자열이 됩니다.status는 여덟 가지 값을 가집니다:requested,in_review,processing,completed,reversed,canceled,failed,denied. 공급자가 되돌린 정산된 지급은reversed로 표시되며, 반환 코드와funds_returned_at은failure에 있습니다.- 새
status_detail필드는 상태 값 아래의 가장 세부적인 기계 단계를 나타냅니다. 그 값은 버전 증가 없이 늘어날 수 있으며,status가 버전 관리되는 계약입니다. amount,fee_amount,net_amount,markup_fee,destination_amount는 소수 문자열입니다.exchange_rate는 숫자로 유지됩니다.- 지급은
wdrl_ID로 생성됩니다:POST /payouts가 반환하는 ID는GET /payouts가 나열하는 ID이며, 지급의 전환 요청은payout_request_id로 유지됩니다. 이 버전 이전에 생성된 전환 요청은 계속cofr_ID로 응답합니다. - 멱등성 키는
Idempotency-Key헤더로만 전송되며,idempotency_key본문 필드는 거부됩니다.
api_version_date를 따릅니다: 2026-08-21 이상으로 고정된 구독은 새 지급 형태를 받고, 이전 또는 고정되지 않은 구독은 이전 형태를 유지합니다.웹훅 봉투의
company_id 필드 이름이 account_id로 변경됩니다.2026-08-14이상으로 고정된 웹훅 전달은 봉투에account_id를 포함합니다.- 이전 버전에 고정된 웹훅과
api_version_date고정이 없는 웹훅은company_id를 유지합니다.
TypeScript SDK:
@whop/sdk@1.0.11.계정 및 개인 잔액 내역은 이제 pending과 함께 in_transit을 표시합니다.- 정산 대기 중인 총액을 표시하려면
pending과in_transit을 더하세요. - 이전 버전에 고정된 호출자는 계속
pending에서 합산 금액을 받습니다.
POST /webhooks와 PATCH /webhooks/{id}의 api_version 입력이 제거됩니다.- 새 웹훅은 항상
v1이벤트와 페이로드를 사용합니다.api_version을 전달하는 요청은400으로 거부됩니다. - 대신
api_version_date로 웹훅의 페이로드 형태를 고정하세요. - 기존
v2및v5웹훅은 계속 전달됩니다. 더 이상 이 버전으로 웹훅을 생성하거나 전환할 수 없습니다.
분쟁 알림은 이제 네이티브 REST 리소스이며 레거시 프록시와 함께 이중으로 제공됩니다.
GET /dispute_alerts는 커서 페이지네이션으로 계정의 알림을 나열하며,account_id,payment_id,type, 생성 기간으로 필터링합니다.type은alert_type을 대체하며 카드 발급사가 보내는 두 가지 유형을 지정합니다:early_fraud_warning(Visa TC40 / Mastercard SAFE 사기 보고서)과dispute_alert(분쟁 전 통지).fee_charged는charge_for_alert를 대체하며 Whop이 실제로 계정에 청구했는지를 보고합니다. 조기 사기 경고는 절대 청구되지 않습니다.actionable은 결제를 환불하여 여전히 지불 거절을 방지할 수 있는지를 보고합니다.payment및dispute객체는payment_id및account_id태그로 대체됩니다. 타임스탬프는 ISO 8601이며, 발급사가 보고서를 제출한 시점은reported_at입니다.
법정 화폐 쌍 스왑(두 법정 화폐를 사용한
POST /swaps)은 이제 자유 형식 환전을 지원하며, amount는 암호화폐 스왑 의미와 일치합니다.amount는 중간 시장 환율로 환전할from_token의 금액입니다. 마이너스 잔액이 필요하지 않습니다.- 마이너스
to_token잔액의 부분 상환 금액 지정은 새로운to_amount필드(to_token단위, 부채 금액으로 제한)로 이동했습니다.amount와to_amount는 상호 배타적입니다. - 둘 다 생략하면 여전히 마이너스
to_token잔액 전체를 상환합니다. - 이전 버전에 고정된 호출자는 이전 동작을 유지합니다: 법정 화폐
amount는to_token상환 금액으로 처리됩니다.
인증의
requested_information은 이제 평면 목록입니다: 항목당 하나의 요구 사항, 답변당 하나의 쓰기.- 각 항목은
requirement에 필요한 것을 지정합니다:bank_statement같은 문서 또는ssn같은 필드 키이며, 사용자에게 표시할label이 있습니다. file항목은file(직접 업로드 ID)로 답변하세요.text,date,phone,select항목은value로,address항목은address로 답변하세요. 응답의 어떤 내용도 그대로 반환되지 않습니다.multiple로 표시된 항목은 하나의 답변에서 여러 파일을 슬롯 순서대로 받으며, 양면 문서의 경우 앞면이 먼저입니다.options가 나열된 항목도value를 받습니다.select항목의 경우 옵션은 허용되는 답변입니다. 신분 증명 문서의 경우 옵션은 허용되는 ID 유형입니다.- 해당되지 않는 키는 생략되며, 거부된 제출에는 안정적인
code와reason이 포함된 구조화된errors가 있습니다. - 중첩된
requested_files/category양식 형태는 이 버전에서 제거되었습니다. 이전 버전에 고정된 호출자는 이를 유지하며, 답변은 자동으로 변환됩니다.
프로모션 코드는 이제 완전한 최상위 REST 리소스이며 레거시 프록시와 함께 이중으로 제공됩니다.
GET /promo_codes는 계정의 프로모션 코드를 나열하며company_id대신account_id를 사용합니다.POST /promo_codes는 프로모션 코드를 생성합니다.GET및DELETE /promo_codes/{id}는 이를 조회하고 보관합니다.POST /promo_codes/{id}/activate및POST /promo_codes/{id}/deactivate는 레거시PATCH상태 쓰기를 대체합니다.- 목록 응답은 커서 페이지네이션을 사용하며 상태, 상품, 변형, 타임스탬프, 정렬 필터를 지원합니다.
- 이전 버전에 고정된 호출자는 레거시 프록시 계약을 변경 없이 유지합니다.
계정 응답은 이제 연결된 계정에 대해 더 풍부한 상위 계정 관계를 제공합니다.
parent_account는parent_account_id를 대체합니다.- 상위 계정에는
id,title,route,logo_url이 포함됩니다.
지원되는 지급 수단에 이제 자체 페이지네이션 엔드포인트가 있습니다.
GET /payouts/supported_methods는 계정 또는 사용자가 추가할 수 있는 지급 수단을 나열합니다.- 지원되는 수단은
object: "supported_payout_method"를 사용하며, 해당podst_ID는supported_payout_method_id로 전달됩니다. - 저장된 지급 수단은
supported_payout_method를 제공합니다. 지급은payout_method.supported_payout_method를 제공합니다. - 지급 계정의 국가가 아닌 다른 국가의 지원 수단을 나열하려면
country를 사용하세요. GET /payouts/methods는 더 이상include_available을 받거나available_destinations를 반환하지 않습니다.- 이전 버전에 고정된 호출자는
destination_id,payout_destination,payout_token을 유지합니다.
카드 거래는 이제 네이티브 REST 엔드포인트를 사용하며 레거시 프록시와 함께 이중으로 제공됩니다.
GET /card_transactions는 계정의 카드 거래를 나열하고,GET /card_transactions/{id}는citx_ID로 하나를 조회합니다. 목록은 한 번의 요청으로 특정 거래를 가져오기 위한transaction_ids필터도 받습니다.- 카드 거래는 계정 범위입니다: 소유자는
account_id로 선택되며, 기본값은 자격 증명이 속한 계정입니다. transaction_ids,card_id,cardholder_id,status,created_after,created_before로 필터링합니다. 타임스탬프 필터는 ISO 8601입니다.- 응답에
cardholder_id가 새로 추가됩니다: 카드가 할당된 사용자입니다.
- 각 지급 수단은
amount없이도fee_structure(비율, 고정 금액, 통화)와estimated_arrival(속도별 타임스탬프)을 반환합니다. - 견적의
standard및instant객체에는 더 이상estimated_arrival이 포함되지 않습니다. 수단의 최상위estimated_arrival필드에서 읽으세요.
Resolution Center 케이스는 이제 네이티브 REST 엔드포인트를 사용하며 레거시 프록시와 함께 이중으로 제공됩니다.
status,escalated,outcome,refund,reason,available_actions는 케이스 상태와 허용된 작업을 제공합니다.- 이벤트는 페이지네이션된
GET /resolution_center_cases/{id}/events에서 사용할 수 있습니다. 요약은GET /resolution_center_cases/summary에서 사용할 수 있습니다. - 쓰기는
message와attachments를 사용합니다.due_date의 이름이response_due_at으로 변경됩니다. 목록 조회에 더 이상account_id가 필요하지 않습니다.
배송은 이제 네이티브 REST 엔드포인트를 사용하며 레거시 프록시와 함께 이중으로 제공됩니다.
GET /shipments는 배송을 나열합니다.GET /shipments/{id}는 배송 ID 또는 결제 ID로 조회합니다.POST /shipments는 배송을 생성하고,PATCH /shipments/{id}는 운송장 번호를 업데이트합니다.- 응답은
carrier,tracking_url,order_id,payment_id와 함께account_id와tracking_number를 사용합니다. - 이 날짜 이전에 고정된 호출자는 레거시 프록시 계약을 변경 없이 유지합니다.
분쟁은 이제 네이티브 REST 엔드포인트를 사용하며 레거시 프록시와 함께 이중으로 제공됩니다.
PATCH /disputes/{id}는 증거를 편집하고,POST /disputes/{id}/submit은 이를 제출합니다. 증거는evidence아래에 중첩됩니다.GET /disputes/summary는status와currency로 그룹화된 합계를 제공합니다. 목록과 조회는 동일한 필드를 반환합니다.- 응답은
account_id,product_id,plan_id와 함께payment옆에buyer를 사용합니다. 목록 조회에 더 이상account_id가 필요하지 않습니다. status와reason은 정규화된 열거형이며,needs_response_by,rdr,editable은 새 필드로 대체됩니다.- 이 날짜 이전에 고정된 호출자는 레거시 프록시 계약을 변경 없이 유지합니다.
멤버와 멤버십은 이제 계정 중심 멤버십 모델과 재설계된 수명 주기 작업을 갖춘 네이티브 리소스를 사용합니다.
- 멤버십 응답은 중첩된 호환성
plan및product객체 대신 호환성 필드plan_id와product_id를 반환합니다. - 멤버십 목록 조회는 호출자가 읽을 수 있는 모든 것(본인 및 관리하는 계정의 것)을 반환하며,
account_id/user_id는 모드를 전환하거나 오류를 발생시키는 대신 해당 목록을 좁힙니다. - 취소를 예약하려면
cancel_at_period_end를 설정하세요.cancel작업은 즉시 액세스를 종료합니다. extend작업은add_free_days를 대체합니다.
Current API는 이제 일관된 삭제 응답, 타임스탬프 입력, Account 명명을 사용합니다.
- 상품, 변형, 체크아웃 구성, 광고, 광고 그룹, 광고 캠페인, 소셜 계정, 바운티 제출물의 삭제 엔드포인트는 단순 boolean 대신
{ id, deleted: true }를 반환합니다. - 상품, 변형, 체크아웃 구성, 이체, 금융 보고서의 타임스탬프 필터는 epoch 초를 받지 않고 ISO 8601만 받습니다.
- 상품 응답은
company대신account를 반환합니다.
파트너 비즈니스는 이제 모든 수입원에 대해 별도의 지급 비율을 제공합니다.
payout_percentage는payout_percentages로 대체됩니다.- 중첩된 객체에는
sales,ad_spend,transfer,card_interchange비율이 포함됩니다.
상품과 체크아웃 구성은 이제 일관되게 Account 모델을 사용합니다.
- 상품 요청 매개변수는
company_id대신account_id를 사용합니다. - 체크아웃 구성 요청은 최상위와 호환성 필드
plan이 포함하는 인라인 변형 객체 안에서account_id를 사용합니다. - 체크아웃 구성 응답은
company_id대신account_id를 반환합니다.
체크아웃 구성 타임스탬프는 이제 API의 나머지 부분과 동일한 형식을 사용합니다.
created_at과updated_at은 Unix epoch 정수 대신 ISO 8601 문자열입니다.
사용자 잔액은 이제 완전하고 구조화된 잔액 요약을 제공합니다.
- 평면
total_usd및balances필드는 중첩된balance객체로 대체됩니다. - 요약은 현금, 암호화폐, 진행 중인 재무 입금, 사용자가 소유한 계정의 잔액을 구분합니다.
비즈니스 추천 수익은 이제 수익을 발생시킨 다형성 리소스를 식별합니다.
receipt는resource로 대체됩니다.access_pass는product로 대체됩니다.- 영수증 기반 수익은 영수증 결제 세부 정보와 함께
resource.object: "receipt"를 반환합니다. resource필드는 향후 버전에서 영수증 전용 필드를 재사용하지 않고 추가 수익 리소스를 지원할 수 있습니다.
비즈니스 추천 거래량과 수익은 이제 대조 그룹으로 보고됩니다.
processing_volume,total_earnings,pending_payout,completed_payout은 중첩된volume_usd및earnings_usd객체로 대체됩니다.- 수익은
base_amount/amount의 이름을transaction_amount_usd/commission_amount_usd로 변경하고payout_percentage를 분수로 표현합니다.
당시 Plans라는 이름이었던 변형은 이제 일관되게 Account 모델을 사용합니다.
- 요청 매개변수와 요청 본문은
company_id대신account_id를 사용합니다. - 변형 응답은
company대신account를 반환합니다.
사용자 액세스 요청은 이제 일관되게 Account 모델을 사용합니다.
- 요청 매개변수와 요청 본문은
company_id대신account_id를 사용합니다. - 응답 형태는 변경되지 않습니다.

