Partner checkout details

Returns a partner-level checkout preview for a plan: the plan pricing plus the count and list of the partner's active/pending stores (where the store's who_will_pay is partner) that the plan would apply to. cancel_plan filters the store set by whether the store's latest plan is already flagged for cancellation. Read-only preview — nothing is charged or written.

Auth

  • Bearer partner token. partner_id must be a bundle_id = 1 partner company inside the caller's hierarchy (exists + an ownership check). Each account_ids[] must be a bundle_id = 3 account company in the caller's hierarchy.

Rate limit

  • No rate limit.

Body

FieldTypeRequiredNotes
plan_idintegerRequiredMust be an existing plan.
partner_idintegerRequiredbundle_id = 1 partner company in caller's hierarchy. Matched as partner.id OR partner.company_id.
all_accountinteger (0|1)Required1 = all accounts under the partner; 0 = only account_ids.
account_idsinteger[]Required if all_account = 0Each a bundle_id = 3 account company in caller's hierarchy.
cancel_planinteger (0|1)Optional0/empty = only stores NOT flagged for cancellation; 1 = only stores whose latest plan has a cancel_subscription_at.

Behaviour

  • 200 — double-wrapped envelope { data: { data: {.} } } (controller passes ['data' =>.] into the { data. } responder). Payload: plan_id, plan_name, plan_short_info, price, original_price, total_location (matched store count), plan_start (today), plan_end (end of month), store_ids (matched store ids).
  • 422 — validation failure (missing/invalid plan, partner out of scope, account_ids required when all_account = 0).
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
string
integer
account_ids
array of strings
account_ids
integer
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json