FirmhouseSubscriptionWithUtils
Properties
activatedAt
null
| string
The date and time when the subscription was activated and billing started.
activePlan
Returns the plan the subscription is currently subscribed to.
address
null
| string
The customer's full address line or just street. Can include houseNumber if not separately stored in houseNumber field.
amountForStartingSubscriptionCents
null
| number
The amount that is due on checkout (in cents).
appliedPromotions?
List of all applied promotions for this customer.
billToAddress
null
| string
The customer's billing address address line or street.
billToCity
null
| string
The customer's billing address city or town.
billToCompanyName
null
| string
The company name of the customer's billing address.
billToCountry
null
| string
The customer's billing address country code (ISO3661).
billToDistrict
null
| string
The customer's billing address district.
billToFullAddress
null
| string
The customer's billing address full address by combining address and house number.
billToFullName
null
| string
The customer's billing address full name.
billToHouseNumber
null
| string
The customer's billing address house, building, or appartment number.
billToLastName
null
| string
The customer's billing address last name.
billToName
null
| string
The customer' billing address first name.
billToPhoneNumber
null
| string
The customer's billing address phone number (international format).
billToSalutation
null
| string
The customer's billing address salutation (mr,ms,mx).
billToState
null
| string
The customer's billing address state or province (ISO3661-2).
billToZipcode
null
| string
The customer's billing address zip code or postal code.
cancellationStartedAt
null
| string
The date and time when cancellation was initiated for the subscription (in case of two-step cancellation).
cancelledAt
null
| string
The date and time when the subscription was cancelled.
chargeDayOfTheMonth
null
| number
The day of the month when the customer is charged.
checkoutUrl
null
| string
URL for the customers to complete their draft subscription.
city
null
| string
The customer's city or town.
collectionCases?
List of collection cases for this customer
companyName
null
| string
The customer's company name.
country
null
| string
The customer's country code (ISO 3116)
createdAt
null
| string
The date and time when the subscription record was first created.
currency
null
| string
The currency used for this subscription
customerId
null
| string
The customer ID given by the selected payment provider
customerReference
null
| string
The field that can be used for your internal reference. For example, internal customer id.
dateOfBirth
null
| string
The customer's date of birth
differentBillingAddress
null
| boolean
Whether billing and shipping addresses are the same. Set this flag to true
to store a separate billing address.
district
null
| string
The customer's district
email
null
| string
The customer's email address
extraFields
List of extra fields and values.
fullAddress
null
| string
The customer's full address by combining address and house number.
fullName
null
| string
The customer's full name.
getClosestUpcomingOrderDate
() => null
| string
Utilty to check the closest upcoming order date
getClosestUpcomingOrderOrderedProducts
Utility to check the closest upcoming order ordered products
houseNumber
null
| string
The customer's house number.
id
null
| string
The id of the subscription.
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.
inTrialPeriod
boolean
Whether this subscription is currently in its trial period.
invoices?
List of invoices of this customer.
lastName
null
| string
The customer's last name.
locale
null
| string
The customer's locale/language.
markedAsNonPayingAt
null
| string
The date and time when the subscription was last marked as non-paying.
marketingOptIn
null
| boolean
Whether the customer accepted the optional marketing opt-in.
metadata
unknown
Metadata makes it possible to store additional information on objects.
monthlyAmountCents
null
| number
The monthly amount that is charged.
name
null
| string
The customer's first name.
notes
null
| string
Notes about the customer that can be set in the portal
ordersV2?
List of orders of this subscription
paidAmount
null
| number
The amount that is succesfully paid so far.
pausedAt
null
| string
The time the subscription was paused.
pausedUntil
null
| string
The time the subscription will be automatically resumed.
paymentMethod
null
| string
The payment method currently in use for billing
paymentMethodSummary
null
| string
The last 4 digits of the current payment method.
paymentMethodTranslated
null
| string
Localised string of the payment method currently in use for billing.
phoneNumber
null
| string
The customer's full international phone number
pspPaymentMethodDetails
unknown
The payment method details returned by PSP currently used for billing.
salutation
null
| string
The customer's salutation (mr,ms,mx).
signupCompletedAt
null
| string
The date and time when the subscription completed their signup and made their initial payment (or no payment if free).
skipAutoActivationOnSignup
boolean
If true then the subscription won't be activated after signup and initial payment.
startDate
string
The date and time when this subscription was (or will be) charged for the first time.
state
null
| string
The customer's state
status
Status of this customer.
stoppedAt
null
| string
The date and time when the subscription was automatically stopped.
subscribedPlan
Returns the plan relationship and contract terms of the current plan
termsAccepted
boolean
Whether the customer accepted the terms and conditions.
termsAcceptedOn
null
| string
Whether the customer has accepted the terms&conditions.
token
string
Unique token of the subscription
trialPeriodMonths
null
| number
The number of months before customer is charged for the first time.
updatePaymentMethodUrl
null
| string
Send your customer to this URL to allow them to update their active payment method.
updatedAt
null
| string
The date and time when the subscription was last updated.
vatNumber
null
| string
The company's VAT number.
verifiedIdentity?
Details of the verified identity if present.
zipcode
null
| string
The customer's postal code or zipcode.
Last updated