Chilkat Online Tools

delphiDll / DocuSign eSignature REST API / Updates the account billing plan.

Back to Collection Items

var
http: HCkHttp;
success: Boolean;
json: HCkJsonObject;
sbRequestBody: HCkStringBuilder;
resp: HCkHttpResponse;

begin
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

http := CkHttp_Create();

// Use this online tool to generate code from sample JSON: Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "planInformation": {
//     "planId": "sample string 1",
//     "planFeatureSets": [
//       {
//         "featureSetId": "sample string 1",
//         "isActive": "sample string 2",
//         "name": "sample string 3",
//         "fixedFee": "sample string 4",
//         "envelopeFee": "sample string 5",
//         "seatFee": "sample string 6",
//         "isEnabled": "sample string 7",
//         "is21CFRPart11": "sample string 8",
//         "currencyFeatureSetPrices": [
//           {
//             "currencyCode": "sample string 1",
//             "fixedFee": "sample string 2",
//             "seatFee": "sample string 3",
//             "envelopeFee": "sample string 4",
//             "currencySymbol": "sample string 5"
//           }
//         ]
//       }
//     ],
//     "addOns": [
//       {
//         "id": "sample string 1",
//         "addOnId": "sample string 2",
//         "name": "sample string 3",
//         "active": "sample string 4"
//       }
//     ],
//     "recipientDomains": [
//       {
//         "recipientDomainId": "sample string 1",
//         "domainCode": "sample string 2",
//         "domainName": "sample string 3",
//         "active": "sample string 4"
//       }
//     ],
//     "currencyCode": "sample string 2",
//     "freeTrialDaysOverride": "sample string 3"
//   },
//   "enableSupport": "sample string 1",
//   "includedSeats": "sample string 2",
//   "incrementalSeats": "sample string 3",
//   "saleDiscountPercent": "sample string 4",
//   "saleDiscountAmount": "sample string 5",
//   "saleDiscountFixedAmount": "sample string 6",
//   "saleDiscountPeriods": "sample string 7",
//   "saleDiscountSeatPriceOverride": "sample string 8",
//   "renewalStatus": "sample string 9",
//   "downgradeReason": "sample string 10",
//   "creditCardInformation": {
//     "cardNumber": "sample string 1",
//     "expirationMonth": "sample string 2",
//     "expirationYear": "sample string 3",
//     "nameOnCard": "sample string 4",
//     "cardType": "sample string 5",
//     "address": {
//       "street1": "sample string 1",
//       "street2": "sample string 2",
//       "city": "sample string 3",
//       "state": "sample string 4",
//       "zip": "sample string 5",
//       "phone": "sample string 6",
//       "fax": "sample string 7",
//       "country": "sample string 8",
//       "zipPlus4": "sample string 9"
//     }
//   },
//   "appStoreReceipt": {
//     "productId": "sample string 1",
//     "receiptData": "sample string 2"
//   },
//   "billingAddress": {
//     "address1": "sample string 1",
//     "address2": "sample string 2",
//     "city": "sample string 3",
//     "state": "sample string 4",
//     "postalCode": "sample string 5",
//     "phone": "sample string 6",
//     "fax": "sample string 7",
//     "country": "sample string 8",
//     "firstName": "sample string 9",
//     "lastName": "sample string 10",
//     "email": "sample string 11",
//     "supportedCountries": [
//       {
//         "isoCode": "sample string 1",
//         "provinceValidated": "sample string 2",
//         "name": "sample string 3",
//         "provinces": [
//           {
//             "isoCode": "sample string 1",
//             "name": "sample string 2"
//           }
//         ]
//       }
//     ]
//   },
//   "referralInformation": {
//     "enableSupport": "sample string 1",
//     "includedSeats": "sample string 2",
//     "saleDiscountPercent": "sample string 3",
//     "saleDiscountAmount": "sample string 4",
//     "saleDiscountFixedAmount": "sample string 5",
//     "saleDiscountPeriods": "sample string 6",
//     "saleDiscountSeatPriceOverride": "sample string 7",
//     "planStartMonth": "sample string 8",
//     "referralCode": "sample string 9",
//     "referrerName": "sample string 10",
//     "advertisementId": "sample string 11",
//     "publisherId": "sample string 12",
//     "shopperId": "sample string 13",
//     "promoCode": "sample string 14",
//     "groupMemberId": "sample string 15",
//     "idType": "sample string 16",
//     "industry": "sample string 17",
//     "externalOrgId": "sample string 18"
//   },
//   "paymentProcessorInformation": {
//     "billingAgreementId": "sample string 1",
//     "email": "sample string 2",
//     "address": {}
//   }
// }

json := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'planInformation.planId','sample string 1');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].featureSetId','sample string 1');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].isActive','sample string 2');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].name','sample string 3');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].fixedFee','sample string 4');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].envelopeFee','sample string 5');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].seatFee','sample string 6');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].isEnabled','sample string 7');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].is21CFRPart11','sample string 8');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].currencyFeatureSetPrices[0].currencyCode','sample string 1');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].currencyFeatureSetPrices[0].fixedFee','sample string 2');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].currencyFeatureSetPrices[0].seatFee','sample string 3');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].currencyFeatureSetPrices[0].envelopeFee','sample string 4');
CkJsonObject_UpdateString(json,'planInformation.planFeatureSets[0].currencyFeatureSetPrices[0].currencySymbol','sample string 5');
CkJsonObject_UpdateString(json,'planInformation.addOns[0].id','sample string 1');
CkJsonObject_UpdateString(json,'planInformation.addOns[0].addOnId','sample string 2');
CkJsonObject_UpdateString(json,'planInformation.addOns[0].name','sample string 3');
CkJsonObject_UpdateString(json,'planInformation.addOns[0].active','sample string 4');
CkJsonObject_UpdateString(json,'planInformation.recipientDomains[0].recipientDomainId','sample string 1');
CkJsonObject_UpdateString(json,'planInformation.recipientDomains[0].domainCode','sample string 2');
CkJsonObject_UpdateString(json,'planInformation.recipientDomains[0].domainName','sample string 3');
CkJsonObject_UpdateString(json,'planInformation.recipientDomains[0].active','sample string 4');
CkJsonObject_UpdateString(json,'planInformation.currencyCode','sample string 2');
CkJsonObject_UpdateString(json,'planInformation.freeTrialDaysOverride','sample string 3');
CkJsonObject_UpdateString(json,'enableSupport','sample string 1');
CkJsonObject_UpdateString(json,'includedSeats','sample string 2');
CkJsonObject_UpdateString(json,'incrementalSeats','sample string 3');
CkJsonObject_UpdateString(json,'saleDiscountPercent','sample string 4');
CkJsonObject_UpdateString(json,'saleDiscountAmount','sample string 5');
CkJsonObject_UpdateString(json,'saleDiscountFixedAmount','sample string 6');
CkJsonObject_UpdateString(json,'saleDiscountPeriods','sample string 7');
CkJsonObject_UpdateString(json,'saleDiscountSeatPriceOverride','sample string 8');
CkJsonObject_UpdateString(json,'renewalStatus','sample string 9');
CkJsonObject_UpdateString(json,'downgradeReason','sample string 10');
CkJsonObject_UpdateString(json,'creditCardInformation.cardNumber','sample string 1');
CkJsonObject_UpdateString(json,'creditCardInformation.expirationMonth','sample string 2');
CkJsonObject_UpdateString(json,'creditCardInformation.expirationYear','sample string 3');
CkJsonObject_UpdateString(json,'creditCardInformation.nameOnCard','sample string 4');
CkJsonObject_UpdateString(json,'creditCardInformation.cardType','sample string 5');
CkJsonObject_UpdateString(json,'creditCardInformation.address.street1','sample string 1');
CkJsonObject_UpdateString(json,'creditCardInformation.address.street2','sample string 2');
CkJsonObject_UpdateString(json,'creditCardInformation.address.city','sample string 3');
CkJsonObject_UpdateString(json,'creditCardInformation.address.state','sample string 4');
CkJsonObject_UpdateString(json,'creditCardInformation.address.zip','sample string 5');
CkJsonObject_UpdateString(json,'creditCardInformation.address.phone','sample string 6');
CkJsonObject_UpdateString(json,'creditCardInformation.address.fax','sample string 7');
CkJsonObject_UpdateString(json,'creditCardInformation.address.country','sample string 8');
CkJsonObject_UpdateString(json,'creditCardInformation.address.zipPlus4','sample string 9');
CkJsonObject_UpdateString(json,'appStoreReceipt.productId','sample string 1');
CkJsonObject_UpdateString(json,'appStoreReceipt.receiptData','sample string 2');
CkJsonObject_UpdateString(json,'billingAddress.address1','sample string 1');
CkJsonObject_UpdateString(json,'billingAddress.address2','sample string 2');
CkJsonObject_UpdateString(json,'billingAddress.city','sample string 3');
CkJsonObject_UpdateString(json,'billingAddress.state','sample string 4');
CkJsonObject_UpdateString(json,'billingAddress.postalCode','sample string 5');
CkJsonObject_UpdateString(json,'billingAddress.phone','sample string 6');
CkJsonObject_UpdateString(json,'billingAddress.fax','sample string 7');
CkJsonObject_UpdateString(json,'billingAddress.country','sample string 8');
CkJsonObject_UpdateString(json,'billingAddress.firstName','sample string 9');
CkJsonObject_UpdateString(json,'billingAddress.lastName','sample string 10');
CkJsonObject_UpdateString(json,'billingAddress.email','sample string 11');
CkJsonObject_UpdateString(json,'billingAddress.supportedCountries[0].isoCode','sample string 1');
CkJsonObject_UpdateString(json,'billingAddress.supportedCountries[0].provinceValidated','sample string 2');
CkJsonObject_UpdateString(json,'billingAddress.supportedCountries[0].name','sample string 3');
CkJsonObject_UpdateString(json,'billingAddress.supportedCountries[0].provinces[0].isoCode','sample string 1');
CkJsonObject_UpdateString(json,'billingAddress.supportedCountries[0].provinces[0].name','sample string 2');
CkJsonObject_UpdateString(json,'referralInformation.enableSupport','sample string 1');
CkJsonObject_UpdateString(json,'referralInformation.includedSeats','sample string 2');
CkJsonObject_UpdateString(json,'referralInformation.saleDiscountPercent','sample string 3');
CkJsonObject_UpdateString(json,'referralInformation.saleDiscountAmount','sample string 4');
CkJsonObject_UpdateString(json,'referralInformation.saleDiscountFixedAmount','sample string 5');
CkJsonObject_UpdateString(json,'referralInformation.saleDiscountPeriods','sample string 6');
CkJsonObject_UpdateString(json,'referralInformation.saleDiscountSeatPriceOverride','sample string 7');
CkJsonObject_UpdateString(json,'referralInformation.planStartMonth','sample string 8');
CkJsonObject_UpdateString(json,'referralInformation.referralCode','sample string 9');
CkJsonObject_UpdateString(json,'referralInformation.referrerName','sample string 10');
CkJsonObject_UpdateString(json,'referralInformation.advertisementId','sample string 11');
CkJsonObject_UpdateString(json,'referralInformation.publisherId','sample string 12');
CkJsonObject_UpdateString(json,'referralInformation.shopperId','sample string 13');
CkJsonObject_UpdateString(json,'referralInformation.promoCode','sample string 14');
CkJsonObject_UpdateString(json,'referralInformation.groupMemberId','sample string 15');
CkJsonObject_UpdateString(json,'referralInformation.idType','sample string 16');
CkJsonObject_UpdateString(json,'referralInformation.industry','sample string 17');
CkJsonObject_UpdateString(json,'referralInformation.externalOrgId','sample string 18');
CkJsonObject_UpdateString(json,'paymentProcessorInformation.billingAgreementId','sample string 1');
CkJsonObject_UpdateString(json,'paymentProcessorInformation.email','sample string 2');
CkJsonObject_UpdateNewObject(json,'paymentProcessorInformation.address');

