Skip to main content

Buyer

Unlike connecting to marketplaces, when using Suger's metering and billing feature, you need to create a buyer for your customer. Before creating a buyer, you must connect to a billing integration. Currently, only Stripe is supported.

Manage buyer​

Create buyer​

Enter the buyer's basic and company information.

Choose a partner​

Select a partner for the buyer. Currently, only Stripe is supported.

tip
  • The partner cannot be changed after the buyer is created.
  • One customer can have multiple buyers, each corresponding to a different partner.

Integration information​

  • Customer ID: The customer ID from your internal system.
  • Stripe Customer ID: If this buyer already exists in Stripe, Suger will connect the buyer to the Stripe customer. Otherwise, Suger will create a new customer in Stripe for this buyer.

Payment configuation​

Set the buyer’s payment configuration:

  1. Select Currency: Choose the currency the buyer will use for payments. Currently supported currencies: USD, EUR, GBP.
  2. Allowed Payment Methods: Choose the payment methods based on the currency.
  • Different currencies support different payment methods. For example, with USD, ACH Debit (US Bank Account) is available. If not selected, the buyer cannot use ACH Debit.
  • Cards are always enabled by default.
  • Credit can also be enabled (details below).
CurrencyAllowed payment methods
USDCard, ACH Debit (US Bank Account), Credit
EURCard, SEPA Debit, Credit
GBPCard, BACS Debit, Credit

Edit buyer​

Most buyer information can be modified, except for:

  • Partner
  • Stripe Customer ID
  • Currency

Share buyer portal​

Suger generates a dedicated buyer portal for each buyer. Access the portal URL from the buyer detail page, and share it with the buyer. Buyers can view their offers, entitlements, invoices, and manage payment methods on this portal.

Buyer portal url format https://console.suger.io/spa/buyer?token=xxx

tip

This page does not require login. The URL contains a one-time authentication token with a limited validity period. Buyers can access the portal within this timeframe.

Manage wallet​

After creating the buyer, help them set up payment methods to ensure automatic invoice payments in the future.

Stripe payment method​

For buyers connected to Stripe, payments are processed through Stripe. Supported methods include:

  • Card (all currencies)
  • SEPA Debit (EUR only)
  • BACS Debit (GBP only)

Learn more: Stripe Documentation

Add new payment method​

Suger uses the Stripe SDK to securely collect payment method details. More information: Stripe Documentation

tip

Sensitive payment information is never stored in Suger.

Add card​

Adding a card is straightforward, but some cards may not be eligible for addition due to restrictions.

Add a US Bank Account​

Adding a bank account is more complex. Stripe guides the user through the bank-linking process.

Set default payment method​

Set a specific payment method as the default. Suger will prioritize this method for invoice payments.

Delete payment method​

Payment methods can be deleted but cannot be modified.

Credit​

Credits are managed by Suger. You can assign credits to buyers for invoice payments. Credits are currency-specific and function as a wallet balance.

Create credit​

Each credit has the following properties:

  • Name
  • Amount
  • Validity period
  • Activation date

Close credit​

You can close a credit, and once closed, it becomes unusable.

Credit use and refund​

  • Credits within their validity period are automatically applied during invoice payments.
  • Credits can be deducted multiple times, but the total usage cannot exceed their original amount.
  • Refunds restore the corresponding deducted credits.