Skip to content
Sanmopia Modernization

Authorize and pre-register a backend-owned reservation payment obligation

Switch to Zen Mode
POST
/reservation-payment-pre-registrations
curl --request POST \
  --url https://example.com/reservation-payment-pre-registrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "paymentId": "example", "cashReceiptIssueRequest": "example" }'

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
PreRegisterReservationPaymentRequest
object
paymentId
required
string
>= 1 characters
cashReceiptIssueRequest
required
object
requestState
required
string
Allowed values: not_requested requested unknown
purpose
required
string
Allowed values: income_deduction business_expense_proof unknown
registrationIdentityReference
required
string | null
>= 1 characters
key
additional properties
key
additional properties

Responses

Section titled “Responses”

201

Section titled “201”

Payment obligation, actor, fee, and cash-receipt policy snapshots pre-registered

Media typeapplication/json
ReservationPaymentPreRegistrationResponse
object
reservationBookingId
required
string
>= 1 characters
paymentId
required
string
>= 1 characters
paymentMethod
required
string
Allowed values: card bank vcnt
paymentPurpose
required
string
Allowed values: customer_share_deposit customer_share_balance service_balance pre_reservation_deposit
amountKrw
required
integer
>= 1
paymentProductPlanCode
required
string
>= 1 characters
providerFeeSnapshot
required
object
providerRoutingKey
required
string
>= 1 characters
settlementParticipation
required
string
Allowed values: customer_charge service_balance pre_reservation_credit gift_coupon payment_correction not_participating
ledgerRecognitionTiming
required
string
Allowed values: immediate deferred_until_fulfillment deferred_until_service_close manual_operator_reviewed not_recognized
feeRecognitionBasis
required
string
Allowed values: gateway_gross_amount customer_share_amount coupon_purchase_amount service_balance_amount manual_adjustment_amount none
settlementLineTargets
required
Array<string>
>= 1 items
Allowed values: customer_charge service_balance gift_coupon_fee pre_reservation_credit payment_correction non_settlement
freezesCustomerVisibleAmountAfterPayment
required
boolean
laterCatalogChangesCanAlterExposedResult
required
boolean
methodFeeQuote
required
object
bucket
required
string
Allowed values: card bank_transfer virtual_account unspecified_card_default
displayMethodName
required
string
Allowed values: 카드 계좌이체 가상계좌 ""
amountKrw
required
integer
feeAmountKrw
required
integer
rateBasisPoints
required
integer
key
additional properties
key
additional properties
paymentActorSnapshot
required
object
paymentActorSnapshotId
required
string
>= 1 characters
actorUserId
required
string
>= 1 characters
actorMemberId
required
string
>= 1 characters
actorKind
required
string
Allowed values: mother delegated_family_payer branch_finance_operator headquarters_finance_operator
motherUserId
required
string
>= 1 characters
motherMemberId
required
string
>= 1 characters
branchProfileId
required
string
>= 1 characters
familyAccountId
required
string | null
>= 1 characters
paymentDelegationId
required
string | null
>= 1 characters
paymentDelegationRevision
required
integer | null
>= 1
paymentDelegationScope
required
string | null
>= 1 characters
maximumAuthorizedAmountKrw
required
integer | null
>= 1
authorityEvidence
required
Array<string>
>= 1 items unique items
idempotencyKey
required
string
>= 1 characters
authorizedAt
required
string format: date-time
key
additional properties
cashReceiptEligibilitySnapshot
required
object
cashReceiptEligibilitySnapshotId
required
string
>= 1 characters
paymentId
required
string
>= 1 characters
paymentProductPlanCode
required
string
>= 1 characters
obligationPurpose
required
string
Allowed values: customer_share_deposit customer_share_balance service_balance pre_reservation_deposit gift_coupon_purchase payment_change_correction
requestState
required
string
Allowed values: not_requested requested unknown
requestedPurpose
required
string
Allowed values: income_deduction business_expense_proof unknown
registrationIdentityReference
required
string | null
>= 1 characters
decisionState
required
string
Allowed values: not_requested accepted rejected
merchantOfRecord
required
string
Allowed values: sanmopia caregiver external_partner
collectionChannel
required
string
Allowed values: provider_collected direct_to_caregiver external_partner_collected
receiptIssuer
required
string
Allowed values: provider_on_behalf_of_sanmopia external_partner none
acceptedPurpose
required
string | null
Allowed values: income_deduction business_expense_proof
denialReasonCode
required
string | null
>= 1 characters
providerIssueAllowed
required
boolean
decidedAt
required
string format: date-time
key
additional properties
preRegistrationStatus
required
string
Allowed values: pre_registered already_pre_registered
gatewayCode
required
string | null
>= 1 characters
gatewayMessage
required
string | null
>= 1 characters
key
additional properties

401

Section titled “401”

Supabase bearer token is required

403

Section titled “403”

Actor lacks payment authority in Supabase or SpiceDB

404

Section titled “404”

Backend-owned payment obligation was not found

409

Section titled “409”

Payment obligation or idempotency facts conflict

503

Section titled “503”

Reservation payment pre-registration runtime is unavailable