---
url: https://developers.webzenk.kr/guide/refunds.md
---
# 환불 처리

환불은 각 스토어에서 처리되고, 서버가 자동으로 결제 상태를 `refunded`로 바꿔요.

| 스토어 | 반영 |
|---|---|
| App Store | App Store 서버 알림 V2로 즉시 |
| Google Play | 실시간 개발자 알림(RTDN)으로 즉시, 놓쳐도 1시간마다 환불 목록을 조회해 반영 |

## 지급한 재화 회수

이미 지급한 재화를 회수하는 건 **개발사 서버**가 해요.

1. [개발사 서버 API](/api/server)의 `GET /v1/server/purchases?status=refunded`를 처음에는 `since` 없이 호출하고, 응답의 `next_since`를 저장해요.
2. 이후 주기적으로(예: 1시간) `since=next_since`로 호출해요. 경계에 있는 건이 다시 올 수 있으니 `purchase_id`로 중복을 걸러요.
3. 환불된 결제의 `player_id`·`product_id`로 재화를 회수하거나, 반복 환불 유저를 제재해요(`/v1/server/players/{id}/ban`).

::: tip 이미 써 버린 재화
회수할 재화가 부족하면 마이너스 잔액·이용 제한 등 게임 정책을 미리 정해 두세요.
:::
