엔드포인트
속성
POST /disputes/\{id} /accept로 분쟁을 고객에게 양보할 수 있는지 여부입니다. 아직 응답을 기다리는 차지백이고, evidence_due_at 이전이며, 결제 처리업체가 분쟁 수락을 지원하는 경우에만 true입니다. 문의는 수락할 수 없습니다.분쟁에 이의를 제기하기 위해 처리업체에 보내는 증빙 자료 패킷입니다.
속성
속성
취소 정책 문서입니다. 기본값은 계정의 취소 정책이며, 없으면 서비스 약관, 그다음 반품 정책, 그다음 Whop의 플랫폼 정책 순으로 사용됩니다.
네 개의 고정 슬롯 외의 추가 증빙 문서로,
PATCH /disputes/\{id}에서 evidence.documents로 설정합니다. 각 문서는 document_type에 따라 제출된 패킷에 포함됩니다.속성
속성
업로드된 파일의 MIME 유형입니다. 업로드는 처리업체가 허용하는 유형으로 제한되며, 유형이 없으면 거부되므로 절대 null이 아닙니다.사용 가능한 옵션:
application/pdf, application/json, image/jpeg, image/png, image/webp이 문서가 증명하는 내용입니다.
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모더레이션으로 파일이 제거되었는지 여부입니다.
true이면 url은 대체 이미지를 제공합니다. filename, size, content_type은 여전히 원본 파일을 설명합니다.파일을 다운로드할 수 있는 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명 URL을 받습니다. 업로드가 완료될 때까지
null입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.public 파일은 서명되지 않은 CDN URL에서 제공됩니다. private 파일은 만료되는 서명 URL에서 제공됩니다.사용 가능한 옵션: public, private환불 정책 문서입니다. 기본값은 계정의 반품 정책이며, 없으면 서비스 약관, 그다음 Whop의 플랫폼 정책 순으로 사용됩니다.
증빙 자료 제출 기한으로, ISO 8601 타임스탬프입니다. 네트워크가 증빙 자료 단계 없이 이미 분쟁을 자동 해결한 경우(Visa RDR) 또는 처리업체가 이 분쟁의 기한을 보고하지 않은 경우
null입니다.증빙 자료를 더 이상 편집할 수 없는 이유입니다.
evidence_editable이 true인 동안에는 null입니다.사용 가능한 옵션: submitted, response_window_closed, not_contestable계정에 청구된 분쟁 수수료로, 징수된 통화 기준입니다.
fee_charged가 false이면 null입니다.속성
속성
Whop이 이 분쟁에 대해 계정에 분쟁 수수료를 청구했는지 여부입니다. 분쟁이 시작되기 전에 결제가 전액 환불된 경우, Visa RDR 해결의 경우, 문의의 경우
false입니다.분쟁 대상 결제로 청구된 모든 항목으로, 구매 순서대로 나열됩니다.
product_id와 variant_id는 이 중 첫 번째 항목을 가리키며, 장바구니의 이후 항목은 여기에만 나타납니다. 항목이 기록되기 전에 이루어진 결제는 변형이 나타내는 단일 항목을 나열합니다. 결제가 변형에 연결되지 않은 경우 비어 있습니다.속성
속성
변형이 속한 상품으로, 접두사는
prod_입니다. 항목 스냅샷 도입 이전의 결제에서는 변형의 상품으로 대체되므로, 상위 객체의 product_id가 null인 경우에도 설정될 수 있습니다. 상품이 없는 변형은 null입니다.판매자가 설정한 자유 텍스트인 변형의 재고 관리 단위(SKU)입니다(예:
TSHIRT-LARGE-BLUE). 청구 사유 SKU 접미사가 활성화된 계정은 청구 사유가 표시된 값을 받습니다. 첫 구독 청구는 -S, 갱신은 -R, 일회성 구매는 -C, 결제 자체 메타데이터에 upsell: true가 있으면 -U, 청구된 금액이 없으면 -F입니다. 다른 청구 사유는 접미사 없는 SKU를 사용합니다. 변형에 SKU가 없거나 삭제된 경우 null입니다.할인, 세금, 수수료 적용 전 이 항목의 전체 수량에 대해 기록된 금액으로, 구매 통화 기준입니다. 기록된 항목 금액이 없으면
null을 반환합니다.속성
속성
분쟁 대상 결제입니다.
속성
속성
이 결제에 사용된 결제 수단으로, 표시용 형태입니다. 결제 수단 유형, 구매자에게 표시되는 이름, 표준 아이콘 세트, 그리고 카드인 경우 계정이 해당 카드에 사용하는 네트워크 거래 ID를 포함한 카드 정보가 포함됩니다. 결제에 결제 수단이 지정되지 않은 경우 null입니다.
속성
속성
카드, Apple Pay, Google Pay 결제에만 해당합니다. 카드의 네트워크, 마지막 네 자리, 발급사 식별 번호, 만료일, 네트워크 거래 ID입니다.
속성
속성
네트워크 식별자(
visa, amex, …)로, card.networks 항목 및 저장된 카드 결제 수단과 일치합니다. 저장소에 네트워크가 기록되지 않은 경우 null입니다.이 계정이 해당 카드에 사용하는 네트워크 거래 ID입니다. Whop에 해당 값이 있는 경우, 해당 카드에 대한 첫 번째 고객 참여 청구 또는 인증에서 얻은 이 계정 자체의 ID입니다. 그렇지 않으면 이 카드의 이전 네트워크 거래 ID로, 다른 계정의 거래에서 온 것이거나 카드와 함께 가져온 것일 수 있습니다. 이 계정에서 이 카드로 이후 가맹점 주도 청구를 할 때 이전 거래로 인용하세요. 값이 생길 때까지 null입니다. 결제가 처음 기록될 때 전송된 웹훅에는
null이 포함될 수 있으므로, 값을 확인하려면 결제를 조회하세요.표준 아이콘 세트로, 정사각형과 카드 모양이 각각 라이트 및 다크 색상으로 제공됩니다.
속성
속성
신용카드 비율의 타일(48x30)입니다.
속성
속성
정사각형 타일(32x32)입니다.
속성
속성
고객이 주장하는 분쟁 사유로, 처리업체와 카드 네트워크 전반에 걸쳐 정규화됩니다.
other는 Whop이 아직 분류하지 않은 처리업체 사유를 포함합니다.사용 가능한 옵션: fraudulent, unrecognized, declined_authorization, product_not_received, product_unacceptable, subscription_canceled, credit_not_processed, duplicate, processing_error, documentation_request, bank_cannot_process, otherneeds_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분쟁이
needs_response로 돌아간 동안, 결제 처리업체가 마지막 제출을 거부한 이유를 쉬운 영어로 설명합니다. 지적된 사항을 수정하고 다시 제출하세요. 조회 시에만 제공됩니다. dispute.updated가 needs_response로의 복귀를 알리면, 여기에서 이 값을 확인하세요.Dispute

