Skip to main content
이는 차지백 이전 단계로, 구매자와 판매자가 직접 해결하며, 해결하지 못하면 Whop이 케이스를 결정합니다. Resolution Center Cases API는 양측 모두에서 사용할 수 있습니다. 구매자는 케이스를 열고, 답변하고, 이의를 제기하거나, 철회할 수 있으며, 판매자는 케이스를 수락(결제 환불)하거나, 거부하거나, 구매자에게 추가 정보를 요청할 수 있습니다.

엔드포인트

속성

string
필수
reso_ 접두사가 붙은 분쟁 조정 센터 케이스 ID입니다.
object | null
필수
케이스가 제기된 대상 계정입니다.

속성

string
필수
biz_ 접두사가 붙은 계정 ID입니다.
string
필수
계정 표시 이름입니다.
number
필수
문제가 된 금액으로, currency의 기본 단위입니다.
string[]
필수
현재 이 케이스에 대해 수행할 수 있는 작업으로, 해당 작업을 수행하는 엔드포인트 이름으로 표시됩니다. 호출하는 자격 증명을 기준으로 결정되므로, 같은 케이스를 조회하더라도 판매자와 고객은 각자의 옵션을 보게 됩니다.사용 가능한 옵션: accept, deny, request_info, reply, appeal, withdraw
object
필수
케이스를 연 고객입니다.

속성

string | null
필수
고객의 이메일 주소입니다. member:email:read 스코프가 필요하며, 없으면 null입니다.
string | null
필수
계정에서 고객의 회원 레코드로, mem_ 접두사가 붙습니다.
string | null
필수
고객의 표시 이름입니다.
string | null
필수
고객의 사용자 ID로, user_ 접두사가 붙습니다.
string | null
필수
고객의 Whop 사용자 이름입니다.
string
필수
케이스가 열린 시각으로, ISO 8601 타임스탬프입니다.
string | null
필수
금액의 세 글자 ISO 통화 코드입니다.
boolean
필수
고객이 이 케이스의 결정에 이의를 제기했는지 여부입니다.
boolean
필수
Whop이 관여하고 있는지 여부입니다. 즉 Whop이 케이스를 검토 중이거나, 검토 중에 요청한 사항에 대해 status가 지정한 측의 응답을 기다리고 있는 상태입니다.
object[]
필수
분쟁 대상 결제로 청구된 모든 항목으로, 구매 순서대로 나열됩니다. product_id와 variant_id는 이 중 첫 번째 항목을 가리키며, 장바구니의 이후 항목은 여기에만 나타납니다. 항목이 기록되기 전에 이루어진 결제는 해당 변형이 암시하는 단일 항목을 나열합니다. 결제가 변형에 연결되어 있지 않으면 비어 있습니다.

속성

string | null
필수
li_ 접두사가 붙은 항목 ID입니다. 결제가 항목 스냅샷 이전의 것이어서 항목을 결제의 변형에서 읽어 오는 경우 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입니다.
string | null
필수
클레임에서 이긴 측입니다. 케이스가 종료될 때까지 null입니다. 실제로 자금이 이동했는지는 refund를 확인하세요.사용 가능한 옵션: customer_won, merchant_won, withdrawn
object
필수
케이스가 열린 대상 결제입니다.

속성

string
필수
pay_ 접두사가 붙은 결제 ID입니다.
string | null
필수
고객이 카드로 결제한 경우의 카드 브랜드입니다.
string | null
필수
고객이 카드로 결제한 경우 카드의 마지막 네 자리입니다.
string
필수
결제가 이루어진 시각으로, ISO 8601 타임스탬프입니다.
string | null
필수
고객의 결제 방식으로, 예를 들어 card 또는 paypal입니다.
string | null
필수
결제 대상 상품으로, prod_ 접두사가 붙습니다.
string
필수
고객이 주장하는 문제입니다. /disputes와 동일한 용어를 사용하므로, 나중에 차지백으로 전환된 케이스도 같은 불만 사유를 보고합니다.사용 가능한 옵션: fraudulent, product_not_received, not_as_described, product_unacceptable, subscription_canceled
string | null
필수
자금이 이동했는지, 그리고 누구의 잔액에서 이동했는지를 나타냅니다. none, merchant, platform(Whop이 고객에게 환불하고 판매자는 자금을 유지함) 중 하나입니다. outcome과는 독립적이므로, 판매자가 이긴 케이스에도 플랫폼 환불이 있을 수 있습니다. 케이스가 열려 있는 동안과, 이 값이 기록되기 이전에 종료된 오래된 케이스에서는 null입니다.사용 가능한 옵션: none, merchant, platform
string | null
필수
다음 응답 기한으로, ISO 8601 타임스탬프입니다.
string
필수
케이스가 누구를 기다리고 있는지를 나타냅니다. awaiting_merchant와 awaiting_customer는 응답해야 하는 측을 나타내고, under_review는 Whop이 결정 중임을, closed는 해결되었음을 의미합니다. 어떻게 해결되었는지는 outcome을 확인하세요.사용 가능한 옵션: awaiting_merchant, awaiting_customer, under_review, closed
string
필수
케이스가 마지막으로 변경된 시각으로, ISO 8601 타임스탬프입니다.
string | null
필수
결제가 이루어진 변형으로, plan_ 접두사가 붙습니다.
ResolutionCenterCase