Registering Merchant

Before you start using Twisto, you will need to register Merchants via the API. You will use the /merchants POST.

Creating a Merchant

This API will contain:

  • Name of the Merchant
  • Display name (optional) - Customer-facing shop name to display in emails and app. If not provided, company name will be used
  • Merchant's website URL
  • Contact details
  • Unique external reference - is later used in a checkout creation request in merchant_reference field
  • Address
  • Country code (optional)
  • Company ID
  • Vat ID

The Merchant creation callout may look like this:

{ "name": "new", "display_name": "My Awesome Shop", "url": "http://example.com", "contact_name": "string", "contact_email": "user@example.com", "contact_phone_number": "+420731889776", "reference": "unique_reference", "street": "string", "city": "string", "zipcode": "string", "country_code": "CZ", "company_id": "2635463728135646", "vat_id": "1222121234" }

Validation rules for country_code, company_id, vat_id

When country_code is present, company_id and vat_id are validated according to that country. When country_code is missing, validation falls back to the PSP site country.

  • CY company ID: supports Cyprus registration formats including C/HE + 1..8 digits. Examples: C12345678, HE467004.
  • SG company ID: uses UEN format, 9..10 alphanumeric characters. Example: 202434639G.
  • vat_id can be empty. For Singapore (SG), empty vat_id is expected for non-GST merchants.