orb-billing 4.49.0 → 4.51.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +26 -0
- package/package.json +1 -1
- package/resources/alerts.d.ts +5 -8
- package/resources/alerts.d.ts.map +1 -1
- package/resources/alerts.js +2 -4
- package/resources/alerts.js.map +1 -1
- package/resources/alerts.mjs +2 -4
- package/resources/alerts.mjs.map +1 -1
- package/resources/coupons/coupons.d.ts +0 -34
- package/resources/coupons/coupons.d.ts.map +1 -1
- package/resources/coupons/coupons.js.map +1 -1
- package/resources/coupons/coupons.mjs.map +1 -1
- package/resources/coupons/subscriptions.d.ts +3 -3
- package/resources/credit-notes.d.ts +5 -5
- package/resources/credit-notes.js +3 -3
- package/resources/credit-notes.mjs +3 -3
- package/resources/customers/costs.d.ts +12 -454
- package/resources/customers/costs.d.ts.map +1 -1
- package/resources/customers/credits/ledger.d.ts +14 -14
- package/resources/customers/customers.d.ts +19 -19
- package/resources/customers/customers.d.ts.map +1 -1
- package/resources/customers/customers.js +14 -12
- package/resources/customers/customers.js.map +1 -1
- package/resources/customers/customers.mjs +14 -12
- package/resources/customers/customers.mjs.map +1 -1
- package/resources/events/backfills.d.ts +18 -18
- package/resources/events/backfills.js +3 -3
- package/resources/events/backfills.mjs +3 -3
- package/resources/events/events.d.ts +6 -7
- package/resources/events/events.d.ts.map +1 -1
- package/resources/events/events.js +3 -3
- package/resources/events/events.js.map +1 -1
- package/resources/events/events.mjs +3 -3
- package/resources/events/events.mjs.map +1 -1
- package/resources/events/volume.d.ts +5 -5
- package/resources/events/volume.js +5 -5
- package/resources/events/volume.mjs +5 -5
- package/resources/invoice-line-items.d.ts +2 -223
- package/resources/invoice-line-items.d.ts.map +1 -1
- package/resources/invoices.d.ts +14 -456
- package/resources/invoices.d.ts.map +1 -1
- package/resources/invoices.js +3 -3
- package/resources/invoices.js.map +1 -1
- package/resources/invoices.mjs +3 -3
- package/resources/invoices.mjs.map +1 -1
- package/resources/items.d.ts +1 -1
- package/resources/items.js +1 -1
- package/resources/items.mjs +1 -1
- package/resources/metrics.d.ts +6 -7
- package/resources/metrics.d.ts.map +1 -1
- package/resources/metrics.js +3 -4
- package/resources/metrics.js.map +1 -1
- package/resources/metrics.mjs +3 -4
- package/resources/metrics.mjs.map +1 -1
- package/resources/plans/external-plan-id.d.ts +6 -6
- package/resources/plans/external-plan-id.js +6 -6
- package/resources/plans/external-plan-id.mjs +6 -6
- package/resources/plans/plans.d.ts +15 -15
- package/resources/plans/plans.js +6 -6
- package/resources/plans/plans.mjs +6 -6
- package/resources/prices/external-price-id.d.ts +2 -2
- package/resources/prices/external-price-id.js +2 -2
- package/resources/prices/external-price-id.mjs +2 -2
- package/resources/prices/prices.d.ts +14 -235
- package/resources/prices/prices.d.ts.map +1 -1
- package/resources/prices/prices.js +7 -7
- package/resources/prices/prices.js.map +1 -1
- package/resources/prices/prices.mjs +7 -7
- package/resources/prices/prices.mjs.map +1 -1
- package/resources/subscriptions.d.ts +172 -2831
- package/resources/subscriptions.d.ts.map +1 -1
- package/resources/subscriptions.js +53 -49
- package/resources/subscriptions.js.map +1 -1
- package/resources/subscriptions.mjs +53 -49
- package/resources/subscriptions.mjs.map +1 -1
- package/src/resources/alerts.ts +5 -8
- package/src/resources/coupons/coupons.ts +0 -34
- package/src/resources/coupons/subscriptions.ts +3 -3
- package/src/resources/credit-notes.ts +5 -5
- package/src/resources/customers/costs.ts +12 -454
- package/src/resources/customers/credits/ledger.ts +14 -14
- package/src/resources/customers/customers.ts +19 -19
- package/src/resources/events/backfills.ts +18 -18
- package/src/resources/events/events.ts +6 -7
- package/src/resources/events/volume.ts +5 -5
- package/src/resources/invoice-line-items.ts +2 -223
- package/src/resources/invoices.ts +14 -456
- package/src/resources/items.ts +1 -1
- package/src/resources/metrics.ts +6 -7
- package/src/resources/plans/external-plan-id.ts +6 -6
- package/src/resources/plans/plans.ts +15 -15
- package/src/resources/prices/external-price-id.ts +2 -2
- package/src/resources/prices/prices.ts +14 -235
- package/src/resources/subscriptions.ts +172 -2831
- package/src/version.ts +1 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
- package/version.mjs +1 -1
|
@@ -5,8 +5,8 @@ export declare class Costs extends APIResource {
|
|
|
5
5
|
/**
|
|
6
6
|
* This endpoint is used to fetch a day-by-day snapshot of a customer's costs in
|
|
7
7
|
* Orb, calculated by applying pricing information to the underlying usage (see the
|
|
8
|
-
* [subscription usage endpoint](fetch-subscription-usage
|
|
9
|
-
* per metric, in usage units rather than a currency).
|
|
8
|
+
* [subscription usage endpoint](/api-reference/subscription/fetch-subscription-usage)
|
|
9
|
+
* to fetch usage per metric, in usage units rather than a currency).
|
|
10
10
|
*
|
|
11
11
|
* This endpoint can be leveraged for internal tooling and to provide a more
|
|
12
12
|
* transparent billing experience for your end users:
|
|
@@ -15,8 +15,8 @@ export declare class Costs extends APIResource {
|
|
|
15
15
|
* the current billing period.
|
|
16
16
|
* 2. Provide customer visibility into how different services are contributing to
|
|
17
17
|
* the overall invoice with a per-day timeseries (as compared to the
|
|
18
|
-
* [upcoming invoice](fetch-upcoming-invoice) resource,
|
|
19
|
-
* snapshot for the current period).
|
|
18
|
+
* [upcoming invoice](/api-reference/invoice/fetch-upcoming-invoice) resource,
|
|
19
|
+
* which represents a snapshot for the current period).
|
|
20
20
|
* 3. Assess how minimums and discounts affect your customers by teasing apart
|
|
21
21
|
* costs directly as a result of usage, as opposed to minimums and discounts at
|
|
22
22
|
* the plan and price level.
|
|
@@ -126,8 +126,8 @@ export declare class Costs extends APIResource {
|
|
|
126
126
|
/**
|
|
127
127
|
* This endpoint is used to fetch a day-by-day snapshot of a customer's costs in
|
|
128
128
|
* Orb, calculated by applying pricing information to the underlying usage (see the
|
|
129
|
-
* [subscription usage endpoint](fetch-subscription-usage
|
|
130
|
-
* per metric, in usage units rather than a currency).
|
|
129
|
+
* [subscription usage endpoint](/api-reference/subscription/fetch-subscription-usage)
|
|
130
|
+
* to fetch usage per metric, in usage units rather than a currency).
|
|
131
131
|
*
|
|
132
132
|
* This endpoint can be leveraged for internal tooling and to provide a more
|
|
133
133
|
* transparent billing experience for your end users:
|
|
@@ -136,8 +136,8 @@ export declare class Costs extends APIResource {
|
|
|
136
136
|
* the current billing period.
|
|
137
137
|
* 2. Provide customer visibility into how different services are contributing to
|
|
138
138
|
* the overall invoice with a per-day timeseries (as compared to the
|
|
139
|
-
* [upcoming invoice](fetch-upcoming-invoice) resource,
|
|
140
|
-
* snapshot for the current period).
|
|
139
|
+
* [upcoming invoice](/api-reference/invoice/fetch-upcoming-invoice) resource,
|
|
140
|
+
* which represents a snapshot for the current period).
|
|
141
141
|
* 3. Assess how minimums and discounts affect your customers by teasing apart
|
|
142
142
|
* costs directly as a result of usage, as opposed to minimums and discounts at
|
|
143
143
|
* the plan and price level.
|
|
@@ -273,229 +273,8 @@ export declare namespace CostListResponse {
|
|
|
273
273
|
* is serialized differently in a given Price object. The model_type field
|
|
274
274
|
* determines the key for the configuration object that is present.
|
|
275
275
|
*
|
|
276
|
-
*
|
|
277
|
-
*
|
|
278
|
-
* With unit pricing, each unit costs a fixed amount.
|
|
279
|
-
*
|
|
280
|
-
* ```json
|
|
281
|
-
* {
|
|
282
|
-
* ...
|
|
283
|
-
* "model_type": "unit",
|
|
284
|
-
* "unit_config": {
|
|
285
|
-
* "unit_amount": "0.50"
|
|
286
|
-
* }
|
|
287
|
-
* ...
|
|
288
|
-
* }
|
|
289
|
-
* ```
|
|
290
|
-
*
|
|
291
|
-
* ## Tiered pricing
|
|
292
|
-
*
|
|
293
|
-
* In tiered pricing, the cost of a given unit depends on the tier range that it
|
|
294
|
-
* falls into, where each tier range is defined by an upper and lower bound. For
|
|
295
|
-
* example, the first ten units may cost $0.50 each and all units thereafter may
|
|
296
|
-
* cost $0.10 each.
|
|
297
|
-
*
|
|
298
|
-
* ```json
|
|
299
|
-
* {
|
|
300
|
-
* ...
|
|
301
|
-
* "model_type": "tiered",
|
|
302
|
-
* "tiered_config": {
|
|
303
|
-
* "tiers": [
|
|
304
|
-
* {
|
|
305
|
-
* "first_unit": 1,
|
|
306
|
-
* "last_unit": 10,
|
|
307
|
-
* "unit_amount": "0.50"
|
|
308
|
-
* },
|
|
309
|
-
* {
|
|
310
|
-
* "first_unit": 11,
|
|
311
|
-
* "last_unit": null,
|
|
312
|
-
* "unit_amount": "0.10"
|
|
313
|
-
* }
|
|
314
|
-
* ]
|
|
315
|
-
* }
|
|
316
|
-
* ...
|
|
317
|
-
* ```
|
|
318
|
-
*
|
|
319
|
-
* ## Bulk pricing
|
|
320
|
-
*
|
|
321
|
-
* Bulk pricing applies when the number of units determine the cost of all units.
|
|
322
|
-
* For example, if you've bought less than 10 units, they may each be $0.50 for a
|
|
323
|
-
* total of $5.00. Once you've bought more than 10 units, all units may now be
|
|
324
|
-
* priced at $0.40 (i.e. 101 units total would be $40.40).
|
|
325
|
-
*
|
|
326
|
-
* ```json
|
|
327
|
-
* {
|
|
328
|
-
* ...
|
|
329
|
-
* "model_type": "bulk",
|
|
330
|
-
* "bulk_config": {
|
|
331
|
-
* "tiers": [
|
|
332
|
-
* {
|
|
333
|
-
* "maximum_units": 10,
|
|
334
|
-
* "unit_amount": "0.50"
|
|
335
|
-
* },
|
|
336
|
-
* {
|
|
337
|
-
* "maximum_units": 1000,
|
|
338
|
-
* "unit_amount": "0.40"
|
|
339
|
-
* }
|
|
340
|
-
* ]
|
|
341
|
-
* }
|
|
342
|
-
* ...
|
|
343
|
-
* }
|
|
344
|
-
* ```
|
|
345
|
-
*
|
|
346
|
-
* ## Package pricing
|
|
347
|
-
*
|
|
348
|
-
* Package pricing defines the size or granularity of a unit for billing purposes.
|
|
349
|
-
* For example, if the package size is set to 5, then 4 units will be billed as 5
|
|
350
|
-
* and 6 units will be billed at 10.
|
|
351
|
-
*
|
|
352
|
-
* ```json
|
|
353
|
-
* {
|
|
354
|
-
* ...
|
|
355
|
-
* "model_type": "package",
|
|
356
|
-
* "package_config": {
|
|
357
|
-
* "package_amount": "0.80",
|
|
358
|
-
* "package_size": 10
|
|
359
|
-
* }
|
|
360
|
-
* ...
|
|
361
|
-
* }
|
|
362
|
-
* ```
|
|
363
|
-
*
|
|
364
|
-
* ## BPS pricing
|
|
365
|
-
*
|
|
366
|
-
* BPS pricing specifies a per-event (e.g. per-payment) rate in one hundredth of a
|
|
367
|
-
* percent (the number of basis points to charge), as well as a cap per event to
|
|
368
|
-
* assess. For example, this would allow you to assess a fee of 0.25% on every
|
|
369
|
-
* payment you process, with a maximum charge of $25 per payment.
|
|
370
|
-
*
|
|
371
|
-
* ```json
|
|
372
|
-
* {
|
|
373
|
-
* ...
|
|
374
|
-
* "model_type": "bps",
|
|
375
|
-
* "bps_config": {
|
|
376
|
-
* "bps": 125,
|
|
377
|
-
* "per_unit_maximum": "11.00"
|
|
378
|
-
* }
|
|
379
|
-
* ...
|
|
380
|
-
* }
|
|
381
|
-
* ```
|
|
382
|
-
*
|
|
383
|
-
* ## Bulk BPS pricing
|
|
384
|
-
*
|
|
385
|
-
* Bulk BPS pricing specifies BPS parameters in a tiered manner, dependent on the
|
|
386
|
-
* total quantity across all events. Similar to bulk pricing, the BPS parameters of
|
|
387
|
-
* a given event depends on the tier range that the billing period falls into. Each
|
|
388
|
-
* tier range is defined by an upper bound. For example, after $1.5M of payment
|
|
389
|
-
* volume is reached, each individual payment may have a lower cap or a smaller
|
|
390
|
-
* take-rate.
|
|
391
|
-
*
|
|
392
|
-
* ```json
|
|
393
|
-
* ...
|
|
394
|
-
* "model_type": "bulk_bps",
|
|
395
|
-
* "bulk_bps_config": {
|
|
396
|
-
* "tiers": [
|
|
397
|
-
* {
|
|
398
|
-
* "maximum_amount": "1000000.00",
|
|
399
|
-
* "bps": 125,
|
|
400
|
-
* "per_unit_maximum": "19.00"
|
|
401
|
-
* },
|
|
402
|
-
* {
|
|
403
|
-
* "maximum_amount": null,
|
|
404
|
-
* "bps": 115,
|
|
405
|
-
* "per_unit_maximum": "4.00"
|
|
406
|
-
* }
|
|
407
|
-
* ]
|
|
408
|
-
* }
|
|
409
|
-
* ...
|
|
410
|
-
* }
|
|
411
|
-
* ```
|
|
412
|
-
*
|
|
413
|
-
* ## Tiered BPS pricing
|
|
414
|
-
*
|
|
415
|
-
* Tiered BPS pricing specifies BPS parameters in a graduated manner, where an
|
|
416
|
-
* event's applicable parameter is a function of its marginal addition to the
|
|
417
|
-
* period total. Similar to tiered pricing, the BPS parameters of a given event
|
|
418
|
-
* depends on the tier range that it falls into, where each tier range is defined
|
|
419
|
-
* by an upper and lower bound. For example, the first few payments may have a 0.8
|
|
420
|
-
* BPS take-rate and all payments after a specific volume may incur a take-rate of
|
|
421
|
-
* 0.5 BPS each.
|
|
422
|
-
*
|
|
423
|
-
* ```json
|
|
424
|
-
* ...
|
|
425
|
-
* "model_type": "tiered_bps",
|
|
426
|
-
* "tiered_bps_config": {
|
|
427
|
-
* "tiers": [
|
|
428
|
-
* {
|
|
429
|
-
* "minimum_amount": "0",
|
|
430
|
-
* "maximum_amount": "1000000.00",
|
|
431
|
-
* "bps": 125,
|
|
432
|
-
* "per_unit_maximum": "19.00"
|
|
433
|
-
* },
|
|
434
|
-
* {
|
|
435
|
-
* "minimum_amount": "1000000.00",
|
|
436
|
-
* "maximum_amount": null,
|
|
437
|
-
* "bps": 115,
|
|
438
|
-
* "per_unit_maximum": "4.00"
|
|
439
|
-
* }
|
|
440
|
-
* ]
|
|
441
|
-
* }
|
|
442
|
-
* ...
|
|
443
|
-
* }
|
|
444
|
-
* ```
|
|
445
|
-
*
|
|
446
|
-
* ## Matrix pricing
|
|
447
|
-
*
|
|
448
|
-
* Matrix pricing defines a set of unit prices in a one or two-dimensional matrix.
|
|
449
|
-
* `dimensions` defines the two event property values evaluated in this pricing
|
|
450
|
-
* model. In a one-dimensional matrix, the second value is `null`. Every
|
|
451
|
-
* configuration has a list of `matrix_values` which give the unit prices for
|
|
452
|
-
* specified property values. In a one-dimensional matrix, the matrix values will
|
|
453
|
-
* have `dimension_values` where the second value of the pair is null. If an event
|
|
454
|
-
* does not match any of the dimension values in the matrix, it will resort to the
|
|
455
|
-
* `default_unit_amount`.
|
|
456
|
-
*
|
|
457
|
-
* ```json
|
|
458
|
-
* {
|
|
459
|
-
* "model_type": "matrix"
|
|
460
|
-
* "matrix_config": {
|
|
461
|
-
* "default_unit_amount": "3.00",
|
|
462
|
-
* "dimensions": [
|
|
463
|
-
* "cluster_name",
|
|
464
|
-
* "region"
|
|
465
|
-
* ],
|
|
466
|
-
* "matrix_values": [
|
|
467
|
-
* {
|
|
468
|
-
* "dimension_values": [
|
|
469
|
-
* "alpha",
|
|
470
|
-
* "west"
|
|
471
|
-
* ],
|
|
472
|
-
* "unit_amount": "2.00"
|
|
473
|
-
* },
|
|
474
|
-
* ...
|
|
475
|
-
* ]
|
|
476
|
-
* }
|
|
477
|
-
* }
|
|
478
|
-
* ```
|
|
479
|
-
*
|
|
480
|
-
* ## Fixed fees
|
|
481
|
-
*
|
|
482
|
-
* Fixed fees are prices that are applied independent of usage quantities, and
|
|
483
|
-
* follow unit pricing. They also have an additional parameter
|
|
484
|
-
* `fixed_price_quantity`. If the Price represents a fixed cost, this represents
|
|
485
|
-
* the quantity of units applied.
|
|
486
|
-
*
|
|
487
|
-
* ```json
|
|
488
|
-
* {
|
|
489
|
-
* ...
|
|
490
|
-
* "id": "price_id",
|
|
491
|
-
* "model_type": "unit",
|
|
492
|
-
* "unit_config": {
|
|
493
|
-
* "unit_amount": "2.00"
|
|
494
|
-
* },
|
|
495
|
-
* "fixed_price_quantity": 3.0
|
|
496
|
-
* ...
|
|
497
|
-
* }
|
|
498
|
-
* ```
|
|
276
|
+
* For more on the types of prices, see
|
|
277
|
+
* [the core concepts documentation](/core-concepts#plan-and-price)
|
|
499
278
|
*/
|
|
500
279
|
price: PricesAPI.Price;
|
|
501
280
|
/**
|
|
@@ -541,229 +320,8 @@ export declare namespace CostListByExternalIDResponse {
|
|
|
541
320
|
* is serialized differently in a given Price object. The model_type field
|
|
542
321
|
* determines the key for the configuration object that is present.
|
|
543
322
|
*
|
|
544
|
-
*
|
|
545
|
-
*
|
|
546
|
-
* With unit pricing, each unit costs a fixed amount.
|
|
547
|
-
*
|
|
548
|
-
* ```json
|
|
549
|
-
* {
|
|
550
|
-
* ...
|
|
551
|
-
* "model_type": "unit",
|
|
552
|
-
* "unit_config": {
|
|
553
|
-
* "unit_amount": "0.50"
|
|
554
|
-
* }
|
|
555
|
-
* ...
|
|
556
|
-
* }
|
|
557
|
-
* ```
|
|
558
|
-
*
|
|
559
|
-
* ## Tiered pricing
|
|
560
|
-
*
|
|
561
|
-
* In tiered pricing, the cost of a given unit depends on the tier range that it
|
|
562
|
-
* falls into, where each tier range is defined by an upper and lower bound. For
|
|
563
|
-
* example, the first ten units may cost $0.50 each and all units thereafter may
|
|
564
|
-
* cost $0.10 each.
|
|
565
|
-
*
|
|
566
|
-
* ```json
|
|
567
|
-
* {
|
|
568
|
-
* ...
|
|
569
|
-
* "model_type": "tiered",
|
|
570
|
-
* "tiered_config": {
|
|
571
|
-
* "tiers": [
|
|
572
|
-
* {
|
|
573
|
-
* "first_unit": 1,
|
|
574
|
-
* "last_unit": 10,
|
|
575
|
-
* "unit_amount": "0.50"
|
|
576
|
-
* },
|
|
577
|
-
* {
|
|
578
|
-
* "first_unit": 11,
|
|
579
|
-
* "last_unit": null,
|
|
580
|
-
* "unit_amount": "0.10"
|
|
581
|
-
* }
|
|
582
|
-
* ]
|
|
583
|
-
* }
|
|
584
|
-
* ...
|
|
585
|
-
* ```
|
|
586
|
-
*
|
|
587
|
-
* ## Bulk pricing
|
|
588
|
-
*
|
|
589
|
-
* Bulk pricing applies when the number of units determine the cost of all units.
|
|
590
|
-
* For example, if you've bought less than 10 units, they may each be $0.50 for a
|
|
591
|
-
* total of $5.00. Once you've bought more than 10 units, all units may now be
|
|
592
|
-
* priced at $0.40 (i.e. 101 units total would be $40.40).
|
|
593
|
-
*
|
|
594
|
-
* ```json
|
|
595
|
-
* {
|
|
596
|
-
* ...
|
|
597
|
-
* "model_type": "bulk",
|
|
598
|
-
* "bulk_config": {
|
|
599
|
-
* "tiers": [
|
|
600
|
-
* {
|
|
601
|
-
* "maximum_units": 10,
|
|
602
|
-
* "unit_amount": "0.50"
|
|
603
|
-
* },
|
|
604
|
-
* {
|
|
605
|
-
* "maximum_units": 1000,
|
|
606
|
-
* "unit_amount": "0.40"
|
|
607
|
-
* }
|
|
608
|
-
* ]
|
|
609
|
-
* }
|
|
610
|
-
* ...
|
|
611
|
-
* }
|
|
612
|
-
* ```
|
|
613
|
-
*
|
|
614
|
-
* ## Package pricing
|
|
615
|
-
*
|
|
616
|
-
* Package pricing defines the size or granularity of a unit for billing purposes.
|
|
617
|
-
* For example, if the package size is set to 5, then 4 units will be billed as 5
|
|
618
|
-
* and 6 units will be billed at 10.
|
|
619
|
-
*
|
|
620
|
-
* ```json
|
|
621
|
-
* {
|
|
622
|
-
* ...
|
|
623
|
-
* "model_type": "package",
|
|
624
|
-
* "package_config": {
|
|
625
|
-
* "package_amount": "0.80",
|
|
626
|
-
* "package_size": 10
|
|
627
|
-
* }
|
|
628
|
-
* ...
|
|
629
|
-
* }
|
|
630
|
-
* ```
|
|
631
|
-
*
|
|
632
|
-
* ## BPS pricing
|
|
633
|
-
*
|
|
634
|
-
* BPS pricing specifies a per-event (e.g. per-payment) rate in one hundredth of a
|
|
635
|
-
* percent (the number of basis points to charge), as well as a cap per event to
|
|
636
|
-
* assess. For example, this would allow you to assess a fee of 0.25% on every
|
|
637
|
-
* payment you process, with a maximum charge of $25 per payment.
|
|
638
|
-
*
|
|
639
|
-
* ```json
|
|
640
|
-
* {
|
|
641
|
-
* ...
|
|
642
|
-
* "model_type": "bps",
|
|
643
|
-
* "bps_config": {
|
|
644
|
-
* "bps": 125,
|
|
645
|
-
* "per_unit_maximum": "11.00"
|
|
646
|
-
* }
|
|
647
|
-
* ...
|
|
648
|
-
* }
|
|
649
|
-
* ```
|
|
650
|
-
*
|
|
651
|
-
* ## Bulk BPS pricing
|
|
652
|
-
*
|
|
653
|
-
* Bulk BPS pricing specifies BPS parameters in a tiered manner, dependent on the
|
|
654
|
-
* total quantity across all events. Similar to bulk pricing, the BPS parameters of
|
|
655
|
-
* a given event depends on the tier range that the billing period falls into. Each
|
|
656
|
-
* tier range is defined by an upper bound. For example, after $1.5M of payment
|
|
657
|
-
* volume is reached, each individual payment may have a lower cap or a smaller
|
|
658
|
-
* take-rate.
|
|
659
|
-
*
|
|
660
|
-
* ```json
|
|
661
|
-
* ...
|
|
662
|
-
* "model_type": "bulk_bps",
|
|
663
|
-
* "bulk_bps_config": {
|
|
664
|
-
* "tiers": [
|
|
665
|
-
* {
|
|
666
|
-
* "maximum_amount": "1000000.00",
|
|
667
|
-
* "bps": 125,
|
|
668
|
-
* "per_unit_maximum": "19.00"
|
|
669
|
-
* },
|
|
670
|
-
* {
|
|
671
|
-
* "maximum_amount": null,
|
|
672
|
-
* "bps": 115,
|
|
673
|
-
* "per_unit_maximum": "4.00"
|
|
674
|
-
* }
|
|
675
|
-
* ]
|
|
676
|
-
* }
|
|
677
|
-
* ...
|
|
678
|
-
* }
|
|
679
|
-
* ```
|
|
680
|
-
*
|
|
681
|
-
* ## Tiered BPS pricing
|
|
682
|
-
*
|
|
683
|
-
* Tiered BPS pricing specifies BPS parameters in a graduated manner, where an
|
|
684
|
-
* event's applicable parameter is a function of its marginal addition to the
|
|
685
|
-
* period total. Similar to tiered pricing, the BPS parameters of a given event
|
|
686
|
-
* depends on the tier range that it falls into, where each tier range is defined
|
|
687
|
-
* by an upper and lower bound. For example, the first few payments may have a 0.8
|
|
688
|
-
* BPS take-rate and all payments after a specific volume may incur a take-rate of
|
|
689
|
-
* 0.5 BPS each.
|
|
690
|
-
*
|
|
691
|
-
* ```json
|
|
692
|
-
* ...
|
|
693
|
-
* "model_type": "tiered_bps",
|
|
694
|
-
* "tiered_bps_config": {
|
|
695
|
-
* "tiers": [
|
|
696
|
-
* {
|
|
697
|
-
* "minimum_amount": "0",
|
|
698
|
-
* "maximum_amount": "1000000.00",
|
|
699
|
-
* "bps": 125,
|
|
700
|
-
* "per_unit_maximum": "19.00"
|
|
701
|
-
* },
|
|
702
|
-
* {
|
|
703
|
-
* "minimum_amount": "1000000.00",
|
|
704
|
-
* "maximum_amount": null,
|
|
705
|
-
* "bps": 115,
|
|
706
|
-
* "per_unit_maximum": "4.00"
|
|
707
|
-
* }
|
|
708
|
-
* ]
|
|
709
|
-
* }
|
|
710
|
-
* ...
|
|
711
|
-
* }
|
|
712
|
-
* ```
|
|
713
|
-
*
|
|
714
|
-
* ## Matrix pricing
|
|
715
|
-
*
|
|
716
|
-
* Matrix pricing defines a set of unit prices in a one or two-dimensional matrix.
|
|
717
|
-
* `dimensions` defines the two event property values evaluated in this pricing
|
|
718
|
-
* model. In a one-dimensional matrix, the second value is `null`. Every
|
|
719
|
-
* configuration has a list of `matrix_values` which give the unit prices for
|
|
720
|
-
* specified property values. In a one-dimensional matrix, the matrix values will
|
|
721
|
-
* have `dimension_values` where the second value of the pair is null. If an event
|
|
722
|
-
* does not match any of the dimension values in the matrix, it will resort to the
|
|
723
|
-
* `default_unit_amount`.
|
|
724
|
-
*
|
|
725
|
-
* ```json
|
|
726
|
-
* {
|
|
727
|
-
* "model_type": "matrix"
|
|
728
|
-
* "matrix_config": {
|
|
729
|
-
* "default_unit_amount": "3.00",
|
|
730
|
-
* "dimensions": [
|
|
731
|
-
* "cluster_name",
|
|
732
|
-
* "region"
|
|
733
|
-
* ],
|
|
734
|
-
* "matrix_values": [
|
|
735
|
-
* {
|
|
736
|
-
* "dimension_values": [
|
|
737
|
-
* "alpha",
|
|
738
|
-
* "west"
|
|
739
|
-
* ],
|
|
740
|
-
* "unit_amount": "2.00"
|
|
741
|
-
* },
|
|
742
|
-
* ...
|
|
743
|
-
* ]
|
|
744
|
-
* }
|
|
745
|
-
* }
|
|
746
|
-
* ```
|
|
747
|
-
*
|
|
748
|
-
* ## Fixed fees
|
|
749
|
-
*
|
|
750
|
-
* Fixed fees are prices that are applied independent of usage quantities, and
|
|
751
|
-
* follow unit pricing. They also have an additional parameter
|
|
752
|
-
* `fixed_price_quantity`. If the Price represents a fixed cost, this represents
|
|
753
|
-
* the quantity of units applied.
|
|
754
|
-
*
|
|
755
|
-
* ```json
|
|
756
|
-
* {
|
|
757
|
-
* ...
|
|
758
|
-
* "id": "price_id",
|
|
759
|
-
* "model_type": "unit",
|
|
760
|
-
* "unit_config": {
|
|
761
|
-
* "unit_amount": "2.00"
|
|
762
|
-
* },
|
|
763
|
-
* "fixed_price_quantity": 3.0
|
|
764
|
-
* ...
|
|
765
|
-
* }
|
|
766
|
-
* ```
|
|
323
|
+
* For more on the types of prices, see
|
|
324
|
+
* [the core concepts documentation](/core-concepts#plan-and-price)
|
|
767
325
|
*/
|
|
768
326
|
price: PricesAPI.Price;
|
|
769
327
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"costs.d.ts","sourceRoot":"","sources":["../../src/resources/customers/costs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsHG;IACH,IAAI,CACF,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAC5B,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;IACpC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;IAY1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsHG;IACH,gBAAgB,CACd,kBAAkB,EAAE,MAAM,EAC1B,KAAK,CAAC,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAC5B,IAAI,CAAC,UAAU,CAAC,4BAA4B,CAAC;IAChD,gBAAgB,CACd,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAC5B,IAAI,CAAC,UAAU,CAAC,4BAA4B,CAAC;CAcjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,yBAAiB,gBAAgB,CAAC;IAChC,UAAiB,IAAI;QACnB,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE1C;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB,aAAa,EAAE,MAAM,CAAC;QAEtB,eAAe,EAAE,MAAM,CAAC;QAExB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,YAAY;YAC3B
|
|
1
|
+
{"version":3,"file":"costs.d.ts","sourceRoot":"","sources":["../../src/resources/customers/costs.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,11 +5,11 @@ export declare class Ledger extends APIResource {
|
|
|
5
5
|
/**
|
|
6
6
|
* The credits ledger provides _auditing_ functionality over Orb's credits system
|
|
7
7
|
* with a list of actions that have taken place to modify a customer's credit
|
|
8
|
-
* balance. This [paginated endpoint](
|
|
9
|
-
* starting from the most recent ledger entry.
|
|
8
|
+
* balance. This [paginated endpoint](/api-reference/pagination) lists these
|
|
9
|
+
* entries, starting from the most recent ledger entry.
|
|
10
10
|
*
|
|
11
11
|
* More details on using Orb's real-time credit feature are
|
|
12
|
-
* [here](
|
|
12
|
+
* [here](/product-catalog/prepurchase).
|
|
13
13
|
*
|
|
14
14
|
* There are four major types of modifications to credit balance, detailed below.
|
|
15
15
|
*
|
|
@@ -316,11 +316,11 @@ export declare class Ledger extends APIResource {
|
|
|
316
316
|
/**
|
|
317
317
|
* The credits ledger provides _auditing_ functionality over Orb's credits system
|
|
318
318
|
* with a list of actions that have taken place to modify a customer's credit
|
|
319
|
-
* balance. This [paginated endpoint](
|
|
320
|
-
* starting from the most recent ledger entry.
|
|
319
|
+
* balance. This [paginated endpoint](/api-reference/pagination) lists these
|
|
320
|
+
* entries, starting from the most recent ledger entry.
|
|
321
321
|
*
|
|
322
322
|
* More details on using Orb's real-time credit feature are
|
|
323
|
-
* [here](
|
|
323
|
+
* [here](/product-catalog/prepurchase).
|
|
324
324
|
*
|
|
325
325
|
* There are four major types of modifications to credit balance, detailed below.
|
|
326
326
|
*
|
|
@@ -404,8 +404,8 @@ export declare class LedgerListResponsesPage extends Page<LedgerListResponse> {
|
|
|
404
404
|
export declare class LedgerListByExternalIDResponsesPage extends Page<LedgerListByExternalIDResponse> {
|
|
405
405
|
}
|
|
406
406
|
/**
|
|
407
|
-
* The [Credit Ledger Entry resource](/
|
|
408
|
-
*
|
|
407
|
+
* The [Credit Ledger Entry resource](/product-catalog/prepurchase) models prepaid
|
|
408
|
+
* credits within Orb.
|
|
409
409
|
*/
|
|
410
410
|
export type LedgerListResponse = LedgerListResponse.IncrementLedgerEntry | LedgerListResponse.DecrementLedgerEntry | LedgerListResponse.ExpirationChangeLedgerEntry | LedgerListResponse.CreditBlockExpiryLedgerEntry | LedgerListResponse.VoidLedgerEntry | LedgerListResponse.VoidInitiatedLedgerEntry | LedgerListResponse.AmendmentLedgerEntry;
|
|
411
411
|
export declare namespace LedgerListResponse {
|
|
@@ -644,8 +644,8 @@ export declare namespace LedgerListResponse {
|
|
|
644
644
|
}
|
|
645
645
|
}
|
|
646
646
|
/**
|
|
647
|
-
* The [Credit Ledger Entry resource](/
|
|
648
|
-
*
|
|
647
|
+
* The [Credit Ledger Entry resource](/product-catalog/prepurchase) models prepaid
|
|
648
|
+
* credits within Orb.
|
|
649
649
|
*/
|
|
650
650
|
export type LedgerCreateEntryResponse = LedgerCreateEntryResponse.IncrementLedgerEntry | LedgerCreateEntryResponse.DecrementLedgerEntry | LedgerCreateEntryResponse.ExpirationChangeLedgerEntry | LedgerCreateEntryResponse.CreditBlockExpiryLedgerEntry | LedgerCreateEntryResponse.VoidLedgerEntry | LedgerCreateEntryResponse.VoidInitiatedLedgerEntry | LedgerCreateEntryResponse.AmendmentLedgerEntry;
|
|
651
651
|
export declare namespace LedgerCreateEntryResponse {
|
|
@@ -884,8 +884,8 @@ export declare namespace LedgerCreateEntryResponse {
|
|
|
884
884
|
}
|
|
885
885
|
}
|
|
886
886
|
/**
|
|
887
|
-
* The [Credit Ledger Entry resource](/
|
|
888
|
-
*
|
|
887
|
+
* The [Credit Ledger Entry resource](/product-catalog/prepurchase) models prepaid
|
|
888
|
+
* credits within Orb.
|
|
889
889
|
*/
|
|
890
890
|
export type LedgerCreateEntryByExternalIDResponse = LedgerCreateEntryByExternalIDResponse.IncrementLedgerEntry | LedgerCreateEntryByExternalIDResponse.DecrementLedgerEntry | LedgerCreateEntryByExternalIDResponse.ExpirationChangeLedgerEntry | LedgerCreateEntryByExternalIDResponse.CreditBlockExpiryLedgerEntry | LedgerCreateEntryByExternalIDResponse.VoidLedgerEntry | LedgerCreateEntryByExternalIDResponse.VoidInitiatedLedgerEntry | LedgerCreateEntryByExternalIDResponse.AmendmentLedgerEntry;
|
|
891
891
|
export declare namespace LedgerCreateEntryByExternalIDResponse {
|
|
@@ -1124,8 +1124,8 @@ export declare namespace LedgerCreateEntryByExternalIDResponse {
|
|
|
1124
1124
|
}
|
|
1125
1125
|
}
|
|
1126
1126
|
/**
|
|
1127
|
-
* The [Credit Ledger Entry resource](/
|
|
1128
|
-
*
|
|
1127
|
+
* The [Credit Ledger Entry resource](/product-catalog/prepurchase) models prepaid
|
|
1128
|
+
* credits within Orb.
|
|
1129
1129
|
*/
|
|
1130
1130
|
export type LedgerListByExternalIDResponse = LedgerListByExternalIDResponse.IncrementLedgerEntry | LedgerListByExternalIDResponse.DecrementLedgerEntry | LedgerListByExternalIDResponse.ExpirationChangeLedgerEntry | LedgerListByExternalIDResponse.CreditBlockExpiryLedgerEntry | LedgerListByExternalIDResponse.VoidLedgerEntry | LedgerListByExternalIDResponse.VoidInitiatedLedgerEntry | LedgerListByExternalIDResponse.AmendmentLedgerEntry;
|
|
1131
1131
|
export declare namespace LedgerListByExternalIDResponse {
|