Skip to main content

Creating a Merchant

Note: By default, the partner has a "sandbox" merchant with access to "sandbox" payments. Sandbox merchants can also be created from the merchant creation form for familiarising yourself with the system.

There are two ways to create a new merchant:

  1. Public Partner API: Detailed in our API specification available here.
  2. UI in Partner Mode: Detailed below.

Creating a Merchant via UI​

  1. Navigate to the "Merchants" section and click "Add a merchant".
  2. Fill in the mandatory fields marked with "*". Optional fields can be filled later.

Form Fields:

  • Registration Country*: Select the country where the merchant is registered.
  • Business Structure*: Choose one:
    • Limited Company
    • Sole Trader
    • Sandbox Company: Requires no additional information and is meant for testing purposes only.

Limited Company Form Fields​

  • Company Registration Number (CRN)*: Number issued upon registration with "Company Houses". If valid, part of the form will auto-fill, including information about company directors for verification purposes.
  • Registered Name*: The official name of the company.
  • Trading Name*: The name under which the company trades.

Registered Address:

  • Address Line 1*: The first line of the registered address.
  • Address Line 2: The second line of the registered address.
  • City*: The city of the registered address.
  • Postcode*: The postal code of the registered address.

Trading Address:

  • Address Line 1*: The first line of the trading address.

  • Address Line 2: The second line of the trading address.

  • City*: The city of the trading address.

  • Postcode*: The postal code of the trading address.

  • Industry*: Select the industry from the provided options.

  • Business Website: The company's website.

Contact Information:

  • Contact First Name*: The first name of the contact person.
  • Contact Last Name*: The last name of the contact person.
  • Contact Email*: The email address of the contact person.
  • Primary Phone Number*: The phone number of the contact person.

Sole Trader Form Fields​

  • Unique Taxpayer Reference (UTR)*: A 10-digit taxpayer reference number.
  • Industry*: The industry in which the business operates.
  • Full Legal Name*: The full legal name of the sole trader.
  • Contact First Name*: The first name of the contact person.
  • Contact Last Name*: The last name of the contact person.
  • Contact Email*: The email address of the contact person.
  • Contact Phone Number*: The phone number of the contact person.
  • Business Website: The website of the business.
  • Trading Name*: The name under which the sole trader operates.

Address:

  • Address Line 1*: The first line of the address.
  • Address Line 2: The second line of the address.
  • City*: The city of the address.
  • Postcode*: The postal code of the address.

Common Fields for Both Forms​

  • Custom Webhook URL: Receive updates on the merchant's verification status at this URL. If left empty, updates will be sent to the webhook URL in your settings.
  • Custom Redirect URL: The URL to which the merchant will be redirected after completing the verification process.
  • Send Email for ID Verification: We will send an email with ID verification instructions to the contact email.
  • Send Email with Business Toolkit Sign-up Invitation: An invitation email will be sent to the contact email, allowing the merchant to view payment information. If this option is not selected, the contact will be created in "silent" mode and will not access the service until an invitation is sent.

Adding a Bank Account​

Connect the merchant's bank account to receive payments. This step can be skipped and completed later on the merchant's details page.

  • Add Details Manually

  • Select Bank*: Choose a bank from the provided list.

  • Account Name*: The name of the bank account.

  • Sort Code*: The sort code of the bank.

  • Account Number*: The account number.

  • Statement File*: A bank statement file.

The Fena team will verify the provided data and approve the bank account if the information is in order.

  • Ask merchant to add their bank account using online banking

An email will be sent to the contact email with a link to connect the bank account. This link is unique for each merchant and also available on the merchant’s details page. The Fena team will approve the bank account if the connection is successful.

Note: By default, the partner has a "sandbox" merchant with access to "sandbox" payments. Sandbox merchants can also be created from the merchant creation form for testing purposes

KYC/KYB and AML Checks​

Provide the link to the verification page. This link was sent to the merchant’s contact email upon creation if the corresponding option was selected, and can also be found on the merchant’s details page in the "Verification" section.

Merchant Integration​

The Merchant Integration entity is intended for merchants created by partners to configure where payment status change webhooks will be sent and where clients will be redirected after completing payments. This entity can be created on merchant's details page. After creating this entity , you can pass its unique ID into payment creation request. More details herex

Fields Required for Creating a Merchant Integration​

  • Name: The name of the integration.
  • Webhook URL: The URL to receive updates on payment status changes.
  • Redirect URL: The URL to which clients will be redirected after completing payments.