Skip to main content
결제가 완료된 후에는 두 가지 일이 발생할 수 있습니다. 환불은 여러분(또는 지원팀)이 의도적으로 발행하는 취소입니다. 분쟁은 구매자가 은행에 제기하는 차지백입니다. 분쟁의 결과를 항상 통제할 수는 없지만, 증거를 제출하여 대응할 수 있습니다.
refund.created, refund.updated, dispute.created, dispute.updated, dispute_alert.created에 대한 웹훅을 구독하면 폴링 없이 상태 변경을 조정할 수 있습니다.

환불

환불은 성공한 결제를 되돌립니다. Whop은 원래의 결제 프로세서를 통해 환불을 처리합니다. 해당 멤버십 상태는 자동으로 업데이트됩니다.

환불 발행

환불은 refunds 리소스에서 직접 생성하는 것이 아니라 결제에 대해 생성합니다. payments.refund({ id })를 호출하세요. 전액 환불이면 partial_amount를 생략하고, 부분 환불이면 이 값을 전달하세요.
응답은 업데이트된 Payment 객체입니다. refunded_amount 필드는 누적 환불 총액을 반영합니다. 하나의 결제에 대해 전체 금액까지 refund를 여러 번 호출할 수 있습니다.
필요한 권한: payment:manage. 앱을 게시하기 전에 권한 가이드에서 추가하세요.

환불 조회

나중에 환불을 조회해야 하는 경우를 위해 환불에는 별도의 리소스가 있습니다.

분쟁

분쟁(차지백)은 구매자의 은행이 결제에 이의를 제기할 때 시작됩니다. 은행이 결정을 내리기 전에 증거로 대응할 수 있는 기간이 주어집니다. Whop이 분쟁을 여러분에게 전달하면, 여러분이 증거를 제출하고, 은행이 판정을 내린 뒤 분쟁이 종료됩니다.

수신되는 분쟁 확인

구독해야 할 세 가지 이벤트:

목록 조회 및 단건 조회

증거로 대응

분쟁 대응은 두 단계로 이루어집니다. disputes.update로 증거를 준비한 다음 disputes.submit으로 제출합니다. update는 멱등적입니다. 제출하기 전까지 필드를 수정할 수 있습니다.

증거 필드

모든 필드는 선택 사항이지만, 더 많이 제공할수록 대응이 강력해집니다. 자주 사용하는 필드: 첨부 파일 필드는 업로드된 파일을 { id: file.id } 형식으로 받습니다. 먼저 Files API를 통해 업로드하세요.

분쟁 상태

분쟁은 상태 머신을 따라 진행됩니다. 두 단계가 있습니다: 조기 경고 단계(warning_ 접두사가 붙은 상태로, dispute_alert.created를 통해 표시됨)와 정식 분쟁 단계입니다. SDK가 반환할 수 있는 모든 상태:
분쟁에서 패소하면 Whop은 Refund 레코드를 자동으로 생성하지 않으며, 직접 생성할 수도 없습니다. payments.refund는 분쟁 중인 결제에 대한 호출을 This payment has been disputed. Therefore, it cannot be refunded. 메시지와 함께 거부합니다. 패소한 분쟁을 기준 정보로 추적하고, refund.created 이벤트를 기대하지 마세요.

권한

권한 가이드에서 이 권한들을 추가하세요.

다음 단계

결제 받기

나중에 환불하거나 방어하게 될 결제를 생성하는 흐름입니다.

웹훅 수신

서버 측에서 환불 및 분쟁 이벤트에 대응하세요.

파일 업로드

분쟁 대응을 위한 증거 첨부 파일을 업로드하세요.

Disputes API 레퍼런스

전체 리소스: 필드, 상태 및 모든 엔드포인트.