Skip to content
This repository was archived by the owner on Oct 17, 2023. It is now read-only.

Latest commit

 

History

History
32 lines (29 loc) · 7.34 KB

SubscriptionCharge.md

File metadata and controls

32 lines (29 loc) · 7.34 KB

Bfwd::SubscriptionCharge

Properties

Name Type Description Notes
created DateTime { "description" : "The UTC DateTime when the object was created.", "verbs":[] } [optional]
changed_by String { "description" : "ID of the user who last updated the entity.", "verbs":[] } [optional]
updated DateTime { "description" : "The UTC DateTime when the object was last updated.", "verbs":[] } [optional]
id String {"description":"The ID of the charge.","verbs":["GET"]} [optional]
crm_id String {"description":"Customer-relationship-management ID of the charge.","verbs":["GET","PUT","POST"]} [optional]
account_id String {"description":"ID of the account owning the subscription for which the charge was generated.","verbs":["GET","POST"]} [optional]
subscription_id String {"description":"ID of the subscription for which the charge was generated.","verbs":["GET","POST"]} [optional]
subscription_version_id String {"description":"Version ID of the subscription for which the charge was generated.","verbs":["GET","POST"]} [optional]
invoice_id String {"description":"ID of the invoice to which this charge applies (if the charge targets a specific invoice).","verbs":["POST","GET"]} [optional]
name String {"description":"Friendly name given to the charge to help identify it.","verbs":["POST","GET","PUT"]} [optional]
description String {"description":"Description given to the charge.","verbs":["POST","GET","PUT"]} [optional]
amount Float {"description":"Monetary amount of the charge — including any tax applied to the final amount.","verbs":["POST","GET"]} [optional]
amount_excluding_tax Float {"description":"Monetary amount of the charge — excluding any tax applied to the final amount.","verbs":["GET"]} [optional]
currency String { "description" : "Currency of the invoice specified by a three character ISO 4217 currency code.", "verbs":["GET"] } [optional]
period_start DateTime {"default":"(Now)","description":"The time-beginning of the interval to which the charge applies. This can be used to apply a charge across partial or multiple periods,to pro-rate its price.","verbs":["POST","GET"]} [optional]
period_end DateTime {"default":"(End of current period)","description":"The time-ending of the interval to which the charge applies. This can be used to apply a charge across partial or multiple periods,to pro-rate its price.","verbs":["POST","GET"]} [optional]
type String {"description":"A type describing the nature of the charge.","verbs":["POST","GET"]}
invoicing_type String {&quot;default&quot;:&quot;<span class=\&quot;label label-default\&quot;>Aggregated</span>&quot;,&quot;description&quot;:&quot;The strategy for how this charge will raise invoices.<br><span class=\&quot;label label-default\&quot;>Immediate</span> &mdash; Generate straight-away an invoice containing this charge.<br><span class=\&quot;label label-default\&quot;>Aggregated</span> &mdash; Add this charge to the next invoice which is generated naturally &mdash; i.e. the invoice raised at the current period's end.&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]}
state String {&quot;default&quot;:&quot;<span class=\&quot;label label-default\&quot;>Pending</span>&quot;,&quot;description&quot;:&quot;The current state of the charge.&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;,&quot;PUT&quot;]}
charge_type String {&quot;default&quot;:&quot;<span class=\&quot;label label-default\&quot;>Debit</span>&quot;,&quot;description&quot;:&quot;Whether this charge represents money given to or taken from the customer.<br><span class=\&quot;label label-default\&quot;>Credit</span> &mdash; This is a charge for money given to the customer.<br><span class=\&quot;label label-default\&quot;>Debit</span> &mdash; This is a charge for money taken from the customer.&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]}
calculation String {&quot;default&quot;:&quot;(Empty string)&quot;,&quot;description&quot;:&quot;A human-readable explanation of how the value of the charge was calculated.&quot;,&quot;verbs&quot;:[&quot;GET&quot;]} [optional]
remaining_credit_behaviour String {&quot;default&quot;:&quot;<span class=\&quot;label label-default\&quot;>Rollover</span>&quot;,&quot;description&quot;:&quot;Defines the behaviour applied to any outstanding credit resulting from the application of the charge..<br><span class=\&quot;label label-default\&quot;>Rollover</span> &mdash; Outstanding credit is returned to the accounts credit pool.<br><span class=\&quot;label label-default\&quot;>Discard</span> &mdash; Outstanding credit is lost.&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]}
trial BOOLEAN {&quot;default&quot;:&quot;false&quot;,&quot;description&quot;:&quot;(Applicable only if any of [`pricingComponentName`, `pricingComponentID`] are defined)<br>Whether the charge was created for a subscription whilst in a trial period.<br><span class=\&quot;label label-default\&quot;>false</span> &mdash; This is a non-trial charge, so funds will be sought from the customer.<br><span class=\&quot;label label-default\&quot;>true</span> &mdash; This is a trial charge, soThe charge can be considered 'Paid' without taking any funds from the customer.&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional] [default to false]
version_id String {&quot;description&quot;:&quot;The version ID of the charge.&quot;,&quot;verbs&quot;:[&quot;GET&quot;]} [optional]
version_number Integer {&quot;description&quot;:&quot;The version number of the charge. The first version of a charge is version number 1.&quot;,&quot;verbs&quot;:[&quot;GET&quot;]}