// Adds the "Authorization: Bearer {{accessToken}}" header.
CkHttp_putAuthToken(http,'{{accessToken}}');
CkHttp_SetRequestHeader(http,'Accept','application/json');

sbRequestBody := CkStringBuilder_Create();
CkJsonObject_EmitSb(json,sbRequestBody);

resp := CkHttp_PTextSb(http,'PUT','https://domain.com/v2.1/accounts/{{accountId}}/billing_plan?preview_billing_plan={{preview_billing_plan}}',sbRequestBody,'utf-8','application/json',False,False);
if (CkHttp_getLastMethodSuccess(http) = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

Memo1.Lines.Add(IntToStr(CkHttpResponse_getStatusCode(resp)));
Memo1.Lines.Add(CkHttpResponse__bodyStr(resp));
CkHttpResponse_Dispose(resp);

CkHttp_Dispose(http);
CkJsonObject_Dispose(json);
CkStringBuilder_Dispose(sbRequestBody);

Curl Command

curl -X PUT
	-H "Accept: application/json"
	-H "Authorization: Bearer {{accessToken}}"
	-d '{
  "planInformation": {
    "planId": "sample string 1",
    "planFeatureSets": [
      {
        "featureSetId": "sample string 1",
        "isActive": "sample string 2",
        "name": "sample string 3",
        "fixedFee": "sample string 4",
        "envelopeFee": "sample string 5",
        "seatFee": "sample string 6",
        "isEnabled": "sample string 7",
        "is21CFRPart11": "sample string 8",
        "currencyFeatureSetPrices": [
          {
            "currencyCode": "sample string 1",
            "fixedFee": "sample string 2",
            "seatFee": "sample string 3",
            "envelopeFee": "sample string 4",
            "currencySymbol": "sample string 5"
          }
        ]
      }
    ],
    "addOns": [
      {
        "id": "sample string 1",
        "addOnId": "sample string 2",
        "name": "sample string 3",
        "active": "sample string 4"
      }
    ],
    "recipientDomains": [
      {
        "recipientDomainId": "sample string 1",
        "domainCode": "sample string 2",
        "domainName": "sample string 3",
        "active": "sample string 4"
      }
    ],
    "currencyCode": "sample string 2",
    "freeTrialDaysOverride": "sample string 3"
  },
  "enableSupport": "sample string 1",
  "includedSeats": "sample string 2",
  "incrementalSeats": "sample string 3",
  "saleDiscountPercent": "sample string 4",
  "saleDiscountAmount": "sample string 5",
  "saleDiscountFixedAmount": "sample string 6",
  "saleDiscountPeriods": "sample string 7",
  "saleDiscountSeatPriceOverride": "sample string 8",
  "renewalStatus": "sample string 9",
  "downgradeReason": "sample string 10",
  "creditCardInformation": {
    "cardNumber": "sample string 1",
    "expirationMonth": "sample string 2",
    "expirationYear": "sample string 3",
    "nameOnCard": "sample string 4",
    "cardType": "sample string 5",
    "address": {
      "street1": "sample string 1",
      "street2": "sample string 2",
      "city": "sample string 3",
      "state": "sample string 4",
      "zip": "sample string 5",
      "phone": "sample string 6",
      "fax": "sample string 7",
      "country": "sample string 8",
      "zipPlus4": "sample string 9"
    }
  },
  "appStoreReceipt": {
    "productId": "sample string 1",
    "receiptData": "sample string 2"
  },
  "billingAddress": {
    "address1": "sample string 1",
    "address2": "sample string 2",
    "city": "sample string 3",
    "state": "sample string 4",
    "postalCode": "sample string 5",
    "phone": "sample string 6",
    "fax": "sample string 7",
    "country": "sample string 8",
    "firstName": "sample string 9",
    "lastName": "sample string 10",
    "email": "sample string 11",
    "supportedCountries": [
      {
        "isoCode": "sample string 1",
        "provinceValidated": "sample string 2",
        "name": "sample string 3",
        "provinces": [
          {
            "isoCode": "sample string 1",
            "name": "sample string 2"
          }
        ]
      }
    ]
  },
  "referralInformation": {
    "enableSupport": "sample string 1",
    "includedSeats": "sample string 2",
    "saleDiscountPercent": "sample string 3",
    "saleDiscountAmount": "sample string 4",
    "saleDiscountFixedAmount": "sample string 5",
    "saleDiscountPeriods": "sample string 6",
    "saleDiscountSeatPriceOverride": "sample string 7",
    "planStartMonth": "sample string 8",
    "referralCode": "sample string 9",
    "referrerName": "sample string 10",
    "advertisementId": "sample string 11",
    "publisherId": "sample string 12",
    "shopperId": "sample string 13",
    "promoCode": "sample string 14",
    "groupMemberId": "sample string 15",
    "idType": "sample string 16",
    "industry": "sample string 17",
    "externalOrgId": "sample string 18"
  },
  "paymentProcessorInformation": {
    "billingAgreementId": "sample string 1",
    "email": "sample string 2",
    "address": {}
  }
}'
https://domain.com/v2.1/accounts/{{accountId}}/billing_plan?preview_billing_plan={{preview_billing_plan}}

