Retrieve a billing portal

Retrieve a billing portal with a specified slug.

SecuritySecretApiKey or JWT
Request
path Parameters
slug
required
string <= 100 characters ^[@~\-\.\w]+$

The resource slug.

Responses
200

Billing portal was retrieved.

Response Schema: application/json
websiteId
required
string <= 50 characters

ID of the website that is associated with the billing portal. A website is where your organization obtains a customer. It is also the gateway account and billing descriptor used for payment transactions.

slug
required
string [ 5 .. 100 ] characters

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

id
string <= 50 characters

Billing portal identifier string.

customDomain
string or null <= 255 characters

Custom domain for the billing portal. The default domain is: portal.secure-payments.app.

object

Features that can be enabled for the billing portal.

authenticateWithPassword
boolean
Default: true

Specifies whether a customer can authenticate with a password.

orderCancel
boolean
Default: true

Specifies whether a customer can cancel an order.

orderAddressEdit
boolean
Default: true

Specifies whether a customer can change an order address.

paymentInstrumentAdd
boolean
Default: true

Specifies whether a customer can add a new payment instrument.

paymentInstrumentUpdate
boolean
Default: true

Specifies whether a customer can update their payment instruments.

paymentInstrumentDeactivate
boolean
Default: true

Specifies whether a customer can disable their payment instruments.

object

Visual customization options for the billing portal.

logoId
string <= 50 characters

ID of the linked file object.

object

Various colors used in the billing portal.

primary
string <= 6 characters
Default: "0044d4"

Primary color for the billing portal in hexadecimal format.

secondary
string <= 6 characters
Default: "ffffff"

Secondary color for the billing portal in hexadecimal format.

object

URLs that are displayed in the billing portal.

refundPolicy
string <url>

Website refund policy URL.

privacyPolicy
string <url>

Website privacy policy URL.

termsOfService
string <url>

Website terms of service URL.

createdTime
string <date-time>

Date and time at which the billing portal was created.

updatedTime
string <date-time> (UpdatedTime)

Read-only timestamp. This value updates when the resource is updated.

token
string

The session's token used for authentication.

Array of Self (object) or LogoUrlLink (object) non-empty

Related resource links.

Array (non-empty)
Any of:
href
required
string

Link URL.

rel
required
string

Type of link.

Value: "self"
401

Unauthorized access. Invalid credentials used.

403

Access forbidden.

404

Resource not found.

get/billing-portals/{slug}
Request samples
Response samples
application/json
{
  • "id": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
  • "slug": "string",
  • "websiteId": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
  • "customDomain": "string",
  • "features": {
    },
  • "customization": {
    },
  • "createdTime": "2019-08-24T14:15:22Z",
  • "updatedTime": "2019-08-24T14:15:22Z",
  • "token": "string",
  • "_links": [
    ]
}