Skip to main content
분쟁에는 이의가 제기된 결제, 응답 기한, 제출한 증빙 자료, 그리고 처리업체가 판정한 이후의 결과가 포함됩니다. Disputes API를 사용하여 분쟁을 조회하고, 분쟁에 아직 이의를 제기할 수 있는 동안 증빙 자료 패킷을 편집하여 검토를 위해 제출하거나, 이의를 제기하지 않으려는 차지백을 수락할 수 있습니다.

엔드포인트

속성

string
필수
분쟁 ID이며, 접두사는 dspt_입니다.
boolean
필수
POST /disputes/\{id} /accept로 분쟁을 고객에게 양보할 수 있는지 여부입니다. 아직 응답을 기다리는 차지백이고, evidence_due_at 이전이며, 결제 처리업체가 분쟁 수락을 지원하는 경우에만 true입니다. 문의는 수락할 수 없습니다.
string | null
필수
분쟁이 제기된 계정으로, 접두사는 biz_입니다.
number
필수
분쟁 금액으로, currency의 정수 단위입니다.
object
필수
분쟁을 제기한 고객입니다.

속성

string | null
필수
고객의 이메일 주소입니다. member:email:read 범위가 필요하며, 없으면 null입니다.
string | null
필수
계정에서 고객의 멤버 행으로, 접두사는 mem_입니다.
string | null
필수
고객의 표시 이름입니다.
string | null
필수
고객의 사용자 ID로, 접두사는 user_입니다. 게스트 체크아웃의 경우 null입니다.
string | null
필수
고객의 Whop 사용자 이름입니다.
string
필수
분쟁이 시작된 시점으로, ISO 8601 타임스탬프입니다.
string
필수
분쟁 금액의 세 글자 ISO 통화 코드입니다.
object
필수
분쟁에 이의를 제기하기 위해 처리업체에 보내는 증빙 자료 패킷입니다.

속성

string | null
필수
로그인 또는 다운로드 활동 등 고객의 상품 접근 기록입니다.
string | null
필수
고객이 체크아웃 시 제공한 청구지 주소입니다.
object | null
필수
취소 정책 문서입니다. 기본값은 계정의 취소 정책이며, 없으면 서비스 약관, 그다음 반품 정책, 그다음 Whop의 플랫폼 정책 순으로 사용됩니다.

속성

string | null
필수
첨부 파일 ID입니다. 업로드된 파일이 아닌 Whop 호스팅 정책은 null입니다.
string | null
필수
업로드된 파일의 MIME 유형입니다.
string | null
필수
업로드된 파일의 이름입니다.
boolean
필수
판매자가 정책을 업로드하지 않아 대신 사용되는 Whop 자체 호스팅 정책인지 여부입니다. PATCH 요청으로 다시 보내도 아무것도 변경되지 않습니다.
string | null
필수
첨부 파일을 다운로드할 수 있는 URL입니다.
string | null
필수
구매 전에 고객에게 취소 정책이 어떻게 표시되었는지입니다.
object | null
필수
고객과의 서신 또는 고객이 상품을 사용했다는 증거입니다.

속성

string | null
필수
첨부 파일 ID입니다. 업로드된 파일이 아닌 Whop 호스팅 정책은 null입니다.
string | null
필수
업로드된 파일의 MIME 유형입니다.
string | null
필수
업로드된 파일의 이름입니다.
boolean
필수
판매자가 정책을 업로드하지 않아 대신 사용되는 Whop 자체 호스팅 정책인지 여부입니다. PATCH 요청으로 다시 보내도 아무것도 변경되지 않습니다.
string | null
필수
첨부 파일을 다운로드할 수 있는 URL입니다.
string | null
필수
고객이 체크아웃 시 사용한 이메일 주소입니다.
string | null
필수
체크아웃 시 고객이 입력한 이름입니다.
object[]
필수
네 개의 고정 슬롯 외의 추가 증빙 문서로, PATCH /disputes/\{id}에서 evidence.documents로 설정합니다. 각 문서는 document_type에 따라 제출된 패킷에 포함됩니다.

속성

