Sign in
PaymentAdminAPI

관리자 수동 환불 반영

스토어 콘솔에서 이미 환불 처리된 결제를 백엔드 DB에 수동 반영하고 광고 제거 권한을 회수합니다.

  • 관리자 인증 필요 (Bearer JWT, ADMIN 계정)
  • Google/Apple 스토어에 환불을 요청하는 API가 아니라 내부 fallback 처리 API
  • paymentId 기준으로 결제 상태를 REFUNDED로 변경
  • 해당 결제가 부여한 REMOVE_ADS 권한을 비활성화
  • 이미 환불 처리된 결제는 alreadyProcessed=true로 멱등 응답
post/api/v1/admin/payments/{paymentId}/refund

Request

  • Base URL: https://lightsail.melissahttps.cloud
  • URL: https://lightsail.melissahttps.cloud/api/v1/admin/payments/{paymentId}/refund
  • Auth: HTTP bearer

Path parameters

paymentIdinteger required

Request body

reasonstring required

수동 환불 반영 사유

refundedAtstring date-time nullable

스토어 환불 처리 시각. 생략하면 서버 처리 시각 사용

Example request

{
  "reason": "Google Play Console 환불 처리 확인"
}

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.