Update The Capped Amount Of Recurring Application Charge

Updates the capped amount for a recurring application charge. The capped amount must be greater than the original maximum.

This API is especially useful for:

  • Adjusting the capped amount for recurring charges based on new usage requirements.
  • Dynamically updating billing constraints for subscription plans.
  • Ensuring the capped amount aligns with increased usage or consumption.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Path Parameters

NameTypeRequiredDescriptionExample
recurring_charge_idstringYesThe ID of the recurring application charge.372269669345671159

Body Parameters

NameTypeRequiredDescriptionExample
capped_amountfloatYesThe maximum usage fee. Must be greater than the original maximum.50.0

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Success Response

FieldTypeDescriptionExample
recurring_application_charge.idstringUnique identifier of the recurring application charge.372269669345671159
recurring_application_charge.namestringName of the recurring application charge."test"
recurring_application_charge.pricestringThe recurring charge price."100"
recurring_application_charge.activated_onstringActivation date of the recurring application charge in ISO 8601 format."2024-04-23T00:00:00Z"
recurring_application_charge.billing_onstringThe next billing date of the recurring application charge in ISO 8601 format."2024-05-23T00:00:00Z"
recurring_application_charge.cancelled_onstringCancellation date of the recurring application charge, if applicable.null
recurring_application_charge.capped_amountstringThe terms and conditions of usage based billing charges. Must be present in order to create usage charges, for example when the capped_amount property is provided. Presented to the merchant when they approve an app's usage charges."10"
recurring_application_charge.return_urlstringRedirect URL after payment."https://shoplazza.com"
recurring_application_charge.statusstringCurrent status of the recurring application charge."active"
recurring_application_charge.termsstringThe terms and conditions of usage based billing charges. Must be present in order to create usage charges, for example when the capped_amount property is provided. Presented to the merchant when they approve an app's usage charges."terms"
recurring_application_charge.testbooleanIndicates whether this is a test charge.false
recurring_application_charge.trial_daysintegerTrial period in days for the recurring application charge.0
recurring_application_charge.trial_ends_onstringEnd date of the trial period in ISO 8601 format, if applicable.null
recurring_application_charge.update_capped_amount_urlstringURL to confirm the update of the capped amount."https://test-shoplazza.stg.myshoplaza.com/admin/smart_apps/angora/app_store/charges/..."
recurring_application_charge.created_atstringCreation timestamp of the recurring application charge in ISO 8601 format."2024-04-23T06:26:46Z"
recurring_application_charge.updated_atstringLast update timestamp of the recurring application charge in ISO 8601 format."2024-04-23T06:40:51Z"

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsArray[ "Record not found"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorString "page not found"Indicates an error encountered during the process

Error Detail

Status CodeMessagePossible ReasonExample Response
400Bad RequestInvalid input format or request structure (e.g., missing required fields or incorrect data types).Bad Request
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.Unauthorized
404Not FoundThe recurring_charge_idi s not found."Record not found"
422Unprocessable EntityThe recurring_charge_idis is empty."RecurringChargeId is required"

API Structure Overview

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!