Add a bundle

The ADDBUNDLE action purchases a bundle and adds domain slot capacity to the subscription Wallet.

Purchasing the first bundle initiates the subscription and defines its expiration date. Additional bundles can be purchased at any time to increase available domain slots. Adding more bundles is subject to pro-rated charges based on the number of full days remaining before the subscription expiration date.

Action: ADDBUNDLE

Variable Name Type Max. Length Description

loginName

string

64 chars

Your account username.

This value is case sensitive.

loginPassword

string

128 chars

Your account password.

This value is case sensitive.

action

string

30 chars

The action to be taken.

In this case, the value is: ADDBUNDLE.

acmeAccountID

string

32 chars

Your Base64 URL-encoded ACME account ID.

domainType

string

The type of domain.

The allowed values are:

  • fqdn — Fully Qualified Domain Name (FQDN)

  • wildcard — Wildcard domain

numberOfDomains

integer

The number of domains in the bundle.

The supported values are:

  • 1, 3, 5, 10 (for FQDN)

  • 1, 3, 5 (for Wildcard)

quoteOnly

string

1 char

Indicates whether to return a quote or perform the action.

The allowed values are:

  • N — (Default) Performs the actual ADDBUNDLE action.

  • Y — Returns a quote for the requested action, valid at the time of request, but does not perform any action.

Sample request

curl --location --request POST 'https://secure.trust-provider.com/products/!ACMEAdmin' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'loginName=loginName' \
--data-urlencode 'loginPassword=loginPassword' \
--data-urlencode 'action=ADDBUNDLE' \
--data-urlencode 'acmeAccountID=ABc_123xYZ456' \
--data-urlencode 'domainType=fqdn' \
--data-urlencode 'numberOfDomains=5' \
--data-urlencode 'quoteOnly=N'

Response

Response parameters

The response may contain the following parameters:

Parameter Type Description

success

boolean

The status of the request.

orderNumber

number

The order number for the bundle purchase.

cost

number

The cost of the bundle purchase.

currency

string

The currency of the bundle purchase cost.

billingBreakdown

array

A structured breakdown of the charges applied to the subscription.

The beginning of the billingBreakdown array

subscriptionTerm

string

Indicates whether the charge applies to the current subscription term or an extension.

chargedDays

number

The number of days charged for the segment.

totalSubscriptionDays

number

The total number of days in the full subscription term associated with the segment.

chargedAmount

number

The amount charged for the segment.

bundle

object

The details of the purchased bundle.

Sample success response

{
  "success": true,
  "orderNumber": 123456,
  "cost": 500.00,
// displayed price is for sample purposes only
  "currency": "USD",
  "bundle": {
    "domainType": "fqdn",
    "numberOfDomains": 5
  }
}