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

payment_id를 사용하세요. 부분 환불의 경우 items를 전달하고, 각 항목에 item_id(상품 ID 또는 추가 기능 ID)와 가장 작은 통화 단위로 환불할 금액을 나타내는 amount를 지정하세요.
환불에 필요한 세부정보
- 환불 금액: 환불할 금액입니다. 부분 환불의 경우 고객에게 반환할 각 항목의 금액을 입력하세요. 대시보드에는 각 항목의 환불 가능 금액이 표시되며, 원래 결제 금액보다 많은 금액을 환불하지 못하도록 제한합니다.
- 환불 사유: 환불 사유이며 환불 기록에 저장됩니다. 대시보드에서는 최소 5자를 입력해야 하며, API에서는 최대 3,000자까지 허용됩니다.
환불 규칙
- 결제가 성공적으로 완료되어야 합니다.
- 전액 또는 부분 환불은 환불 기간 내에 시작해야 하며, 기본 환불 기간은 결제일로부터 30일입니다. 기간이 종료되면 환불할 수 없습니다.
- 해당 결제에 대해 이전에 처리된 환불이 있는 경우, 현재 환불 금액과 이전 환불 금액의 합계가 결제 금액을 초과할 수 없습니다.
- 결제당 하나의 환불만 진행 중일 수 있습니다. 상태가
pending또는review인 환불이 완료된 후에만 다른 환불을 시작할 수 있습니다. - 잔액이 환불 금액을 충당할 수 있어야 합니다.
- live mode에서는 비즈니스에 대해 live payments가 활성화되어 있어야 합니다.
- 환불은 고객이 사용한 원래 결제 수단으로 처리됩니다.
잔액으로 환불 금액을 충당할 수 없는 경우
Dodo Payments는 원래 결제 금액이 아니라 지갑 잔액에서 환불 금액을 지급합니다. 잔액이 환불 금액보다 적으면 결제가 성공했더라도 환불이 거부됩니다. 다음 세 가지 이유로 잔액이 결제 금액 전체보다 적을 수 있습니다:- 결제 금액 중 일부만 잔액에 추가됩니다. 결제가 완료되면 해당 결제 금액이 지갑에 적립된 후, 결제에 부과된 세금과 Dodo Payments transaction fees가 차감됩니다. 따라서 전액 환불을 처리하려면 잔액에 추가된 금액보다 더 많은 금액이 필요합니다.
- 지급으로 잔액이 은행 계좌로 이동합니다. 각 지급일에 지급 가능한 잔액이 은행 계좌로 이체됩니다. 지급 직후에는 해당 지급 전에 이루어진 결제의 환불을 처리할 만큼 잔액이 충분하지 않을 수 있습니다.
- 다른 항목에서도 동일한 잔액을 사용합니다. 이전 환불, 분쟁 및 관련 수수료는 발생 시 잔액에서 차감됩니다.
Payment Fees 항목에는 환입이 없으므로, Dodo Payments는 환불 시 원래 결제에 부과된 transaction fees를 반환하지 않습니다.
잔액으로 충당할 수 없는 환불을 처리하려면 다음 단계를 따르세요:
- Payouts → Balances에서 잔액을 확인합니다.
- 새 결제로 잔액이 늘어날 때까지 기다린 다음 환불을 시작합니다. 환불은 환불 가능 기간 내에 시작해야 하므로 기간이 지나도록 기다리지 마세요.
- 환불을 기다릴 수 없다면 등록된 이메일 주소에서 support@dodopayments.com으로 결제 ID를 포함해 이메일을 보내세요.
환불 상태
다음 상태를 통해 환불 진행 상황을 추적할 수 있습니다:
환불이 최종 상태에 도달하면 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에서 비활성화할 수 있습니다. backend에서 영수증을 가져오려면 Get Refund Receipt를 사용하세요. Refund Receipt Template:
- Refund ID: 환불을 식별하는 고유 식별자이며, 환불된 결제의 ID가 함께 표시됩니다.
- Refund type: 환불이 전액 환불인지 부분 환불인지 나타냅니다.
- Refund amount: 고객에게 환불된 금액과 과세 대상 금액 및 세금 금액을 나타냅니다.
- Refund date: 환불이 처리된 날짜입니다.
- Refund method: 환불 금액이 전송된 payment method입니다.
- Refund reason: 환불 사유입니다.