# Buyer

Buyer management.

---

When using Fours' metering and billing service, you'll need to create a buyer profile for your customer. This differs from marketplace connections, where buyer profiles are managed by the marketplace.

Before creating a buyer, ensure you have connected to a billing integration - currently, Stripe is the supported integration platform.

## Manage buyer

### Create buyer

Enter the buyer's basic and company information.

<img src="https://imagedelivery.net/pNNvR2_tZYczcQ3leBU_1A/6d68a25e-9c29-42a3-6edd-4b1c72e54700/square" alt="Create buyer form with basic and company information" style="max-width:600px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

#### 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.
- If you need to connect a customer to multiple partners, you need to create multiple buyers on Fours.
  :::

#### Integration information

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

<img src="https://imagedelivery.net/pNNvR2_tZYczcQ3leBU_1A/522f6117-ffd7-4653-d389-15e1c6ec9b00/square" alt="Buyer integration fields for Customer ID and Stripe Customer ID" style="max-width:600px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

#### 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).

| Currency | Allowed payment methods                   |
| :------- | :---------------------------------------- |
| USD      | Card, ACH Debit (US Bank Account), Credit |
| EUR      | Card, SEPA Debit, Credit                  |
| GBP      | Card, BACS Debit, Credit                  |

### Edit buyer

Open the buyer from **Companies** and click its **Edit** action, or open its company page and choose **More actions** → **Edit info**. Every buyer on the Companies page, including buyers that come from a cloud marketplace, is edited in the same **Edit Buyer** panel.

Most of the buyer's information can be modified, except for:

- Partner
- Stripe Customer ID
- Currency

The panel's optional **Integration Information** section links the buyer to its record in your other systems:

| Field | What it links |
| :---- | :------------ |
| Stripe customer ID | The buyer's customer in Stripe. It can't be changed for a buyer whose partner is Stripe. |
| Chargebee customer ID | The buyer's customer in Chargebee. Fours' hourly Chargebee usage sync picks up only buyers that carry one, and reports that Chargebee customer's priced overage as usage on the buyer's entitlement. See [Connect Chargebee Customer](/integrations/chargebee/#connect-chargebee-customer). |
| Metronome customer ID | The buyer's customer in Metronome, for usage metering. |
| Orb customer ID | The buyer's customer in Orb, for usage metering. |
| Lago customer ID | The buyer's customer in Lago, for usage metering. |
| Customer ID | The buyer's ID in your own system. It can identify the buyer in a CSV of usage you batch-report. |

### Share buyer portal

Fours generates a dedicated buyer portal for each buyer. To get its URL, open the buyer's company page (**Company** in the console navigation — see [Companies](/console/company/)), select **More actions**, then choose **Share buyer portal**. The portal opens in a new tab; copy its URL and share it with the buyer.  
Buyer portal url will be in the format `https://console.suger.io/spa/buyer?token=xxx`

<img src="https://imagedelivery.net/pNNvR2_tZYczcQ3leBU_1A/7705b082-0114-40b8-5b7c-dd0dadc72200/square" alt="Buyer portal URL on the buyer detail page" style="max-width:880px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

Buyers can view their offers, entitlements, invoices, and manage payment methods on this portal.

<img src="/img/billing/stripe_buyer_portal.png" alt="Buyer portal with offers, entitlements, and invoices" style="max-width:880px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

:::warning

- This page does not require buyer to login. The URL will contain a one-time authentication token with a limited validity period. Buyers can access the portal within this timeframe.
- Don't share the URL with unauthorized buyers.
  :::

## Manage wallet

After the buyer is created, you can help to set up payment methods to ensure automatic invoice payments in the future.

### Stripe payment method

For buyers who's partner is Stripe, payments are processed through Stripe. Fours supports the following payment methods through Stripe:

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

Learn more: [Stripe Documentation](https://docs.stripe.com/payments/payment-methods/overview)

:::tip
If you need to add a test payment method, you need to connect Fours to your Stripe test account when creating the integration.

Learn more: [Create Stripe Integration](https://doc.fours.com/integrations/stripe/)
:::

#### Add new payment method

Fours uses the Stripe SDK to securely collect payment method details. These details will be stored in Stripe to process payments in the future, you only need to add the payment method once.

Learn more: [Stripe Documentation](https://docs.stripe.com/payments/payment-element)

:::tip
Sensitive card information will not be stored in Fours.
:::

<details>
  <summary>Click here to see the details about payment method collection.</summary>

<img src="https://imagedelivery.net/pNNvR2_tZYczcQ3leBU_1A/c2d7cea5-05fd-43ce-c812-20842c9d3000/square" alt="Payment method collection dialog using Stripe SDK" style="max-width:800px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

</details>

- **Add card**

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

<img src="/img/billing/buyer_add_new_card.png" alt="Add new card form for a buyer" style="max-width:618px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

- **Add a US Bank Account**

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

<img src="/img/billing/buyer_add_us_bank_account_1.png" alt="Add US bank account step 1 of Stripe bank-linking" style="max-width:621px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

<img src="/img/billing/buyer_add_us_bank_account_2.png" alt="Add US bank account step 2 of Stripe bank-linking" style="max-width:619px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

#### Set default payment method

You can set a payment method as default, Fours will use this method first for invoice payments.

#### Delete payment method

Payment methods can be deleted but cannot be modified.

### Credit

Credits are managed by Fours. You can assign some credits to a buyer to pay for their invoices. Credits are currency-specific and works like a wallet balance.

#### Create credit

Each credit can have its own active period.

<img src="/img/billing/buyer_add_credit.png" alt="Create credit form with active period" style="max-width:616px;width:100%;display:inline;margin:0 auto;box-shadow:5px 5px 5px #eee" />

#### Close credit

You can close a credit before its active period ends. Once closed, the credit will be 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.
- Multiple credits can be used for a single invoice payment.
- Credits can be refunded, and the corresponding amount will be restored.
