Skip to content
Sanmopia Modernization

Request backend-owned reservation cancellation refund

Switch to Zen Mode
POST
/reservation-cancellation-refunds
curl --request POST \
  --url https://example.com/reservation-cancellation-refunds \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "reservationBookingId": "example", "paymentId": "example", "paymentRefundIntentId": "example", "idempotencyKey": "example", "expectedRevision": 1, "totalServiceFeeKrw": 1, "contractConfirmedAt": "2026-04-15T12:00:00Z", "cancellationRequestedAt": "2026-04-15T12:00:00Z", "expectedBirthOn": "2026-04-15", "serviceStartedOn": "2026-04-15", "providedServiceChargeKrw": 1, "giftBenefitDeductionKrw": 1, "deliveryFeeDeductionKrw": 1, "penaltyWaivedByCustomerProtection": true, "taxFreeAmountKrw": 1, "serviceCalendarImpactPlanId": "example", "serviceCalendarImpactPolicyFingerprint": "example", "serviceCalendarImpactFactIds": [ "example" ], "regionalBenefitFinalizedChargeSnapshotId": "example", "regionalBenefitChargeImpactEventIds": [ "example" ], "paymentChangeAdjustmentId": "example" }'

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
ReservationCancellationRefundRequest
object
reservationBookingId
required
string
>= 1 characters
paymentId
required
string
>= 1 characters
paymentRefundIntentId
required
string
>= 1 characters
idempotencyKey
required
string
>= 1 characters
expectedRevision
required
integer
totalServiceFeeKrw
required
integer
>= 1
contractConfirmedAt
required
string format: date-time
cancellationRequestedAt
required
string format: date-time
expectedBirthOn
required
string format: date
serviceStartedOn
string | null format: date
providedServiceChargeKrw
integer
giftBenefitDeductionKrw
integer
deliveryFeeDeductionKrw
integer
penaltyWaivedByCustomerProtection
boolean
taxFreeAmountKrw
integer | null
serviceCalendarImpactPlanId
string | null
>= 1 characters
serviceCalendarImpactPolicyFingerprint
string | null
>= 1 characters
serviceCalendarImpactFactIds
Array<string>
regionalBenefitFinalizedChargeSnapshotId
string | null
>= 1 characters
regionalBenefitChargeImpactEventIds
Array<string>
paymentChangeAdjustmentId
string | null
>= 1 characters
key
additional properties

Responses

Section titled “Responses”

201

Section titled “201”

Reservation cancellation refund quoted and recorded

Media typeapplication/json
ReservationCancellationRefundResponse
object
reservationBookingId
required
string
>= 1 characters
paymentId
required
string
>= 1 characters
paymentRefundIntentId
required
string
>= 1 characters
idempotencyKey
required
string
>= 1 characters
refundReason
required
string
>= 1 characters
baseRefundAmountKrw
required
integer
refundAmountKrw
required
integer
customerShortfallKrw
required
integer
requiresGatewayCancellation
required
boolean
refundLedgerRevision
required
integer
paymentChangeAdjustmentId
required
string | null
>= 1 characters
deductions
required
Array<object>
ReservationCancellationRefundDeduction
object
deductionCode
required
string
>= 1 characters
amountKrw
required
integer
displayName
required
string
>= 1 characters
adjustmentVersion
required
integer
>= 1
memo
required
string | null
key
additional properties
key
additional properties

401

Section titled “401”

Supabase bearer token is required

403

Section titled “403”

Actor cannot request reservation cancellation refund

404

Section titled “404”

Payment ledger was not found

409

Section titled “409”

Refund quote, revision, or payment-change link conflict

503

Section titled “503”

Reservation cancellation refund runtime is unavailable