Skip to content
Bottle

Sync the subscription from Stripe

POST
/billing/reconcile
curl --request POST \
  --url https://example.com/billing/reconcile \
  --header 'Content-Type: application/json' \
  --cookie __Host-bottle.session_token=<__Host-bottle.session_token> \
  --data '{ "checkoutSessionId": "example" }'

Reads the subscription from Stripe and records it. Safe to call at any time: it changes nothing that is already up to date.

Authorizations

Section titled “Authorizations”

Request Body

Section titled “Request Body”
Media typeapplication/json
object
checkoutSessionId

The Checkout session just finished, when there is one.

string

Example generated

{
  "checkoutSessionId": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

Where this business stands afterwards

Media typeapplication/json
object
plan
required
string
Allowed values: shop yard round depot
status
required
string
Allowed values: trialing active past_due unpaid canceled incomplete incomplete_expired paused none
inGoodStanding
required
boolean
manageable
required
boolean
trialEndsAt
required
string | null format: date-time
currentPeriodEnd
required
string | null format: date-time
cancelAt
required
string | null format: date-time
pendingPlan
required
string | null
Allowed values: shop yard round depot
pendingPlanAt
required
string | null format: date-time
rateLimits
required
object
requestsPerMinute
required
integer
> 0
heavyPerMinute
required
integer
> 0
discount
required
object
percentOff
required
integer
>= 1 <= 100
until
required
string | null format: date-time
customPrice
required
object
monthlyPence
required
integer
from
required
string | null format: date-time
vehiclesUsed
required
integer
addons
required
Array<string>
Allowed values: shop
areasGranted
required
Array<string>
Allowed values: rounds vehicles rota cash standingOrders yards deliveryPartners whatsapp storefront assets servicing
features
required
object
rounds
required
boolean
vehicles
required
boolean
rota
required
boolean
cash
required
boolean
standingOrders
required
boolean
yards
required
boolean
deliveryPartners
required
boolean
whatsapp
required
boolean
storefront
required
boolean
assets
required
boolean
servicing
required
boolean

Example 

{
  "plan": "shop",
  "status": "trialing",
  "pendingPlan": "shop",
  "addons": [
    "shop"
  ],
  "areasGranted": [
    "rounds"
  ]
}

401

Section titled “401”

Not signed in

Media typeapplication/json
object
error
required
string
message
required
string

Example 

{
  "error": "not_found",
  "message": "Customer not found"
}

403

Section titled “403”

Not allowed to manage billing, or asking for a key to do it

Media typeapplication/json
object
error
required
string
message
required
string

Example 

{
  "error": "not_found",
  "message": "Customer not found"
}