Introductory Concepts

Read a basic overview of some of the concepts used by the services and in this documentation.


Each sale represented as a transaction. Transactions have several possible statuses but typically they are stored initially with a status of N (new / unconfirmed) prior to processing the customer’s payment; once the payment has processed the status is updated to C (confirmed). Only confirmed transactions appear in the various reports.

The transaction contains all of the sale’s information, primarily:

  • Sale order lines, with amounts, descriptions and transaction date
  • Currency information
  • Tax-related information - location evidence, tax region/country assigned, tax rates
  • Buyer information, including the billing address and email address
  • A number of custom fields, able to carry additional information
  • Invoice image reference
  • Issued refunds
  • Registered payments

There are several types of transactions:

  • Merchant: Standard transactions in which Vertex is not an intermediary
  • Vertex: Standard transactions in which Vertex was an intermediary
  • Self-billed: For transactions in which Vertex was an intermediary and additional transaction is automatically created in the system from the merchant to Vertex.
  • Placeholder: When a sale is made for a subscription product a placeholder transaction can be created to store the location evidence, customer information, etc. - which future renewals will reference.

Tax Regions

A tax region is a country, or group of countries, that have a common reporting target - for example the 27 member countries of the European Union, or the Switzerland region which also includes Liechtenstein.

Upon processing a sale Vertex will assign an appropriate region and country to the transaction, so that the sale complies with the appropriate tax laws.

The tax region can be either:

  • Delegated for Vertex to be the seller: Transactions made in this region will mean Vertex is liable for VAT/GST purposes.
  • Enabled for tax and the merchant is the seller: In this case, local VAT/GST or sales tax is applied. For such regions, it is possible to browse tax reports generated by Vertex and use them for filing directly with the relevant tax authority.
  • Disabled for tax: transactions for this region will be stored, but tax will not be calculated and applied and Vertex will not provide tax reports.

In addition, if there is any region that you do not want to sell to, it can be blocked so that sales to that region will not proceed.