string
필수
파일 ID이며, 접두사는 file_입니다.
string | null
필수
이미지 또는 비디오의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
string | null
필수
업로드된 파일의 MIME 유형입니다. 업로드는 처리업체가 허용하는 유형으로 제한되며, 유형이 없으면 거부되므로 절대 null이 아닙니다.사용 가능한 옵션: application/pdf, application/json, image/jpeg, image/png, image/webp
string
필수
파일이 생성된 시점으로, ISO 8601 타임스탬프입니다.
string
필수
이 문서가 증명하는 내용입니다. return_policy, cancellation_policy, terms_of_service는 판매자의 정책 문서입니다. 정책 문서는 이 분쟁에 대해 계정의 사본을 대체합니다. return_policy, cancellation_policy, customer_communication은 해당하는 고정 증빙 슬롯도 대체합니다. shipping_policy는 판매자의 배송 약관입니다. customer_communication은 지원 스레드나 채팅 기록 같은 구매자와의 서신입니다. product_image는 구매자가 받은 상품 또는 서비스의 사진입니다. physical_fulfillment는 실물 주문이 배송되어 도착했다는 증거입니다. digital_fulfillment는 구매자가 디지털 상품에 접근했다는 증거입니다. customer_order_history는 이 판매자에 대한 구매자의 과거 주문 내역입니다. prior_transactions는 사기 방어를 위한 플랫폼 전체의 구매자 결제 내역입니다. customer_session은 IP 주소, 기기 지문, AVS 및 CVV 결과, 3D Secure 결과 같은 체크아웃 데이터입니다. subscription은 갱신, 취소, 발송된 알림 같은 멤버십 수명 주기 증빙입니다. complete_evidence는 최대 19페이지의 PDF 하나로 된 판매자의 전체 응답이며, 유일한 문서여야 합니다. Whop은 다른 모든 증빙 필드, 첨부 파일, 문서 대신 complete_evidence 문서를 처리업체에 보냅니다.사용 가능한 옵션: return_policy, shipping_policy, cancellation_policy, terms_of_service, physical_fulfillment, customer_order_history, product_image, prior_transactions, customer_session, digital_fulfillment, subscription, customer_communication, complete_evidence
number | null
필수
오디오 또는 비디오 길이(초)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름입니다.
integer | null
필수
이미지 또는 비디오 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
integer | null
각 파트(마지막 파트 제외)의 바이트 크기입니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.
string | null
멀티파트 업로드의 ID로, complete에 다시 전달합니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.
object[] | null
각 파트의 미리 서명된 URL입니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.

속성

integer
필수
멀티파트 업로드 내에서 이 파트의 인덱스(1부터 시작)입니다.
string
필수
이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
string
필수
이 객체의 유형으로, 항상 file입니다.
boolean
필수
모더레이션으로 파일이 제거되었는지 여부입니다. true이면 url은 대체 이미지를 제공합니다. filename, size, content_type은 여전히 원본 파일을 설명합니다.
integer | null
필수
파일 크기(바이트)입니다. 업로드가 완료될 때까지 null입니다.
object
업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 존재합니다.
string
필수
파일의 업로드 수명 주기 단계입니다.사용 가능한 옵션: pending, processing, ready, failed
string | null
파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 단일 파트 업로드에만 존재합니다.
string | null
필수
파일을 다운로드할 수 있는 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명 URL을 받습니다. 업로드가 완료될 때까지 null입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
string
필수
public 파일은 서명되지 않은 CDN URL에서 제공됩니다. private 파일은 만료되는 서명 URL에서 제공됩니다.사용 가능한 옵션: public, private
string | null
필수
오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
integer | null
필수
이미지 또는 비디오 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
string | null
필수
분쟁을 검토하는 처리업체를 위한 추가 정보입니다.
string | null
필수
판매자 자신의 말로 설명한, 고객이 구매한 항목입니다.
object | null
필수
환불 정책 문서입니다. 기본값은 계정의 반품 정책이며, 없으면 서비스 약관, 그다음 Whop의 플랫폼 정책 순으로 사용됩니다.

속성

string | null
필수
첨부 파일 ID입니다. 업로드된 파일이 아닌 Whop 호스팅 정책은 null입니다.
string | null
필수
업로드된 파일의 MIME 유형입니다.
string | null
필수
업로드된 파일의 이름입니다.
boolean
필수
판매자가 정책을 업로드하지 않아 대신 사용되는 Whop 자체 호스팅 정책인지 여부입니다. PATCH 요청으로 다시 보내도 아무것도 변경되지 않습니다.
string | null
필수
첨부 파일을 다운로드할 수 있는 URL입니다.
string | null
필수
구매 전에 고객에게 환불 정책이 어떻게 표시되었는지입니다.
string | null
필수
환불이 요청되었으나 거절된 경우, 환불이 거절된 이유입니다.
string | null
필수
상품 또는 서비스가 제공된 시점입니다.
object | null
필수
다른 카테고리에 해당하지 않는 보조 증빙 자료입니다.

