Skip to content
Subscription Reservations

Submit Subscription Reservation

Submits a subscription reservation with the reservation amount, financing multiple, and selected cards, and returns the reservation ID on success. Before submitting, ask the client to accept the reservation rules (once the subscription order is created it cannot be cancelled; the reservation fails if the principal is insufficient at allocation or a subscription order already exists). On failure, tell the client according to the business code; for other errors, report that the reservation failed. After a successful reservation, the client can view or cancel it in the reservation records.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

POSThttps://api.lbkrs.com/v1/subscription/reservation/submit

Request body application/json

subscription_idstringrequired

Reservation project ID

amountstringrequired

Reservation amount. The required principal must not exceed the available cash from Get Subscription Reservation Info, and the amount must be within the limits

leveragestringrequired

Financing multiple; use leverage from Get Subscription Reservation Info

cardsarray<string>

IDs of the cards used (quota reservation coupons, IPO financing interest cards, IPO fee cards). Pass an empty array if none are used

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Subscription Reservation” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
order_idstring

Reservation ID

amountstring

Reservation amount

cardsarray<string>

IDs of the cards used

HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs