HubSpot's payments and subscriptions properties

When a buyer makes a payment, HubSpot stores details about the payment in specific properties in the payment record. If a subscription record is created, HubSpot will also store details about it in a subscription record..

This article lists the payment and subscription properties available in HubSpot. To manage payments and use the subscriptions tool:

• Learn how to manage payments.
• Learn how to set up the subscriptions tool.
• Learn how to create subscriptions to collect regular payments from buyers.
• Learn how to manage subscriptions billed in HubSpot.

Payment properties

You can use payment properties in segments, workflows, and custom reports.

• Amount paid: the total amount collected from the customer after refunds.
• Amount paid in company currency: the total amount collected from the customer after refunds, in the account company currency.
• Associated records: other records the payment is associated with. For example, a payment could be associated with a subscription.
• Bank or issuer: the name of the bank or card issuer that the buyer used to make a payment.
• Billing address: the buyer's billing address, city, state, zip code, and country.
• Billing address city: the buyer's billing city.
• Billing address country: the buyer's billing country.
• Billing address line 1: the first line of the buyer's billing address.
• Billing address line 2: the second line of the buyer's billing address. This is an optional field.
• Billing address state: the buyer's billing state.
• Billing address zip: the buyer's billing zip code.
• Billing name: the buyer's billing name.
• Charged from stored payment method: whether the payment was charged using a stored payment method.
• Created by user ID: the user who created the payment, set automatically by HubSpot.
• Currency code: the currency code for the payment.
• Customer email: the email address of the buyer who made the payment.
• Digital wallet type: the digital wallet used for the payment (e.g., Apple Pay, Google Pay).
• Dispute amount: the amount being disputed for a payment dispute.
• Dispute closed date: the date a payment dispute was closed.
• Dispute create date: the date a payment dispute was created.
• Dispute deadline: the deadline for a payment dispute decision.
• Dispute reason: the reason for a payment dispute.
• Disputed (action required): a payment dispute has been opened and needs to be countered or accepted.
• Disputed (awaiting decision): a payment dispute has been countered and is awaiting the bank's decision.
• Disputed (lost): the bank ruled in the buyer's favor for a payment dispute.
• Disputed (won): the bank ruled in the merchant's favor for a payment dispute.
• Estimated payout date: the estimated date payment funds will be deposited into the connected bank account.
• External payment method: the method the buyer used to make an external payment.
• External Reference ID: the external payment ID in the payment processing account associated with the payment.
• Gross amount: the total amount the customer was charged.
• Gross amount in company currency: the total amount the customer was charged in the account company currency.
• Gross amount in settlement currency: the total amount the customer was charged in the settlement currency.
• Internal comment: an internal note or comment made by a user when a payment is made from an invoice.
• Last four digits: the last four digits of the bank account or card used to pay.
• Line item discount amount: the line item discount amount.
• Line item discount amount in company currency: the line item discount amount in the account company currency.
• Max refundable amount in company currency: the maximum amount that can be refunded in the account company currency.
• Net amount: the total amount collected after fees and refunds. It's possible for this amount to be negative if you refund the payment, as fees aren't returned.
• Net amount after refunds: the total amount collected after fees and refunds. It's possible for this amount to be negative if you refund the payment, since fees aren't returned.
• Net amount in company currency: the total amount collected after fees and refunds, in the account's company currency. It's possible for this amount to be negative if you refund the payment, since fees aren't returned.
• Net amount in settlement currency: the total amount collected after fees in the settlement currency.
• Next automated collection attempt: the next date an automated collection attempt will be made for a failed payment.
• Object create date/time: the date and time at which this record was created, automatically set by HubSpot. This value can't be modified.
• Object ID: the unique HubSpot record ID generated for each payment, automatically set by HubSpot. This value can't be modified.
• Object last modified date/time: most recent timestamp of any property update for this record, including HubSpot internal properties, which can be visible or hidden. This property is updated automatically.
• Order discount amount: the discount amount on the total order.
• Order discount amount in company currency: the discount amount on the total order, in the account company currency.
• Order discount code: the discount code used on the order.
• Order discount percentage: the discount percentage on the order.
• Owner: the HubSpot owner of the payment record.
• Owner assigned date: the most recent timestamp of when an owner was assigned to the payment. Set automatically by HubSpot.
• Owner's main team: the main team of the owner of the payment. Set automatically by HubSpot.
• Payment date: the date the customer submitted the payment, or was charged by HubSpot for a recurring payment.
• Payment ID: the unique payment ID generated for your billing records and receipts, automatically set by HubSpot. This value can't be modified.
• Payment method: the method of payment (e.g., credit card, ACH).
• Payment source name: the object or tool that created the payment.
• Payment type: the line item types on the payment, either one-time or recurring.
• Payout date: the date a bank deposit associated with the payment payout was made.
• Platform fee: the total fees charged for the payment. View account rates in the payments account settings overview.
• Platform fee in company currency: the total fees charged for the payment in the account company currency. View account rates in the payments account settings overview.
• Platform fee in settlement currency: the total fees charged for the payment in the settlement currency. View account rates in the payments account settings overview.
• Presentment to portal currency dated exchange rate: the exchange rate between the presentment currency and the account company currency at the time of payment creation.
• Presentment to settlement currency exchange rate: the exchange rate between the presentment currency and the settlement currency at the time of payment creation, if applicable.
• Processing fees: the total amount charged to process the payment. View account rates in the payments account settings overview.
• Processing fees amount in company currency: the total amount charged to process the payment in the account company currency. View account rates in the payments account settings overview.
• Processing fees amount in settlement currency: the total amount charged to process the payment in the settlement currency. View account rates in the payments account settings overview.
• Processor: the payment processing option used to collect payment.
• Record ID: the unique HubSpot record ID generated for each payment, automatically set by HubSpot. This value can't be changed.
• Record Source: how the record was created.
• Record Source Detail 1: first level of detail on how the record was created.
• Record Source Detail 2: second level of detail on how the record was created.
• Record Source Detail 3: third level of detail on how the record was created.
• Reference number: the reference number associated with the external payment.
• Refund reason: the reason for a refund. Add custom refund reasons to reflect your internal processes.
• Refunded: the total amount refunded to the customer.
• Refunded amount: the total amount refunded to the customer.
• Refunded amount in company currency: the total amount refunded to the customer in the account company currency.
• Refunded amount in settlement currency: the total amount refunded to the customer in the settlement currency.
• Remaining manual collection attempts: the number of manual collection attempts remaining for this payment. This decreases by one with each manual collection attempt.
• Settlement currency code: the settlement currency code.
• Shipping address: the street address, city, state, zip code, and country where the buyer will receive the goods they purchased.
• Shipping address city: the city where the buyer will receive the goods they purchased.
• Shipping address country: the country where the buyer will receive the goods they purchased.
• Shipping address line 1: the street address where the buyer will receive the goods they purchased.
• Shipping address line 2: the apartment, unit number, or building where the buyer will receive the goods they purchased. This is an optional field.
• Shipping address state: the state where the buyer will receive the goods they purchased.
• Shipping address zip: the zip code where the buyer will receive the goods they purchased.
• Shipping name: the buyer's shipping name.
• Source: the object, tool, or integration that created the payment.
• Source ID: the unique ID for the object, tool, or integration that created the payment.
• Source URL: the URL for the object, tool, or integration that created the payment.
• Status: the status of the payment. Learn more about status values.
• Status updated on: the last time the status of the payment was updated.
• Total discount amount: total discounts applied to a payment, including line-item and order discounts.
• Total discount amount in company currency: total discounts applied to a payment, including line-item and order discounts, in the account company currency.
• Total Fees: sum of all collected fees in a single payment. Includes fees configured in settings, and one-time fees added to the line item subtotal. One-time fees can be added to credit memos, invoices, payment links, and legacy quotes.
• Total fees in company currency: sum of all collected fees in a single payment in the account company currency. Includes fees configured in settings, and one-time fees added to the line item subtotal. One-time fees can be added to credit memos, invoices, payment links, and legacy quotes.
• Total Taxes: total taxes applied to a payment.
• Total taxes in company currency: total taxes applied to a payment, in the account company currency.
• Updated by user ID: the user who last updated the payment, automatically set by HubSpot.

