fusebill-node-sdk
Javascript / node.js wrapper for the Fusebill API
Installing
npm install @fusebridge/fusebill-node
Instantiate client
import { Client as Fusebill } from '@fusebridge/fusebill-node'
export const fusebillClient = new Fusebill({
apiKey: 'abc',
checkLimit: false // (Optional) Specify whether to check the API limit on each call. Default: true
})
To change the base url:
export const fusebillClient = new Fusebill({ apiKey: YOUR_API_KEY, baseURL: 'https://some-url' })
Changing rate limiter options
Bottleneck is used for rate limiting. To override the default settings, pass a limiter
object when instantiating the client. Bottleneck options can be found here.
export const fusebillClient = new Fusebill({
apiKey: YOUR_API_KEY,
limiter: {
maxConcurrent: 2,
minTime: 1000 / 9,
}
})
Usage
All methods return a promise. The success case includes the returned object from the response. Use the API method via:
fusebill.catalog.plans
.list(options)
.then(results => {
console.log(results)
})
.catch(err => {
console.error(err)
})
Samples
Please see repository with samples applications with common cases.
API limits
Fusebill has API limits (180,000 per day by default). To prevent from consuming it all-at-once, this library checks API quotas regularly and will fail requests if the total is too close to the max. By default
Available Methods
Catalog
// plans
fusebill.catalog.plans.list(opts)
fusebill.catalog.plans.read(planId, opts)
// products
fusebill.catalog.products.summary(opts)
fusebill.catalog.products.list(opts)
fusebill.catalog.products.read(productId, opts)
// plan products
fusebill.catalog.planProducts.listByPlan(planId, opts)
fusebill.catalog.planProducts.listByCatalogProduct(productId, opts)
fusebill.catalog.planProducts.read(planProductId, opts)
fusebill.catalog.planProducts.patch(data)
// plan families
fusebill.catalog.planFamilies.list(opts)
fusebill.catalog.planFamilies.listByPlanId(planId, opts)
fusebill.catalog.planFamilies.read(planFamilyId, opts)
fusebill.catalog.planFamilies.readBySubscriptionId(subscriptionId, opts)
// discounts
fusebill.catalog.discounts.list(opts)
fusebill.catalog.discounts.read(discountId, opts)
// custom fields
fusebill.catalog.customFields.updateOnSubscription(data)
fusebill.catalog.customFields.updateOnSubscriptionProduct(data)
fusebill.catalog.customFields.updateOnPurchase(data)
Customers
// customer
fusebill.customers.customer.list(opts)
fusebill.customers.customer.readOverview(customerId, opts)
fusebill.customers.customer.read(customerId, opts)
fusebill.customers.customer.create(data)
fusebill.customers.customer.activate(data, opts)
fusebill.customers.customer.activateSubscriptionsAndPurchases(customerId, data, opts)
fusebill.customers.customer.hold(customerId, opts)
fusebill.customers.customer.unHold(data, opts)
fusebill.customers.customer.cancel(data, opts)
fusebill.customers.customer.unCancel(customerId, opts)
fusebill.customers.customer.update(data, opts)
fusebill.customers.customer.createNote(data, opts)
fusebill.customers.customer.deleteNote(noteId, opts)
// email
fusebill.customers.email.read(customerId, opts)
fusebill.customers.email.update(data, opts)
// billing
fusebill.customers.billing.read(customerId, opts)
fusebill.customers.billing.update(data, opts)
// address
fusebill.customers.address.read(customerId, opts)
fusebill.customers.address.update(data, opts)
// shippingBillingAddress
fusebill.customers.shippingBillingAddress.read(addressId, opts)
fusebill.customers.shippingBillingAddress.create(data, opts)
fusebill.customers.shippingBillingAddress.update(data, opts)
fusebill.customers.shippingBillingAddress.readCountries(opts)
Subscriptions
// subscription
fusebill.subscriptions.subscription.list(opts)
fusebill.subscriptions.subscription.listSummary(opts)
fusebill.subscriptions.subscription.listByCustomer(customerId, opts)
fusebill.subscriptions.subscription.read(subscriptionId, opts)
fusebill.subscriptions.subscription.create(data, opts)
fusebill.subscriptions.subscription.update(data)
fusebill.subscriptions.subscription.activate(subscriptionId, opts)
fusebill.subscriptions.subscription.activateMultiple(data, opts)
fusebill.subscriptions.subscription.provision(subscriptionId, opts)
fusebill.subscriptions.subscription.cancel(data, opts)
fusebill.subscriptions.subscription.delete(subscriptionId, opts)
fusebill.subscriptions.subscription.countByStatus(customerId, status, opts)
// products
fusebill.subscriptions.products.read(subscriptionProductId, opts)
fusebill.subscriptions.products.update(data, opts)
fusebill.subscriptions.products.updateQuantity(data, opts)
// productPrice
fusebill.subscriptions.productPrice.create(data, opts)
fusebill.subscriptions.productPrice.update(data, opts)
fusebill.subscriptions.productPrice.delete(subscriptionProductId, opts)
// billingPeriodDefinitions
fusebill.subscriptions.billingPeriodDefinitions.listByCustomer(customerId, opts)
fusebill.subscriptions.billingPeriodDefinitions.readBySubscriptionId(subscriptionId, opts)
fusebill.subscriptions.billingPeriodDefinitions.read(billingPeriodDefinitionId, opts)
fusebill.subscriptions.billingPeriodDefinitions.create(data, opts)
fusebill.subscriptions.billingPeriodDefinitions.preview(data, opts)
fusebill.subscriptions.billingPeriodDefinitions.update(data, opts)
fusebill.subscriptions.billingPeriodDefinitions.delete(billingPeriodDefinitionId, opts)
// coupons
fusebill.subscriptions.coupons.list(opts)
fusebill.subscriptions.coupons.read(couponId, opts)
fusebill.subscriptions.coupons.validate(data, opts)
fusebill.subscriptions.coupons.apply(data, opts)
fusebill.subscriptions.coupons.delete(subscriptionId, couponCode, deleteAllDiscounts, opts)
// migrations
fusebill.subscriptions.migrations.read(subscriptionId, opts)
fusebill.subscriptions.migrations.create(subscriptionId, data, opts)
fusebill.subscriptions.migrations.cancel(subscriptionId, opts)
Purchases
// purchase
fusebill.purchases.purchase.listByProduct(productId, opts)
fusebill.purchases.purchase.listByCustomer(customerId, opts)
fusebill.purchases.purchase.read(purchaseId, opts)
fusebill.purchases.purchase.createBulk(data, opts)
fusebill.purchases.purchase.create(data, opts)
fusebill.purchases.purchase.finalize(data, opts)
fusebill.purchases.purchase.split(data, opts)
fusebill.purchases.purchase.update(data)
fusebill.purchases.purchase.applyCoupon(data)
fusebill.purchases.purchase.deleteCoupon(purchaseId, couponCode, deleteAllDiscounts, opts)
fusebill.purchases.purchase.cancel(data, opts)
fusebill.purchases.purchase.deleteDraft(purchaseId, opts)
// discount
fusebill.purchases.discount.read(purchaseDiscountId, opts)
fusebill.purchases.discount.create(data, opts)
fusebill.purchases.discount.update(data, opts)
fusebill.purchases.discount.delete(purchaseDiscountId, opts)
Payments
// payment
fusebill.payments.payment.read(paymentId, opts)
fusebill.payments.payment.create(data, opts)
// activity
fusebill.payments.activity.listByCustomer(customerId, opts)
fusebill.payments.activity.list(opts)
fusebill.payments.activity.listChildActivityByCustomer(customerId, opts)
fusebill.payments.activity.read(paymentActivityId, opts)
fusebill.payments.activity.autoResolve(data, opts)
fusebill.payments.activity.manualResolve(data, opts)
// refund
fusebill.payments.refund.read(transactionId, opts)
fusebill.payments.refund.create(data, opts)
// method
fusebill.payments.method.listByCustomer(customerId, opts)
fusebill.payments.method.setCustomerDefault(paymentMethodId, customerId, opts)
// method.creditCard
fusebill.payments.method.creditCard.listByCustomer(customerId, opts)
fusebill.payments.method.creditCard.read(paymentMethodId, opts)
fusebill.payments.method.creditCard.create(data, opts)
fusebill.payments.method.creditCard.update(data, opts)
fusebill.payments.method.creditCard.delete(paymentMethodId, opts)
// method.ach
fusebill.payments.method.ach.listByCustomer(customerId, opts)
fusebill.payments.method.ach.read(paymentMethodId, opts)
fusebill.payments.method.ach.create(data, opts)
fusebill.payments.method.ach.update(data, opts)
fusebill.payments.method.ach.delete(paymentMethodId, opts)
// transactions
fusebill.payments.transaction.list(opts)
fusebill.payments.transaction.listByCustomer(customerId, opts)
// credit
fusebill.payments.credit.read(transactionId, opts)
fusebill.payments.credit.create(data, opts)
// debit
fusebill.payments.debit.read(transactionId, opts)
fusebill.payments.debit.create(data, opts)
// stripe
fusebill.payments.stripe.achTokenImport(data, opts)
fusebill.payments.stripe.creditCardTokenImport(data, opts)
fusebill.payments.stripe.connectAchTokenImport(data, opts)
fusebill.payments.stripe.connectCreditCardTokenImport(data, opts)
// paypal
fusebill.payments.paypal.create(data, opts)
fusebill.payments.paypal.delete(paymentMethodId, opts)
// braintree
fusebill.payments.braintree.cardTokenImport(data, opts)
Invoices
// invoice
fusebill.invoices.invoice.list(opts)
fusebill.invoices.invoice.listSummary(opts)
fusebill.invoices.invoice.listByCustomer(customerId, showZeroDollarCharges, opts)
fusebill.invoices.invoice.read(invoiceId, showTrackedItems, groupCharges, opts)
fusebill.invoices.invoice.readAsHtml(invoiceId, showTrackedItems, opts)
fusebill.invoices.invoice.readAsPdf(invoiceId, showTrackedItems, opts)
fusebill.invoices.invoice.listCreditAllocations(invoiceId, opts)
fusebill.invoices.invoice.listPaymentAllocations(invoiceId, opts)
fusebill.invoices.invoice.writeOff(data, opts)
Not wrapped endpoint(s)
It is possible to access the fusebill request method directly, it could be handy if wrapper doesn't have implementation for some endpoint yet. Using of exposed request method benefits by the bottleneck throttling, auth and request parsing and formatting already in place
Note: This library uses Axios for http calls.
fusebill.apiRequest({
method: 'PUT',
path: '/some/api/not/wrapped/yet',
data: { key: 'value' }
})
// qs is not part of axios and we use this for custom transformations on query
fusebill.apiRequest({
method: 'GET',
path: '/some/api/not/wrapped/yet',
qs: { query: { someKey: 'someValue'}, pageSize: 100}
})
Credits
Built and maintained by Clay Gorman