Paigo Documentation
Ask or search…
K

Manage Customer Profile

Overview

Customer information is the billing target in Paigo. Customers should represent the paying entity for bills. Customers can be defined with basic information such as name and email, payment information, billing addresses, tax information, and their enrollment in pricing plans. For different teams or departments with different budgets or paying channels within the same company, different customers should be created and maintained inside Paigo.

Customer Configuration

These properties are configurable for a customer.

Basic Information

  • Customer Name: A friendly display name of the customer. This name is shown on invoices. Required.
  • Customer Email: The contact of customers. This email is used to contact customer for billing-related communication such as invoice delivery or payment issues. Please make sure this is a valid email address to ensure the communication of critical billing matters. Required.
  • Offering: The offering plan customers are enrolled in.

Payment

  • Payment Channel: How customers will be charged.
    • Stripe: Use Stripe Connect to have Paigo orchestrate the payment. See Process Payment with Stripe chapter for full documentation on payment. Requires Payment enabled and Stripe Connect enabled under Setting > App.
    • Manual: Payment will be handled outside Paigo by the business. Paigo will skip payment for the billing.
  • Customer in Stripe: How to bind a customer entity in Stripe with customer entity in Paigo.
    • Existing: Provide an existing customer entity in Stripe by customer ID in Stripe.
    • Create New: Paigo will create a new customer in Stripe on behalf the SaaS business.
  • Customer Stripe Account ID: The unique identifier of customer information in Stripe in the form of cus_xxxxxxxxxxxxxx. It can be found in Stripe dashboard when viewing customer's information. See screenshot below for an example.
  • Preferred Currency: The currency customer preferred. See the section Customer Preferred Currency below for more details.
To understand the customer information binding in Paigo and in Stripe, read Binding Customer Entity in Paigo with Customer Stripe Accounts chapter for more details.

Billing Address

The properties of the billing address are required to calculate global sales tax and is recommended for invoices to be fully compliant.
  • Address Line 1
  • Address Line 2
  • City
  • State
  • Postale Code
  • Country

Tax

  • Customer VAT ID: To be displayed on invoice if either SaaS business or SaaS customer has a European Union address.
  • Tax Exempt: Whether the customer is exempt from global sales tax.
    • None: the customer is not exempt from global sales tax
    • Exempt: the customer is exempt from global sales tax

Customer Preferred Currency

Customers can choose their preferred currencies for billing. Paigo currently supports the following currencies:
  • US Dollar
  • Euro
The preferred currency is a customer-specific configuration. Every customer has their own preference. The preferred currency might be the same as or different from the default currency on the offering. If it's the same currency as the offering's, Paigo will not make any currency conversions. If the preferred currency is different from the currency on the currency on the offering, Paigo will dynamically calculate the value to bill based on realtime exchange rate provided by Open Exchange Rates API.
For example, assume the offering's default currency is US Dollar, and a customer's preferred currency is Euro. If the customer has used $100 equivalent of product usage based on the offering, then the customer will be invoiced and charged €91.80 based on the realtime currency exchange rate. The currency exchange calculation only happens when invoices are generated and when payment is charged. Therefore, the exchange rate is used for those points in time.
Please note that if customer's preferred currency is different from the offering's default currency, the customer is bearing the foreign currency exchange rate risk, because the SaaS business will always receive a fixed amount of revenue for the default currency specified on the offering, but the customer will likely pay variable amount every billing cycle due to the fluctuation of exchange rate.
For SaaS business account balance with regard to difference currencies charged to SaaS customers, see Multi-Currency Support for details.