속성

string | null
필수
첨부 파일 ID입니다. 업로드된 파일이 아닌 Whop 호스팅 정책은 null입니다.
string | null
필수
업로드된 파일의 MIME 유형입니다.
string | null
필수
업로드된 파일의 이름입니다.
boolean
필수
판매자가 정책을 업로드하지 않아 대신 사용되는 Whop 자체 호스팅 정책인지 여부입니다. PATCH 요청으로 다시 보내도 아무것도 변경되지 않습니다.
string | null
필수
첨부 파일을 다운로드할 수 있는 URL입니다.
string | null
필수
증빙 자료 제출 기한으로, ISO 8601 타임스탬프입니다. 네트워크가 증빙 자료 단계 없이 이미 분쟁을 자동 해결한 경우(Visa RDR) 또는 처리업체가 이 분쟁의 기한을 보고하지 않은 경우 null입니다.
boolean
필수
evidence를 아직 변경하고 제출할 수 있는지 여부입니다.
string | null
필수
증빙 자료를 더 이상 편집할 수 없는 이유입니다. evidence_editable이 true인 동안에는 null입니다.사용 가능한 옵션: submitted, response_window_closed, not_contestable
string | null
필수
증빙 자료가 처리업체에 제출된 시점으로, ISO 8601 타임스탬프입니다.
object | null
필수
계정에 청구된 분쟁 수수료로, 징수된 통화 기준입니다. fee_charged가 false이면 null입니다.

속성

string
필수
주요 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동소수점으로 반올림되지 않도록 문자열로 제공됩니다.
string
필수
세 글자 ISO 4217 통화 코드로, 소문자입니다.
integer
필수
금액의 소수점 자릿수입니다. 청구 자체가 처리되는 정밀도입니다.
integer
필수
표시할 소수점 자릿수입니다. 일반적으로 decimals와 같지만 항상 같은 것은 아닙니다. 예를 들어 COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자신의 로캘에 맞게 숫자를 포맷하세요.
boolean
필수
Whop이 이 분쟁에 대해 계정에 분쟁 수수료를 청구했는지 여부입니다. 분쟁이 시작되기 전에 결제가 전액 환불된 경우, Visa RDR 해결의 경우, 문의의 경우 false입니다.
boolean
필수
정식 차지백이 아닌 분쟁 전 문의인지 여부입니다. 문의는 동일한 수명 주기를 따르지만 격상되지 않는 한 자금이 이동하지 않습니다.
object[]
필수
카드 발급사가 분쟁을 접수할 때 남긴 내용입니다. 발급사가 제공한 경우에만 채워지며, 받은 순서대로 나열됩니다.

속성

string | null
필수
코멘트를 받은 시점으로, ISO 8601 타임스탬프입니다.
string
필수
발급사가 작성한 내용으로, 받은 그대로입니다.
object[]
필수
분쟁 대상 결제로 청구된 모든 항목으로, 구매 순서대로 나열됩니다. product_id와 variant_id는 이 중 첫 번째 항목을 가리키며, 장바구니의 이후 항목은 여기에만 나타납니다. 항목이 기록되기 전에 이루어진 결제는 변형이 나타내는 단일 항목을 나열합니다. 결제가 변형에 연결되지 않은 경우 비어 있습니다.

속성

string | null
필수
라인 항목 ID이며, 접두사는 li_입니다. 결제가 항목 스냅샷 도입 이전의 것이어서 항목을 결제의 변형에서 읽는 경우 null입니다.
string | null
필수
체크아웃에 표시된 항목 이름입니다(상품 제목, 없으면 변형 제목).
string | null
필수
변형이 속한 상품으로, 접두사는 prod_입니다. 항목 스냅샷 도입 이전의 결제에서는 변형의 상품으로 대체되므로, 상위 객체의 product_id가 null인 경우에도 설정될 수 있습니다. 상품이 없는 변형은 null입니다.
string | null
필수
상품의 현재 제목이며, 항목에 상품이 없으면 null입니다.
number
필수
구매한 수량입니다.
string | null
필수
판매자가 설정한 자유 텍스트인 변형의 재고 관리 단위(SKU)입니다(예: TSHIRT-LARGE-BLUE). 청구 사유 SKU 접미사가 활성화된 계정은 청구 사유가 표시된 값을 받습니다. 첫 구독 청구는 -S, 갱신은 -R, 일회성 구매는 -C, 결제 자체 메타데이터에 upsell: true가 있으면 -U, 청구된 금액이 없으면 -F입니다. 다른 청구 사유는 접미사 없는 SKU를 사용합니다. 변형에 SKU가 없거나 삭제된 경우 null입니다.
object | null
필수
할인, 세금, 수수료 적용 전 이 항목의 전체 수량에 대해 기록된 금액으로, 구매 통화 기준입니다. 기록된 항목 금액이 없으면 null을 반환합니다.

