Skip to content
Sanmopia Modernization

Grant reservation-scoped payment authority to a family payer

Switch to Zen Mode
POST
/family-payment-delegations
curl --request POST \
  --url https://example.com/family-payment-delegations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "familyAccountId": "example", "payerMemberId": "example", "motherMemberId": "example", "reservationBookingId": "example", "scopes": [ "reservation_deposit" ], "maximumAuthorizedAmountKrw": 1, "expiresAt": "2026-04-15T12:00:00Z" }'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
Idempotency-Key
required
string
>= 1 characters

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
GrantReservationPaymentDelegationRequest
object
familyAccountId
required
string
>= 1 characters
payerMemberId
required
string
>= 1 characters
motherMemberId
required
string
>= 1 characters
reservationBookingId
required
string
>= 1 characters
scopes
required
Array<string>
>= 1 items unique items
Allowed values: reservation_deposit reservation_balance reservation_change_fee full_reservation_payment
maximumAuthorizedAmountKrw
required
integer
>= 1
expiresAt
required
string format: date-time
key
additional properties

Responses

Section titled “Responses”

201

Section titled “201”

Reservation payment delegation granted and queued for authorization sync

Media typeapplication/json
PaymentDelegationResponse
object
paymentDelegationId
required
string
>= 1 characters
payerMemberId
required
string
>= 1 characters
motherMemberId
required
string
>= 1 characters
scopes
required
Array<string>
>= 1 items
Allowed values: reservation_deposit reservation_balance reservation_change_fee full_reservation_payment
grantedByMemberId
required
string
>= 1 characters
grantedAt
required
string format: date-time
expiresAt
required
string format: date-time
maximumAuthorizedAmountKrw
required
integer
>= 1
reservationBookingId
required
string | null
>= 1 characters
revokedAt
required
string | null format: date-time
delegationRevision
required
integer
>= 1
authorityEvidence
required
Array<string>
>= 1 items unique items
revokedByMemberId
required
string | null
>= 1 characters
revocationReasonCode
required
string | null
>= 1 characters
key
additional properties

401

Section titled “401”

Supabase bearer token is required

403

Section titled “403”

Only mother can grant reservation payment authority

404

Section titled “404”

Family account was not found

409

Section titled “409”

Delegation scope, overlap, or idempotency conflict

503

Section titled “503”

Payment delegation command store is unavailable