Retrieve a client
Retrieve a billing template client by client’s ID.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Object ID (UUID)
Response
Connects a Client object to a BillingTemplate having is_subscription = true
to store information about a single subscriber.
You will be able to pause an individual subscription client's cycle by PATCH-ing its' status
field to the value of subscription_paused
.
ID of the Client object to add to the BillingTemplate. Read-only after the BillingTemplateClient has been created. Note that the same Client can be added to a BillingTemplate several times.
Object type identifier
Object creation time
Object last modification time
For subscriptions, you can edit (PATCH /billing_templates/{id}/clients/{id}/
) this status between active
and subscription_paused
values to pause the client's subscription. Paused subscriptions run as normal, except for purchases not being created and invoices sent for them. It means that if you pause a BillingTemplateClient's monthly subscription cycle a day before the billing date, the next day the invoice will not be issued; but, if you unpause the client a day after the planned billing would have taken place, the planned billing in a month (minus one day) will happen as usual.
Read-only if the BillingTemplateClient is in inactive
(internal status not managed through public API) or pending
(see documentation for POST /billing_templates/{id}/add_subscriber/
) statuses.
pending
, inactive
, active
, subscription_paused
If not null, reports the date when the next billing is scheduled for this client.
An optional whitelist of payment methods availble for purchases generated for this BillingTemplateClient. Copied 1:1 to Purchase.payment_method_whitelist
field on created Purchases (see its description).
Sends invoice when subscription charge fails if this is true
Sends invoice when POST /billing_templates/{id}/add_subscriber/
is called if this is true
Sends receipt when subscription charge succeeds if this is true