환불 시작
Payment Details Page에서 두 가지 유형의 환불을 시작할 수 있습니다:- 전액 환불: 고객에게 전체 결제 금액을 환불합니다.
- 부분 환불: 결제 금액의 일부를 환불합니다. 각 항목에 대해 환불할 금액을 설정합니다.

payment_id를 사용하세요. 부분 환불의 경우 items를 전달하고, 각 항목에 item_id(상품 ID 또는 추가 기능 ID)와 가장 작은 통화 단위로 환불할 금액을 나타내는 amount를 지정하세요.
환불에 필요한 세부정보
- 환불 금액: 환불할 금액입니다. 부분 환불의 경우 고객에게 반환할 각 항목의 금액을 입력하세요. 대시보드에는 각 항목의 환불 가능 금액이 표시되며, 원래 결제 금액보다 많은 금액을 환불하지 못하도록 제한합니다.
- 환불 사유: 환불 사유이며 환불 기록에 저장됩니다. 대시보드에서는 최소 5자를 입력해야 하며, API에서는 최대 3,000자까지 허용됩니다.
환불 규칙
- 결제가 성공적으로 완료되어야 합니다.
- 전액 또는 부분 환불은 환불 기간 내에 시작해야 하며, 기본 환불 기간은 결제일로부터 30일입니다. 기간이 종료되면 환불할 수 없습니다.
- 해당 결제에 대해 이전에 처리된 환불이 있는 경우, 현재 환불 금액과 이전 환불 금액의 합계가 결제 금액을 초과할 수 없습니다.
- 결제당 하나의 환불만 진행 중일 수 있습니다. 상태가
pending또는review인 환불이 완료된 후에만 다른 환불을 시작할 수 있습니다. - 잔액이 환불 금액을 충당할 수 있어야 합니다.
- live mode에서는 비즈니스에 대해 live payments가 활성화되어 있어야 합니다.
- 환불은 고객이 사용한 원래 결제 수단으로 처리됩니다.
환불 상태
다음 상태를 통해 환불 진행 상황을 추적할 수 있습니다:
Dodo Payments는 환불이 최종 상태에 도달하면
refund.succeeded 또는 refund.failed webhook을 전송합니다. Refund Webhooks를 참조하세요.
환불 페이지
Transactions 페이지의 Refunds 탭에는 모든 환불 내역과 함께 금액, 상태, 환불 ID, 연결된 결제, 환불 유형, 날짜 및 사유가 표시됩니다:- 환불과 연결된 결제의 Payment Details Page를 열려면 Associated Payment 열에서 해당 ID를 클릭하세요.
- 환불은 Settings → Reports에서 내보낼 수 있습니다. Adjustments Report는 환불과 분쟁을 함께 CSV 또는 XLSX 형식으로 제공합니다.

환불 영수증
환불이 성공하면 Dodo Payments가 고객에게 이메일을 보냅니다. 이메일에는 환불 금액, 상태, Refund ID, 원래 결제 금액 및 환불 날짜가 표시되며, Refund Receipt로 연결되는 링크가 포함됩니다. Refund Successful 이메일은 기본적으로 활성화되어 있으며, Customer Emails에서 비활성화할 수 있습니다. 백엔드에서 영수증을 가져오려면 Get Refund Receipt를 사용하세요. 환불 영수증 템플릿:
- Refund ID: 환불된 결제의 ID와 함께 표시되는 환불의 고유 식별자입니다.
- Refund type: 전액 환불인지 부분 환불인지 나타냅니다.
- Refund amount: 고객에게 환불된 금액과 해당 과세 금액 및 세액입니다.
- Refund date: 환불이 처리된 날짜입니다.
- Refund method: 환불 금액이 전송된 결제 수단입니다.
- Refund reason: 환불 사유입니다.