속성

string
필수
주요 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중에 부동소수점으로 반올림되지 않도록 문자열로 제공됩니다.
string
필수
세 글자 ISO 4217 통화 코드로, 소문자입니다.
integer
필수
금액의 소수점 자릿수입니다. 청구 자체가 처리되는 정밀도입니다.
integer
필수
표시할 소수점 자릿수입니다. 일반적으로 decimals와 같지만 항상 같은 것은 아닙니다. 예를 들어 COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자신의 로캘에 맞게 숫자를 포맷하세요.
string | null
필수
구매한 변형으로, 접두사는 plan_입니다. 이후 변형이 삭제된 경우 null입니다.
string | null
필수
변형의 현재 제목이며, 변형이 삭제되었거나 제목이 없으면 null입니다.
object
필수
분쟁 대상 결제입니다.

속성

string
필수
결제 ID이며, 접두사는 pay_입니다.
number | null
필수
고객에게 청구된 금액으로, 결제 통화의 정수 단위입니다.
string | null
필수
고객이 카드로 결제한 경우의 카드 브랜드입니다.
string | null
필수
고객이 카드로 결제한 경우 카드의 마지막 네 자리입니다.
string
필수
결제가 이루어진 시점으로, ISO 8601 타임스탬프입니다.
string | null
필수
결제의 세 글자 ISO 통화 코드입니다. 처리업체가 다른 통화로 정산하는 경우 분쟁 통화와 다를 수 있습니다.
object | null
필수
이 결제에 사용된 결제 수단으로, 표시용 형태입니다. 결제 수단 유형, 구매자에게 표시되는 이름, 표준 아이콘 세트, 그리고 카드인 경우 계정이 해당 카드에 사용하는 네트워크 거래 ID를 포함한 카드 정보가 포함됩니다. 결제에 결제 수단이 지정되지 않은 경우 null입니다.

속성

object | null
필수
카드, Apple Pay, Google Pay 결제에만 해당합니다. 카드의 네트워크, 마지막 네 자리, 발급사 식별 번호, 만료일, 네트워크 거래 ID입니다.

속성

string | null
필수
네트워크 식별자(visa, amex, …)로, card.networks 항목 및 저장된 카드 결제 수단과 일치합니다. 저장소에 네트워크가 기록되지 않은 경우 null입니다.
number | null
필수
카드 만료 월(1~12)입니다. 저장소에 기록되지 않은 경우 null입니다.
number | null
필수
카드의 네 자리 만료 연도입니다. 저장소에 기록되지 않은 경우 null입니다.
string | null
필수
BIN이라고도 하는 발급사 식별 번호로, 발급 은행을 식별하는 카드의 앞 6자리 또는 8자리입니다. 처리업체가 보고하지 않은 경우 null입니다.
string | null
필수
수집된 경우 카드의 마지막 네 자리입니다.
string | null
필수
이 계정이 해당 카드에 사용하는 네트워크 거래 ID입니다. Whop에 해당 값이 있는 경우, 해당 카드에 대한 첫 번째 고객 참여 청구 또는 인증에서 얻은 이 계정 자체의 ID입니다. 그렇지 않으면 이 카드의 이전 네트워크 거래 ID로, 다른 계정의 거래에서 온 것이거나 카드와 함께 가져온 것일 수 있습니다. 이 계정에서 이 카드로 이후 가맹점 주도 청구를 할 때 이전 거래로 인용하세요. 값이 생길 때까지 null입니다. 결제가 처음 기록될 때 전송된 웹훅에는 null이 포함될 수 있으므로, 값을 확인하려면 결제를 조회하세요.
string
필수
구매자에게 표시되는 결제 수단 이름으로, 카드가 표시되는 경우 “Visa •••• 4242”, 그렇지 않으면 결제 수단 자체의 이름(“Klarna”)입니다.
object
필수
표준 아이콘 세트로, 정사각형과 카드 모양이 각각 라이트 및 다크 색상으로 제공됩니다.

