Storefront checkout forms/
Retrieve a checkout form

Retrieve a checkout form
deprecated

Request

Retrieves a checkout form with a specified ID.

Path
idstring, <= 50 characters^[@~\-\.\w]+$required

ID of the resource.

curl -i -X GET \
  'https://www.rebilly.com/_mock/catalog/all/storefront/checkout-forms/{id}'

Responses

Checkout form retrieved.

Bodyapplication/json
idstring, <= 50 charactersread-only

ID of the checkout form.

Example:"chkt_frm_0YV8XZ6174C2MBS5011SAZNMBP"
websiteIdstring, <= 50 characters(WebsiteId)required

ID of the website. A website is where an organization obtains a customer. For more information, see Obtain an organization ID and website ID.

Example:"web_0YV7DE4Z26DQSA1AC92FBJ7SEG"
customDomainstring or null, <= 255 characters

Custom domain for the checkout form.

plansArray of objects, non-empty(CheckoutFormPlan)required

List of plans that are applied to a customer order by default. Plans describe how the customer must pay for products. For more information, see Plans.

addonPlansArray of objects(CheckoutFormPlan)

List of add-on plans that are displayed to the customer on the payment screen. Add-ons are plans that the customer has not already subscribed to.

The customer selects whether to add an add-on plan to their current order.

Default:[]
bumpPlansArray of objects(CheckoutFormPlan)

List of bump plans that are displayed to the customer on the payment screen. Use bump plans to offer purchase bonuses, discounts, and deals to the customer.

The customer selects whether to purchase bump plans, or to use the plans that are specified in their current order.

Default:[]
accountsEnabledboolean

Specifies if the account is enabled. If this value is true, the customer can sign-up and sign-in using the checkout form.

Default:false
couponsEnabledboolean

Specifies if coupons are enabled in the checkout form. If this value is true, the customer can use coupons in the checkout form. Use coupons to reward customers, generate sales, or to test new pricing strategies.

Default:false
purchaseLimitinteger or null, >= 0

Limits the number of purchases that can be made using a specific checkout form. If a purchase limit value is set, each purchase decreases this value. When the purchases limit value reaches zero, the checkout form becomes inactive.

Default:null
paymentMethodsArray of strings

List of available payment methods. Payment methods must have at least one active gateway account. If not specified, all available payment methods are displayed.

customizationobject

Visual customization options for the checkout form.

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.

tokenstringread-only

Session token that is used for authentication.

Response
{
  "id": "chkt_frm_0YV8XZ6174C2MBS5011SAZNMBP",
  "websiteId": "web_0YV7DE4Z26DQSA1AC92FBJ7SEG",
  "customDomain": "string",
  "plans": [
    { … }
  ],
  "addonPlans": [],
  "bumpPlans": [],
  "accountsEnabled": false,
  "couponsEnabled": false,
  "purchaseLimit": null,
  "paymentMethods": [
    "payment-card"
  ],
  "customization": {
    "logoId": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
    "summary": "string",
    "buttonText": "Pay {{amount}}",
    "colors": { … },
    "links": { … },
    "tracking": { … },
    "requiredAdditionalFields": [ … ]
  },
  "createdTime": "2019-08-24T14:15:22Z",
  "updatedTime": "2019-08-24T14:15:22Z",
  "token": "string",
  "_links": [
    { … }
  ]
}