Postman Collection Item JSON

{
  "name": "Updates the account billing plan.",
  "request": {
    "method": "PUT",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      },
      {
        "key": "Authorization",
        "value": "Bearer {{accessToken}}"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n  \"planInformation\": {\n    \"planId\": \"sample string 1\",\n    \"planFeatureSets\": [\n      {\n        \"featureSetId\": \"sample string 1\",\n        \"isActive\": \"sample string 2\",\n        \"name\": \"sample string 3\",\n        \"fixedFee\": \"sample string 4\",\n        \"envelopeFee\": \"sample string 5\",\n        \"seatFee\": \"sample string 6\",\n        \"isEnabled\": \"sample string 7\",\n        \"is21CFRPart11\": \"sample string 8\",\n        \"currencyFeatureSetPrices\": [\n          {\n            \"currencyCode\": \"sample string 1\",\n            \"fixedFee\": \"sample string 2\",\n            \"seatFee\": \"sample string 3\",\n            \"envelopeFee\": \"sample string 4\",\n            \"currencySymbol\": \"sample string 5\"\n          }\n        ]\n      }\n    ],\n    \"addOns\": [\n      {\n        \"id\": \"sample string 1\",\n        \"addOnId\": \"sample string 2\",\n        \"name\": \"sample string 3\",\n        \"active\": \"sample string 4\"\n      }\n    ],\n    \"recipientDomains\": [\n      {\n        \"recipientDomainId\": \"sample string 1\",\n        \"domainCode\": \"sample string 2\",\n        \"domainName\": \"sample string 3\",\n        \"active\": \"sample string 4\"\n      }\n    ],\n    \"currencyCode\": \"sample string 2\",\n    \"freeTrialDaysOverride\": \"sample string 3\"\n  },\n  \"enableSupport\": \"sample string 1\",\n  \"includedSeats\": \"sample string 2\",\n  \"incrementalSeats\": \"sample string 3\",\n  \"saleDiscountPercent\": \"sample string 4\",\n  \"saleDiscountAmount\": \"sample string 5\",\n  \"saleDiscountFixedAmount\": \"sample string 6\",\n  \"saleDiscountPeriods\": \"sample string 7\",\n  \"saleDiscountSeatPriceOverride\": \"sample string 8\",\n  \"renewalStatus\": \"sample string 9\",\n  \"downgradeReason\": \"sample string 10\",\n  \"creditCardInformation\": {\n    \"cardNumber\": \"sample string 1\",\n    \"expirationMonth\": \"sample string 2\",\n    \"expirationYear\": \"sample string 3\",\n    \"nameOnCard\": \"sample string 4\",\n    \"cardType\": \"sample string 5\",\n    \"address\": {\n      \"street1\": \"sample string 1\",\n      \"street2\": \"sample string 2\",\n      \"city\": \"sample string 3\",\n      \"state\": \"sample string 4\",\n      \"zip\": \"sample string 5\",\n      \"phone\": \"sample string 6\",\n      \"fax\": \"sample string 7\",\n      \"country\": \"sample string 8\",\n      \"zipPlus4\": \"sample string 9\"\n    }\n  },\n  \"appStoreReceipt\": {\n    \"productId\": \"sample string 1\",\n    \"receiptData\": \"sample string 2\"\n  },\n  \"billingAddress\": {\n    \"address1\": \"sample string 1\",\n    \"address2\": \"sample string 2\",\n    \"city\": \"sample string 3\",\n    \"state\": \"sample string 4\",\n    \"postalCode\": \"sample string 5\",\n    \"phone\": \"sample string 6\",\n    \"fax\": \"sample string 7\",\n    \"country\": \"sample string 8\",\n    \"firstName\": \"sample string 9\",\n    \"lastName\": \"sample string 10\",\n    \"email\": \"sample string 11\",\n    \"supportedCountries\": [\n      {\n        \"isoCode\": \"sample string 1\",\n        \"provinceValidated\": \"sample string 2\",\n        \"name\": \"sample string 3\",\n        \"provinces\": [\n          {\n            \"isoCode\": \"sample string 1\",\n            \"name\": \"sample string 2\"\n          }\n        ]\n      }\n    ]\n  },\n  \"referralInformation\": {\n    \"enableSupport\": \"sample string 1\",\n    \"includedSeats\": \"sample string 2\",\n    \"saleDiscountPercent\": \"sample string 3\",\n    \"saleDiscountAmount\": \"sample string 4\",\n    \"saleDiscountFixedAmount\": \"sample string 5\",\n    \"saleDiscountPeriods\": \"sample string 6\",\n    \"saleDiscountSeatPriceOverride\": \"sample string 7\",\n    \"planStartMonth\": \"sample string 8\",\n    \"referralCode\": \"sample string 9\",\n    \"referrerName\": \"sample string 10\",\n    \"advertisementId\": \"sample string 11\",\n    \"publisherId\": \"sample string 12\",\n    \"shopperId\": \"sample string 13\",\n    \"promoCode\": \"sample string 14\",\n    \"groupMemberId\": \"sample string 15\",\n    \"idType\": \"sample string 16\",\n    \"industry\": \"sample string 17\",\n    \"externalOrgId\": \"sample string 18\"\n  },\n  \"paymentProcessorInformation\": {\n    \"billingAgreementId\": \"sample string 1\",\n    \"email\": \"sample string 2\",\n    \"address\": {}\n  }\n}"
    },
    "url": {
      "raw": "{{baseUrl}}/v2.1/accounts/{{accountId}}/billing_plan?preview_billing_plan={{preview_billing_plan}}",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "v2.1",
        "accounts",
        "{{accountId}}",
        "billing_plan"
      ],
      "query": [
        {
          "key": "preview_billing_plan",
          "value": "{{preview_billing_plan}}"
        }
      ],
      "variable": [
        {
          "key": "accountId",
          "value": "{{accountId}}",
          "type": "string"
        }
      ]
    },
    "description": "Updates the billing plan information, billing address, and credit card information for the specified account."
  },
  "response": [
  ]
}