속성

object
필수
신용카드 비율의 타일(48x30)입니다.

속성

object
필수
어두운 배경용 색상입니다.

속성

string
필수
모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
string
필수
2배 밀도의 래스터 대체 이미지입니다.
string
필수
4배 밀도의 래스터 대체 이미지입니다.
string
필수
벡터 파일입니다. SVG를 렌더링할 수 있는 모든 곳에서 이 파일을 우선 사용하세요.
object
필수
밝은 배경용 색상입니다.

속성

string
필수
모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
string
필수
2배 밀도의 래스터 대체 이미지입니다.
string
필수
4배 밀도의 래스터 대체 이미지입니다.
string
필수
벡터 파일입니다. SVG를 렌더링할 수 있는 모든 곳에서 이 파일을 우선 사용하세요.
object
필수
정사각형 타일(32x32)입니다.

속성

object
필수
어두운 배경용 색상입니다.

속성

string
필수
모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
string
필수
2배 밀도의 래스터 대체 이미지입니다.
string
필수
4배 밀도의 래스터 대체 이미지입니다.
string
필수
벡터 파일입니다. SVG를 렌더링할 수 있는 모든 곳에서 이 파일을 우선 사용하세요.
object
필수
밝은 배경용 색상입니다.

속성

string
필수
모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
string
필수
2배 밀도의 래스터 대체 이미지입니다.
string
필수
4배 밀도의 래스터 대체 이미지입니다.
string
필수
벡터 파일입니다. SVG를 렌더링할 수 있는 모든 곳에서 이 파일을 우선 사용하세요.
number | null
필수
할부 결제 수단에만 해당합니다. 청구가 나뉘는 결제 횟수입니다. 문구가 아닌 데이터이므로 레이블은 클라이언트 측에서 구성하고 번역하세요.
string
필수
결제 수단 유형 식별자입니다(예: card, klarna, apple_pay).
string | null
필수
고객의 결제 방식입니다(예: card 또는 paypal).
string | null
필수
지원 중단됨: 더 이상 채워지지 않습니다. 항상 null입니다. 지원 중단됨: 더 이상 채워지지 않습니다. 항상 null입니다.
string | null
필수
분쟁 대상 결제의 상품으로, 접두사는 prod_입니다.
string
필수
고객이 주장하는 분쟁 사유로, 처리업체와 카드 네트워크 전반에 걸쳐 정규화됩니다. other는 Whop이 아직 분류하지 않은 처리업체 사유를 포함합니다.사용 가능한 옵션: fraudulent, unrecognized, declined_authorization, product_not_received, product_unacceptable, subscription_canceled, credit_not_processed, duplicate, processing_error, documentation_request, bank_cannot_process, other
string | null
필수
카드 네트워크 또는 처리업체의 원래 사유 코드입니다(예: 10.4). 참고용이며, reason은 이 값에서 파생되지 않습니다.
string
필수
needs_response는 증빙 자료를 기다리는 상태입니다(처리업체가 제출을 거부한 경우 submission_failure_reason에 사유가 표시됩니다). generating_response는 증빙 자료가 처리업체에 있지만 아직 수락되지 않은 상태입니다. under_review는 처리업체가 검토 중인 상태입니다. won/lost는 판정 결과입니다. prevented는 lost처럼 정산됩니다. warning_ 상태는 문의 단계입니다. evidence_due_at이 지난 진행 중인 분쟁은 under_review로 보고됩니다.사용 가능한 옵션: needs_response, warning_needs_response, under_review, warning_under_review, generating_response, won, lost, prevented, warning_closed
string | null
필수
분쟁이 needs_response로 돌아간 동안, 결제 처리업체가 마지막 제출을 거부한 이유를 쉬운 영어로 설명합니다. 지적된 사항을 수정하고 다시 제출하세요. 조회 시에만 제공됩니다. dispute.updated가 needs_response로의 복귀를 알리면, 여기에서 이 값을 확인하세요.
string
필수
분쟁이 마지막으로 변경된 시점으로, ISO 8601 타임스탬프입니다.
string | null
필수
분쟁 대상 결제가 이루어진 변형으로, 접두사는 plan_입니다.
Dispute