Subscription

Type:  
Abstract:  no
Status:  Active
Java Class:  Subscription
Information about the subscription transaction.
Available Fields:
id
References: Payment Plan.Id
XML Representation: attribute
Attributes:
Default Value
Identifier of the object used for references; auto-incremented integer value.

**create Unique Subscription ID generated by the system.

  • exists
    • Unique Subscription ID generated by the system.

  • echo
    • Unique Subscription ID used for filtering Subscription records.
    code
    References: Payment Plan.Reference Code
    XML Representation: attribute
    Attributes:
    Default Value
    Pattern: CODE
    See Reference Code definition for additional information.

    **create Unique Subscription ID supplied by external/user's system.
    Note: Optional secondary identifier. Typically this field is a reference to an ID in your own system to cross-reference it within our system. If not provided, the system will use the object 'id' generated at the time of object creation.
    <div class="info legacy"> For more information see Reference Field Type. </div>

  • exists
    • Unique Subscription ID supplied by external/user's system.
    Note: Optional secondary identifier. Typically this field is a reference to an ID in your own system to cross-reference it within our system. If not provided, the system will use the object 'id' generated at the time of object creation.
    <div class="info legacy"> For more information see Reference Field Type. </div>

  • echo
    • Unique Subscription ID supplied by external/user's system used for filtering records.
    accountId
    References: Payment Plan.Merchant Account Code
    XML Representation: attribute
    Attributes:
    Default Value
    Code of Merchant Account to which instance of this object is attributed to. Depending on the context, Merchant Account Code field may contain either Merchant Code or Merchant Account Code.
    The field is primarily used for data partitioning and data management, to make it easy to determine the ownership of a record within the database.


    **create Merchant account will be associated with Subscription.
    Note: If your API user is associated to more than one merchant account or group of merchant accounts, you can specify the merchant account ID for the ~find operation to reduce the data set in the API response. <br> <br> Your API credentials may be associated with more than one accountId.

  • exists
    • Merchant account associated with Subscription.
    Note: If your API user is associated to more than one merchant account or group of merchant accounts, you can specify the merchant account ID for the ~find operation to reduce the data set in the API response. <br> <br> Your API credentials may be associated with more than one accountId.


  • echo
    • Reference to an account used for filtering records.
    amount
    References: Payment Plan.Amount
    XML Representation: attribute
    Attributes:
    Default Value
    The amount of money charged every time billing occurs for this payment plan (e.g. amount of the transaction). Value must be submitted in cents without a decimal point.

    **create Amount (in cents) of the Subscription.
    Note: Amount charged every time billing occurs for this plan.


  • exists
    • Amount (in cents) of the Subscription.
    Note: Amount charged every time billing occurs for this plan.


  • echo
    • Amount (in cents) used for filtering Subscription records.
    createDate
    References: Payment Plan.Create Date
    XML Representation: attribute
    Attributes:
    Default Value
    Date when the record was created.

    **create Date when the Subscription was created.
    Note: Date format: yyyy-MM-dd.


  • exists
    • Date when the Subscription was created.
    Note: Date format: yyyy-MM-dd.


  • echo
    • Date used for filtering Subscription records.
    customerId
    References: Payment Plan.Customer Account FK
    XML Representation: attribute
    Attributes:
    Default Value
    Reference to the entity that represents code of the customer account to which instance of this object is attributed to.

    **create Identifier of a Customer that a Subscription will be associated with.

  • exists
    • Identifier of a Customer that a Subscription is associated with.

  • echo
    • Identifier of a Customer used for filtering Subscription records.
    firstBillingDate
    References: Payment Plan.First Billing Date
    XML Representation: attribute
    Attributes: Required
    Default Value
    Date when the first billing occured.

    **create Date when the first billing will occur. <div class="info legacy"> For more information see integration notes. </div>
  • exists
    • Date when the first billing occured. <div class="info legacy"> For more information see integration notes. </div>
  • echo
    • Date used for filtering Subscription records.
    lastBillingDate
    References: Payment Plan.Last Invoicing Date
    XML Representation: attribute
    Attributes:
    Default Value
    Date when the last invoice was created.

    **create Date when the last billing will occur.

  • exists
    • Date when the last billing occured.

  • echo
    • Date when the last billing occured used for filtering Subscription records.
    lastUpdateDate
    References: Payment Plan.Last Update Date
    XML Representation: attribute
    Attributes:
    Default Value
    Date when the payment plan was updated for the last time.

    **create Date when the last update was made to the Subscription.

  • exists
    • Date when the last update was made to the Subscription.

  • echo
    • Date when the last update was made to the Subscription used for filtering Subscription records.
    length
    References: Payment Plan.Length
    XML Representation: attribute
    Attributes: CreateOnly
    Default Value
    Time period when the payment plan is active.

    **create Number of times that a Subscription will generate an invoice.

  • exists
    • Number of times that a Subscription will generate an invoice.

  • echo
    • Number of times used for filtering records.
    nextBillingDate
    References: Billing Cycle.Next Billing Date
    XML Representation: attribute
    Attributes:
    Default Value
    Date when the next billing will occur.

    **create Date when the next billing will occur.

  • exists
    • Date when the next billing occured.

  • echo
    • Date used for filtering records.
    note
    References: Payment Plan.Note
    XML Representation: attribute
    Attributes:
    Default Value
    Pattern: TEXT
    Any additional notes related to the payment plan within the system.

    **create Any additional details associated with a Subscription.

  • exists
    • Any additional details associated with a Subscription.

  • echo
    • paymentOptionId
    Type: PaymentOption
    XML Representation: element
    Attributes: Required
    Default Value
    Reference to the entity that represents payment option used to collect money on the payment plan.

    **create Reference to a PaymentOption that a Subscription will be associated with.

  • exists
    • Reference to a PaymentOption that a Subscription is associated with.

  • echo
    • Reference to a PaymentOption used for filtering records.
    planId
    Type: Plan
    XML Representation: element
    Attributes:
    Default Value
  • create
    • Reference to a Plan that a Subscription will be associated with.
    Note: Reference to the Plan that the Customer is subscribing.


  • exists
    • Reference to a Plan that a Subscription is associated with.
    Note: Reference to the Plan that the Customer is subscribing.


  • echo
    • Reference to a Plan used for filtering Subscription records.
    planName
    Type: String
    XML Representation: attribute
    Attributes:
    Default Value
  • create
    • Name of the plan.

  • exists
    • Name of the plan.

  • echo
    • Name of the plan used for filtering records.
    status
    References: Payment Plan.Status CL
    XML Representation: attribute
    Attributes:
    Default Value U
    Represents current (or selected) status of the payment plan.



    **create Status of the record in the system. <div class="info legacy"> For more information see Payment Plan Status. </div>
  • exists
    • Status of the record in the system. <div class="info legacy"> For more information see Payment Plan Status. </div>
  • echo
    • Status of the record used for filtering Subscription records.
    type
    References: Payment Plan.Payment Plan CL
    XML Representation: attribute
    Attributes: CreateOnly
    Default Value P
    Enumeration of possible types of payment plans.

    **create Type of a Subscription that will be created.
    Note: If this value is set to F - Fixed, you must use the length field to specify the duration of the subscription.
    <div class="info legacy"> For more information see Payment Plan Classifier. </div>

  • exists
    • Type of a Subscription.
    Note: If this value is set to F - Fixed, you must use the length field to specify the duration of the subscription.
    <div class="info legacy"> For more information see Payment Plan Classifier. </div>

  • echo
    • Type of a Subscription used for filtering Subscription records.
    billingCycleType
    References: Plan.Billing Cycle Cl
    XML Representation: attribute
    Attributes:
    Default Value
    Reference to the entity that represents billing cycle associated with the plan.

    **create Type of billing cycle to be used. <div class="info legacy"> For more information see Billing Cycle Classifier. </div>
  • exists
    • Type of billing cycle used. <div class="info legacy"> For more information see Billing Cycle Classifier. </div>
  • echo
    • Type of a billing cycle used for filtering records.
    pendingAdjustmentType
    References: Payment Plan.Pending Adjustment Cl
    XML Representation: attribute
    Attributes:
    Default Value
  • create
    • Type of pending adjustment to be used.

  • exists
    • Type of a pending adjustment for the Subscription.

  • echo
    • Type of a pending adjustment for the Subscription used for filtering records.
    pendingAdjustmentEffectiveDate
    References: Payment Plan.Pending Adjustment Effective Date
    XML Representation: attribute
    Attributes:
    Default Value
  • create
    • Date when the pending adjustment for the Subscription will become effective.

  • exists
    • Date when the pending adjustment for the Subscription become effective.

  • echo
    • Date used for filtering Subscription records.
    pendingAdjustmentNote
    References: Payment Plan.Pending Adjustment Note
    XML Representation: attribute
    Attributes: Required
    Default Value
    Pattern: TEXT
  • create
    • Any additional details will be associated with the pending adjustment for the Subscription.

  • exists
    • Any additional details associated with the pending adjustment for the Subscription.

  • echo
    • Any additional details associated with the pending adjustment for the Subscription used for filtering Subscription records.
    pendingAdjustmentLength
    References: Payment Plan.Pending Adjustment Length
    XML Representation: attribute
    Attributes:
    Default Value
  • create
    • Number of times that the pending adjustment for the Subscription will generate an invoice.

  • exists
    • Number of times that the pending adjustment for the Subscription will generate an invoice.

  • echo
    • Number of times that the pending adjustment for the Subscription will generate an invoice used for filtering Subscription records.
    nextInvoicingDate
    Type: Date
    XML Representation: attribute
    Attributes:
    Default Value
  • create
    • Date when the invoicing will occur for the next time. <div class="info legacy"> For more information see integration notes. </div>
  • exists
    • Date when the invoicing will occur for the next time. <div class="info legacy"> For more information see integration notes. </div>
  • echo
    • Date when the invoicing will occur for the next time, used for filtering records.
    firstInvoicingDate
    Type: Date
    XML Representation: attribute
    Attributes:
    Default Value
  • create
    • Date when the invoicing will occur for the first time. <div class="info legacy"> For more information see integration notes. </div>
  • exists
    • Date when the invoicing will occur for the first time. <div class="info legacy"> For more information see integration notes. </div>
  • echo
    • Date when the invoicing will occur for the first time, used for filtering records.
    taxAmount
    References: Payment Plan.
    XML Representation: attribute
    Attributes:
    Default Value
  • create
    • Tax amount (in cents) that will be associated with the transaction processing.

  • exists
    • Tax amount (in cents) associated with the transaction processing.

  • echo
    • Tax amount used for filtering records.

    XML Sample:

    <subscription firstBillingDate="" >
    <paymentOptionId accountNumber=""  accountAccessory=""  holderName="" /> pendingAdjustmentNote="" 
</subscription>
    "<subscription firstBillingDate=\"\" > <paymentOptionId accountNumber=\"\" accountAccessory=\"\" holderName=\"\" /> pendingAdjustmentNote=\"\" </subscription>"

    JSON Sample:

    {
  "firstBillingDate": "",
  "paymentOptionId": {
    "accountNumber": "",
    "accountAccessory": "",
    "holderName": ""
  },
  "pendingAdjustmentNote": ""
}

    XURL Sample:

    ?firstBillingDate=&paymentOptionId.accountNumber=&paymentOptionId.accountAccessory=&paymentOptionId.holderName=&pendingAdjustmentNote=&
    firstBillingDate=
    paymentOptionId.accountNumber=
    paymentOptionId.accountAccessory=
    paymentOptionId.holderName=
    pendingAdjustmentNote=
    Copyright © United Thinkers. (UniPay - Payment Gateway Software)
    All Logos and Trademarks used or mentioned on this page are copyrighted property of their respective owners and are used for display purposes only.