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

Latest commit

 

History

History
23 lines (20 loc) · 6.52 KB

AddChargeRequest.md

File metadata and controls

23 lines (20 loc) · 6.52 KB

Bfwd::AddChargeRequest

Properties

Name Type Description Notes
created DateTime { "description" : "The UTC DateTime when the object was created.", "verbs":[] } [optional]
id String {"description":"ID of an existing charge to add to the invoice ","verbs":["POST","GET"]} [optional]
name String {"description":"Friendly name given to the charge to help identify it.","verbs":["POST","GET"]} [optional]
description String {"description":"","verbs":["POST","GET"]} [optional]
currency String { "description" : "Currency of the invoice specified by a three character ISO 4217 currency code.", "verbs":["GET"] } [optional]
amount Float {"description":"Monetary amount for which to charge. Used only for ad-hoc charges i.e charges not associated with any pricing component. Applicable if pricingComponent is NOT defined","verbs":["POST","GET"]} [optional]
tax_amount BOOLEAN {&quot;default&quot;:false,&quot;description&quot;:&quot;Applicable if amount is specified and indicates whether or not to apply tax in addition to the value specified.<br><span class=\&quot;label label-default\&quot;>true</span> &mdash; Tax will be added on top of the nominal price specified in amount &mdash; in accordance with any taxation strategies you have defined.<br><span class=\&quot;label label-default\&quot;>false</span> &mdash; No tax will be applied on top of the price specified in amount.&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional] [default to false]
period_start DateTime {&quot;default&quot;:&quot;Now&quot;,&quot;description&quot;:&quot;Start of the interval to which the charge applies. This can be used to apply a charge across partial or multiple periods. Pro-rating the price of pricingComponents purchased&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional]
period_end DateTime {&quot;default&quot;:&quot;(End of current period)&quot;,&quot;description&quot;:&quot;(Applicable only if `pricingComponent` is defined)<br>End of the interval to which the charge applies. Used in pro-rata calculation&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional]
invoicing_type String {&quot;default&quot;:&quot;<span class=\&quot;label label-default\&quot;>Aggregated</span>&quot;,&quot;description&quot;:&quot;Applicable if adding a charge to the subscription.<br><span class=\&quot;label label-default\&quot;>Immediate</span> &mdash; Generate straight-away an invoice containing these charges.<br><span class=\&quot;label label-default\&quot;>Aggregated</span> &mdash; Add these charges to the next invoice &mdash; for example the invoice raised at the current period's end.&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional]
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 an increase or decrease in invoice cost<br><span class=\&quot;label label-default\&quot;>Credit</span> &mdash; This results in a reduction to the invoice cost<br><span class=\&quot;label label-default\&quot;>Debit</span> &mdash; This will increase the invoice cost&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional]
trial BOOLEAN {&quot;default&quot;:&quot;false&quot;,&quot;description&quot;:&quot;Whether the charge is meant in the context of a trial.<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]
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;]}
pricing_component String {&quot;description&quot;:&quot;Specifies that this charge is for consumption of some quantity of this pricing component (whose name or ID can be provided).<br>If left blank:<br>The charge will be created as 'ad-hoc'. That is: a monetary lump sum, associated with no pricing component&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional]
pricing_component_value Integer {&quot;description&quot;:&quot;The value consumed of the pricing component which this charge concerns.Required if pricingComponent is defined&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional]
dry_run BOOLEAN {&quot;default&quot;:false,&quot;description&quot;:&quot;Changes described in the response:<br><span class=\&quot;label label-default\&quot;>true</span> &mdash; Are not actually performed; your subscription remains unchanged, no billing events run, and no invoices are executed.<br><span class=\&quot;label label-default\&quot;>false</span> &mdash; Are actually performed and committed.&quot;,&quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;]} [optional] [default to false]