FirmhouseSubscriptionWithUtils
Properties
activatedAt
null
| string
The date and time when the subscription was activated and billing started.
FirmhouseSubscription
.activatedAt
activePlan
null
| FirmhousePlan
Returns the plan the subscription is currently subscribed to.
FirmhouseSubscription
.activePlan
address
null
| string
The customer's full address line or just street. Can include houseNumber if not separately stored in houseNumber field.
FirmhouseSubscription
.address
amountForStartingSubscriptionCents
null
| number
The amount that is due on checkout (in cents).
FirmhouseSubscription
.amountForStartingSubscriptionCents
appliedPromotions?
null
| FirmhouseAppliedPromotion
[]
List of all applied promotions for this customer.
FirmhouseSubscription
.appliedPromotions
billToAddress
null
| string
The customer's billing address address line or street.
FirmhouseSubscription
.billToAddress
billToCompanyName
null
| string
The company name of the customer's billing address.
FirmhouseSubscription
.billToCompanyName
billToCountry
null
| string
The customer's billing address country code (ISO3661).
FirmhouseSubscription
.billToCountry
billToDistrict
null
| string
The customer's billing address district.
FirmhouseSubscription
.billToDistrict
billToFullAddress
null
| string
The customer's billing address full address by combining address and house number.
FirmhouseSubscription
.billToFullAddress
billToFullName
null
| string
The customer's billing address full name.
FirmhouseSubscription
.billToFullName
billToHouseNumber
null
| string
The customer's billing address house, building, or appartment number.
FirmhouseSubscription
.billToHouseNumber
billToLastName
null
| string
The customer's billing address last name.
FirmhouseSubscription
.billToLastName
billToPhoneNumber
null
| string
The customer's billing address phone number (international format).
FirmhouseSubscription
.billToPhoneNumber
billToSalutation
null
| string
The customer's billing address salutation (mr,ms,mx).
FirmhouseSubscription
.billToSalutation
billToState
null
| string
The customer's billing address state or province (ISO3661-2).
FirmhouseSubscription
.billToState
billToZipcode
null
| string
The customer's billing address zip code or postal code.
FirmhouseSubscription
.billToZipcode
cancellationStartedAt
null
| string
The date and time when cancellation was initiated for the subscription (in case of two-step cancellation).
FirmhouseSubscription
.cancellationStartedAt
cancelledAt
null
| string
The date and time when the subscription was cancelled.
FirmhouseSubscription
.cancelledAt
chargeDayOfTheMonth
null
| number
The day of the month when the customer is charged.
FirmhouseSubscription
.chargeDayOfTheMonth
checkoutUrl
null
| string
URL for the customers to complete their draft subscription.
FirmhouseSubscription
.checkoutUrl
createdAt
null
| string
The date and time when the subscription record was first created.
FirmhouseSubscription
.createdAt
customerId
null
| string
The customer ID given by the selected payment provider
FirmhouseSubscription
.customerId
customerReference
null
| string
The field that can be used for your internal reference. For example, internal customer id.
FirmhouseSubscription
.customerReference
differentBillingAddress
null
| boolean
Whether billing and shipping addresses are the same. Set this flag to true
to store a separate billing address.
FirmhouseSubscription
.differentBillingAddress
fullAddress
null
| string
The customer's full address by combining address and house number.
FirmhouseSubscription
.fullAddress
getClosestUpcomingOrderDate
() => null
| string
Utilty to check the closest upcoming order date
FirmhouseSubscriptionUtils
.getClosestUpcomingOrderDate
getClosestUpcomingOrderOrderedProducts
() => FirmhouseOrderedProduct
[]
Utility to check the closest upcoming order ordered products
FirmhouseSubscriptionUtils
.getClosestUpcomingOrderOrderedProducts
identityVerificationUrl
null
| string
Identity verification URL that automatically uses the configured provider.Append ?return_url=https://your-url to send the customer back after a successful identification.
FirmhouseSubscription
.identityVerificationUrl
inTrialPeriod
boolean
Whether this subscription is currently in its trial period.
FirmhouseSubscription
.inTrialPeriod
markedAsNonPayingAt
null
| string
The date and time when the subscription was last marked as non-paying.
FirmhouseSubscription
.markedAsNonPayingAt
marketingOptIn
null
| boolean
Whether the customer accepted the optional marketing opt-in.
FirmhouseSubscription
.marketingOptIn
metadata
unknown
Metadata makes it possible to store additional information on objects.
FirmhouseSubscription
.metadata
monthlyAmountCents
null
| number
The monthly amount that is charged.
FirmhouseSubscription
.monthlyAmountCents
pausedUntil
null
| string
The time the subscription will be automatically resumed.
FirmhouseSubscription
.pausedUntil
paymentMethod
null
| string
The payment method currently in use for billing
FirmhouseSubscription
.paymentMethod
paymentMethodSummary
null
| string
The last 4 digits of the current payment method.
FirmhouseSubscription
.paymentMethodSummary
paymentMethodTranslated
null
| string
Localised string of the payment method currently in use for billing.
FirmhouseSubscription
.paymentMethodTranslated
phoneNumber
null
| string
The customer's full international phone number
FirmhouseSubscription
.phoneNumber
pspPaymentMethodDetails
unknown
The payment method details returned by PSP currently used for billing.
FirmhouseSubscription
.pspPaymentMethodDetails
signupCompletedAt
null
| string
The date and time when the subscription completed their signup and made their initial payment (or no payment if free).
FirmhouseSubscription
.signupCompletedAt
skipAutoActivationOnSignup
boolean
If true then the subscription won't be activated after signup and initial payment.
FirmhouseSubscription
.skipAutoActivationOnSignup
startDate
string
The date and time when this subscription was (or will be) charged for the first time.
FirmhouseSubscription
.startDate
stoppedAt
null
| string
The date and time when the subscription was automatically stopped.
FirmhouseSubscription
.stoppedAt
subscribedPlan
null
| FirmhouseSubscribedPlan
Returns the plan relationship and contract terms of the current plan
FirmhouseSubscription
.subscribedPlan
termsAccepted
boolean
Whether the customer accepted the terms and conditions.
FirmhouseSubscription
.termsAccepted
termsAcceptedOn
null
| string
Whether the customer has accepted the terms&conditions.
FirmhouseSubscription
.termsAcceptedOn
trialPeriodMonths
null
| number
The number of months before customer is charged for the first time.
FirmhouseSubscription
.trialPeriodMonths
updatePaymentMethodUrl
null
| string
Send your customer to this URL to allow them to update their active payment method.
FirmhouseSubscription
.updatePaymentMethodUrl
updatedAt
null
| string
The date and time when the subscription was last updated.
FirmhouseSubscription
.updatedAt
verifiedIdentity?
null
| FirmhouseVerifiedIdentity
Details of the verified identity if present.
FirmhouseSubscription
.verifiedIdentity
Last updated