Stripe

The Stripe app integrates OpenMeter with Stripe to provide additional features and seamlessly integrate with existing workflows. For example, the Stripe app can be configured to synchronize invoices to Stripe, calculate tax, and collect payments automatically.

#Get Started

To get started with the Stripe app, follow these steps:

1. Go to Stripe App in the OpenMeter dashboard.
2. Click on the Install button.
3. Follow the authorization steps to connect the app with OpenMeter.
4. Optionally configure the billing profile to use the Stripe app.

#Features

• Stripe Tax: Calculate taxes automatically via Stripe based on location, product, or other criteria.
• Stripe Invoicing: Sync and deliver invoices via Stripe and collect payments.
• Stripe Payments: Collect payments via Stripe payment gateway using multiple payment methods.

#Stripe Tax

Leverage Stripe Tax to handle complex tax rules and rates for any region. The integration ensures accurate, up-to-date tax calculations for each invoice, removing the guesswork and reducing compliance risks.

#Stripe Invoicing

Stripe Invoicing is a global invoicing software platform built to save you time and get you paid faster. OpenMeter can synchronize invoices to Stripe Invoicing continuesly to automatically collect payments. Stripe Invoicing makes it easy to automate accounts receivable, collect payments, and reconcile transactions.

#Stripe Payments

Collect payments quickly and securely via Stripe's trusted payment gateway. Your customers can choose from various payment methods—credit card, ACH, and more—to improve the overall customer experience and speed up cash flow.

In OpenMeter you can configure the default payment method and currency to use for payments per customer and billing profile.

#Simplified Checkout Experience

To simplify onboarding customers and collecting payments, OpenMeter provides a simple API to create a customer and generate a Stripe Checkout link. With a single API call you can:

• Create an OpenMeter Customer (or use an existing one)
• Attribute Metered Usage to the customer
• Create a Stripe customer (or use an existing one)
• Generate a Stripe Checkout URL to the payment form

#Node.js Example

const session = await openmeter.apps.stripe.createCheckoutSession({
  customer: {
    name: 'ACME, Inc.',
    // Optional: make lookup easier
    key: 'my-database-id',
    usageAttribution: {
      // The subject in the usage event
      subjectKeys: ['my-usage-event-subject'],
    },
  },
  options: {
    // Stripe will redirect to this URL after the checkout
    successURL: 'https://example.com/success',
    currency: 'USD',
  },
});

Wich will return a URL to the Stripe checkout form to collect credit card details:

{
  "customerId": "01JKHFVVZ71HGXD25E28PG8F5Z",
  "mode": "setup",
  "sessionId": "cs_test_xxx",
  "setupIntentId": "seti_xxx",
  "stripeCustomerId": "cus_xxx",
  "successURL": "https://example.com/success",
  "url": "https://checkout.stripe.com/c/pay/cs_test_xxx"
}

#cURL Example

Example API Request:

curl  -X POST \
  'https://openmeter.cloud/api/v1/stripe/checkout/sessions' \
  --header 'Authorization: Bearer my-token' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "customer": {
    "name": "ACME, Inc.",
    "currency": "USD",
    "usageAttribution": { "subjectKeys": ["my-identifier"] }
  },
  "options": {
    "successUrl": "https://example.com/success"
  }
}'

You'll receive a Stripe Checkout Session URL in response, ready to securely capture payment information.

model CreateStripeCheckoutSessionResult {
  customerId: ULID;
  stripeCustomerId: string;
  sessionId: string;
  setupIntentId: string;
  url: string;
  mode: StripeCheckoutSessionMode;
  cancelURL?: string;
  successURL?: string;
  returnURL?: string;
}

See the Stripe Checkout API documentation for more details on the response fields.