Subscription properties

You can use subscription properties in segments, workflows, and custom reports.

• Address types to collect: the address types (billing and shipping) collected when the customer pays the invoice.
• Allowed payment methods: the payment methods that can be used to pay the subscription invoice.
• Annual recurring revenue: the annual recurring revenue of the subscription.
• Annual recurring revenue in company currency: the annual recurring revenue of the subscription, in the account company currency.
• Associated records: records the subscription is associated with. For example, a subscription could be associated with a payment.
• Automated sales taxes enabled: whether automated sales tax is turned on for the subscription.
• Automatically email invoices: whether recurring invoices are automatically emailed to the customer on each billing date.
• Brands: the Brands the subscription is assigned to.
• Churn date: when the subscription status has changed to Inactive or Unpaid.
• Collection process: the payment collection process for the subscription (e.g., automatic, manual).
• Contact email: the email address of the contact associated with the subscription. This is the primary email address used for subscription related emails.
• Created by user ID: the user who created the subscription, automatically set by HubSpot.
• Currency code: the currency code of the subscription.
• End date: the date the subscription will end.
• Invoice Comments: comments shown to the invoice recipient.
• Invoice Creation: whether the subscription is invoiced through HubSpot Commerce Hub.
• Language: the language of the invoice.
• Last modification reason: reason for the last subscription modification.
• Last payment amount: the most recent charge for the subscription.
• Last Payment Date: the date the last payment was processed for the subscription.
• Locale: the locale of the invoice.
• Merged record IDs: the list of record IDs that have been merged into this record, automatically set by HubSpot. This can't be changed.
• Monthly recurring revenue: the monthly recurring revenue of the subscription.
• Monthly recurring revenue in company currency: the monthly recurring revenue of the subscription, in the account company currency.
• Name: the name of the subscription.
• Net payment terms: the agreed time frame in days (e.g., net 30), for the customer to pay subscription invoices.
• Next billing date: the next billing date when the subscription will be invoiced. If the Collection process value is automatic_payments, the subscription will be automatically charged. If the collection method value is manual_payments, an invoice will be created.
• Next payment amount: the value to be processed on the next payment date. If next payment date is null, the property is set to empty.
• Number of completed payments: the number of payments that have been processed for the subscription.
• Number of expected payments: the number of total payments expected for the subscription, based on the subscription End date.
• Object create date/time: the date and time the subscription record was created, automatically set by HubSpot. This can't be changed.
• Owner: the owner of the subscription.
• Owner assigned date: timestamp of when an owner was assigned to the subscription, automatically set by HubSpot.
• Owner's main team: the main team of the owner of the subscription, automatically set by HubSpot.
• Payment Enabled: whether a checkout link is included on invoices for subscriptions with a manual collection method.
• Payment method: the payment method for the subscription (e.g., credit card, ACH).
• Payment method source at creation: where the payment method was collected when the subscription was created.
• Payment source: the object or tool that created the subscription.
• Payment source ID: the unique ID for the object or tool that created the subscription, automatically set by HubSpot. This can't be changed.
• PO attachment: the purchase order attachment associated with the subscription.
• Processor: the payment processing option used to collect subscription payments.
• Recipient billing city: the billing city of the subscription recipient.
• Recipient billing country: the billing country of the subscription recipient.
• Recipient billing country code: the billing country code of the subscription recipient.
• Recipient billing postal code: the billing postal or zip code of the subscription recipient.
• Recipient billing state/region: the billing state or region of the subscription recipient.
• Recipient billing street address: the billing street address of the subscription recipient.
• Recipient billing street address 2: the second line of the billing address of the subscription recipient.
• Recipient company city: the city of the recipient's company or organization.
• Recipient company postal code: the postal or zip code of the recipient's company or organization.
• Recipient company state/region: the state or region of the recipient's company or organization.
• Recipient company street address: the address of the recipient's company or organization.
• Recipient company street address 2: the second line of the address of the recipient's company or organization.
• Record ID: the unique ID for this record, automatically set by HubSpot.
• Record Source: how the record was created.
• Record Source Detail 1: first level of detail on how the record was created.
• Record Source Detail 2: second level of detail on how the record was created.
• Record Source Detail 3: third level of detail on how the record was created.
• Recurring billing frequency: how often the customer is billed for the subscription.
• Start date: the date the subscription is scheduled to start, which is the day of the first payment.
• Status: the status of the subscription. The subscription status can be Active, Past due, Unpaid, Canceled, Scheduled, or Expired. Learn more about subscription statues.
• Store payment method at checkout: whether customers can store their payment method for future charges at checkout.
• Subscription modified on: the timestamp in epoch milliseconds of when a subscription was last changed.
• Subscription owner: the owner of the subscription.
• Subscription tier: the tier of the subscription.
• Tax ID: the account tax IDs listed on the generated invoice, including the tax ID type and tax ID number.
• Test subscription property: a test property for subscriptions.
• Total collected amount: total amount collected from the subscription in the currency of the subscription.
• Total Remaining Amount: total amount remaining to be collected for subscriptions with a fixed number of payments, in the currency of the subscription.
• Update payment method link: link to update the payment method on the subscription.
• Updated by user ID: the user who last updated the subscription, automatically set by HubSpot.