Overview

Stripe integration allows you to sync your subscription and payment data to Intempt.

After creating the source, you'll be able to access the following events:

EventDefinition
CustomersNew customer is added to Stripe, or any individual properties are updated.
Trial cancelledTriggered when a trial period is canceled.
Trial expiredSent when a trial period expires and transitions to active or another state.
New trialTriggered when a new trial period begins for a subscription.
Subscription changeOccurs whenever a subscription changes, such as upgrades or downgrades.
Subscription cancelledSent when a subscription is canceled.
ChargeOccurs whenever a charge is created or updated.
InvoiceSent each time an invoice is created or updated.

How to create a new Stripe source

  1. Go to Sources and select "Create source" -> Stripe option.
  1. Connect to your Stripe account to integrate with Intempt by clicking the "Connect Stripe" button. After that, you'll need to enter your Stripe account credentials and confirm the integration with Intempt.

If the integration is successful, you will be able to proceed to the next step or re-authorize if necessary.

  1. As a final step, you will need to configure the sync start date.

By default, Intempt will sync all data available in your stripe account. However, you can also select a custom sync time if you don't want to ingest all of the historic data.

Once the source is created, you can always update the sync schedule in the overview tab.

Disconnect your Stripe account

To disconnect your Stripe account:

  • Go to your Stripe account
  • Go to the Installed Apps page in the Dashboard
  • Click Uninstall app
  • Go to Sources and delete your Stripe source.

Attribute reference

New trial, Subscription cancelled, Subscription change, Trial cancelled, Trial expired

Event attribute nameDescriptionExample Value
ValueA unique and immutable identifier for the subscription. If not provided, it is autogenerated.123456
Change typeThe identifier of the plan for this subscription.basic_plan
Product namesRepresents the product names for this subscription.["Product A", "Product B"]
StateThe amount that will override the plan’s default price.500
Activated atThe time at which the subscription status last changed to active. For example, this value is updated when an in_trial or cancelled subscription activates.2024-07-05T22:10:00Z
Cancelled atThe time at which subscription was cancelled or is set to be cancelled.2024-07-10T22:10:00Z
Expires atThe date on which the subscription expires.2024-08-05T22:10:00Z
Current term startThe start of the current billing period of the subscription.2024-07-05T22:10:00Z
Current term endThe end of the current billing period of the subscription. Subscription is renewed immediately after this.2024-08-05T22:10:00Z
Trial started atThe start of the trial period for the subscription. Presence of this value for future subscription implies the subscription will go into in_trial state when it starts.2024-07-05T22:10:00Z
Trial ends atThe end of the trial period for the subscription.2024-08-05T22:10:00Z
Trial end actionApplicable only when End-of-trial Action has been enabled. Whenever the subscription has a trial period, this attribute is returned and specifies the operation to be carried out for the subscription once the trial ends.continue_subscription
Is trialA status value for the subscription; the subscription is in trial.true
MRRMonthly recurring revenue for the subscription. Updated asynchronously, this value catches up with changes to the subscription in less than a minute. The value depends on the type of currency. Note: This may not return accurate values since updated asynchronously.1000
ARRAnnual recurring revenue for the subscription. Updated asynchronously, this value catches up with changes to the subscription in less than a minute. The value depends on the type of currency. Note: This may not return accurate values since updated asynchronously.12000

Charge

Event attribute nameDescriptionExample Value
StatusThe status of this transaction.succeeded
AmountThe amount for this transaction, in cents.1000
Amount refundedThe amount refunded, if a refund has occurred.500
CurrencyThe currency code (ISO 4217 format) for the transaction.USD
DescriptionDescription for the transaction.Monthly subscription

User attribute nameDescriptionExample Value
Receipt emailThe recipient's email address.[email protected]

Invoice

Event attribute nameDescriptionExample Value
Invoice numberThe invoice number. Acts as an identifier for invoice and is typically generated sequentially.INV12345
StatusThe status of the invoice.paid
TotalThe sum of all the line item amounts.5000
Sub totalThe sum of all the line item amounts minus the sum of all line item discounts.4500
Amount paidThe payments collected successfully for the invoice.4500
Amount dueThe unpaid amount that is due on the invoice.500
PaidBoolean flag is paid.true
Collection methodPayment type.credit_card

Customers

User attribute nameDescriptionExample Value
CityThe name of the city, district, suburb, town, or village where the customer resides or is located.New York
CountryThe two-letter ISO 3166-1 alpha-2 code that represents the country where the customer resides.US
Address line 1The primary address line for the customer's physical address, such as a street name, PO Box, or company name.123 Main St
Address line 2An additional address line for more details about the address, such as an apartment number, suite, unit, or building floor.Apt 4B
Postal codeThe postal or ZIP code used for identifying the customer's location within their region.10001
State/provinceThe state, province, county, or administrative region of the customer's address.NY
Email addressThe customer’s email address.[email protected]
Full name/business nameThe customer's complete personal name or the official name of their business entity.John Doe
Phone numberThe customer’s phone number.+1-800-555-1234
Available cash balanceA hash of all cash balances available to this customer. You cannot delete a customer with any cash balances, even if the balance is 0. Amounts are represented in the smallest currency unit.{ "USD": 1000 }
Account creation dateTime at which the object was created. Measured in seconds since the Unix epoch.1672531200
CurrencyThree-letter ISO code for the currency the customer can be charged in for recurring billing purposes.USD
SubscriptionsArray, containing details about all subscriptions, including metadata like start date, status, price, currency etc[
{
"mrr": 3340,
"arr": 40080,
"cancelled_at": null,
"expires_at": null,
"current_term_start": "2024-10-24T08:43:01Z",
"current_term_end": "2024-11-24T08:43:01Z",
"trial_started_at": null,
"trial_ends_at": null,
"cancel_at_period_end": false,
"created": "2024-09-24T08:43:01Z",
"currency": "usd",
"days_until_due": null,
"discounts": [],
"ended_at": null,
"next_pending_invoice_item_invoice": null,
"status": "active",
"items": [
{
"price": {
"unit_amount": 1000,
"currency": "usd",
"product": {
"name": "a"
},
"recurring": {
"interval": "month",
"interval_count": 1
}
},
"quantity": 1
},
{
"price": {
"unit_amount": null,
"currency": "usd",
"product": {
"name": "b"
},
"recurring": {
"interval": "month",
"interval_count": 1
}
},
"quantity": 8
}
]
}
]
MRRMonthly recurring revenue for the customer. This value catches up with changes to the customer's subscriptions in less than a minute. The value depends on the type of currency. Note: This may not return accurate values since updated asynchronously.500
ARRAnnual recurring revenue for the customer. This value catches up with changes to the customer's subscriptions in less than a minute. The value depends on the type of currency. Note: This may not return accurate values since updated asynchronously.6000