Billing portals

Use these operations to create and manage billing portals. Rebilly hosted billing portals provide secure, Rebilly hosted pages, where customers can: view invoices, cancel subscriptions, update payment instruments, and update their address.
Operations

Retrieve billing portals

Request

Retrieves a list of billing portals.
Security
SecretApiKey or JWT
Query
limitinteger, [ 0 .. 1000 ]

Limit the number of collection items to be returned. Use 0 to return an empty collection and still receive the count of matching items in Pagination-Total.

offsetinteger, [ 0 .. 1000 ]
Specifies the starting point within the collection of items to be returned.
sortArray of strings

Sorts and orders the collection of items. To sort in descending order, prefix with -. Multiple fields can be sorted by separating each with ,.

filterstring

Criteria for filtering collection items. This field requires a special format. Use , to specify multiple allowed values. Use ; to specify multiple fields.

For more information, see Search filters.

qstring
Use this field to perform a partial search of text fields.
curl -i -X GET \
  'https://www.rebilly.com/_mock/catalog/all/billing-portals?limit=0&offset=0&sort=string&filter=string&q=string' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'

Responses

List of billing portals retrieved.
Headers
Pagination-Totalinteger

Total number of items that match the request. The value is independent of limit, including when limit is 0.

Example:332
Pagination-Limitinteger
Maximum number of items per page.
Example:100
Pagination-Offsetinteger

Specifies the starting point within the collection of resource results. For example, a request with limit=20 retrieves and displays the first 20 results on a page. A following request with limit=20 and offset=20, retrieves the next page of 20 results.

Example:2
Bodyapplication/json
Array [
idstring, <= 50 charactersread-only
ID of the billing portal.
Example:"bill_prt_0YV7K5TYV5D1P9ZNKDT39KZC3C"
websiteIdstring, <= 50 characters(WebsiteId)required
Example:"web_0YV7DE4Z26DQSA1AC92FBJ7SEG"
slugstring, [ 5 .. 100 ] charactersrequired

Path segment that is appended to the billing portal URL to help make it human-readable. Example: https://example.com/billing-portal/{slug}.

namestringrequired
Billing portal name. This name is for internal use and helps you to organize and differentiate billing portals. This value is not displayed to your customers.
customDomainstring or null, <= 255 characters

Custom domain for the billing portal. The default domain is: portal.secure-payments.app. Only a custom domain with the purpose field set to hosted-pages is accepted.

featuresobject
Features that can be enabled for the billing portal.
customizationobject
Visual customization options for the billing portal.
statusstring

Status of the billing portal. If the status is inactive, the billing portal URL results in a 404 error.

Default:"active"
Enum:"active""inactive"
createdTimestring, (date-time)(CreatedTime)read-only
Date and time when the resource is created. This value is set automatically when the resource is created.
updatedTimestring, (date-time)(UpdatedTime)read-only
Date and time when the resource is updated. This value is set automatically when the resource is updated.
_linksArray of objects(SelfLink)read-only
Related links.
]
Response
[
  {
    "id": "bill_prt_0YV7K5TYV5D1P9ZNKDT39KZC3C",
    "websiteId": "web_0YV7DE4Z26DQSA1AC92FBJ7SEG",
    "slug": "string",
    "name": "string",
    "customDomain": "string",
    "features": { … },
    "customization": { … },
    "status": "active",
    "createdTime": "2019-08-24T14:15:22Z",
    "updatedTime": "2019-08-24T14:15:22Z",
    "_links": [ … ]
  }
]