Billing address and checkout

Manage the billing address on file and preview what a partner will be charged.

Manage the billing address on file and preview what a partner will be charged.

Prerequisites

  • A bearer token in the Authorization header. Any endpoint that needs no token says so on its own page.
  • The id of each record the call targets. Every endpoint page lists the ids it needs.

Errors

StatusMeaning
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Individual endpoints may return more; each page lists its own.

Endpoints

MethodEndpointDescription
GETGet the billing addressGet the latest saved billing address for a user (with its city -> state -> country chain).
POSTSave the billing addressCreate or updates (on the user's latest row) the billing address for user_id.
POSTPreview partner chargesReturns 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.