Add Unzer marketplace credentials

Last updated:
Edit on GitHub

This document shows how to add Unzer marketplace credentials.

Prerequisites

Each section contains reference information. Make sure to review it before you start, or look up the necessary information as you go through the process.

To add Unzer marketplace credentials, take the steps in the following sections.

Note

All merchants allowed to sell their products in your stores must have Unzer credentials in the Back Office. Otherwise, your customers cannot buy their products; they will not be able to start the checkout process.

Add Unzer merketplace credentials

  1. Add Unzer credentials:

    1. Go to Back Office > Unzer.
    2. On the Overview of Unzer Credentials page, click Add Unzer Credentials. The Add Unzer Credentials page opens.
    3. For the new credentials, enter a NAME.
    4. For CREDENTIALS TYPE, select Marketplace (main channel).
    5. Enter UNZER PUBLIC KEY.
    6. Enter UNZER PRIVATE KEY.
    7. Select STORE RELATIONS.
    Note

    Select only unused store relations. Otherwise, when you complete adding your credentials, an error message is thrown.

  2. Add main merchant credentials:

    1. Optional: if the operator is a merchant, select MERCHANT REFERENCE.
    2. Enter PARTICIPANT ID.
    3. Enter UNZER PUBLIC KEY.
    4. Enter UNZER PRIVATE KEY.

  3. Click Save. The new credentials appear on the Overview of Unzer Credentials page.

  4. Click Sync payment methods for needed credentials to sync payment methods.

  5. Go to Back Office > Administration > Payment Methods.

  6. On the Payment Methods page, click Edit next to the needed payment method.

  7. On the Edit Payment Method page, open the Store Relation tab and map the payment method to the needed stores.

Reference information: Add Unzer marketplace credentials

ATTRIBUTE DESCRIPTION
NAME Name of the Unzer marketplace credentials.
CREDENTIALS TYPE Type of the credentials
  • Marketplace (main channel)—the credentials type for the marketplace with multiple merchants
  • Standard—the credentials type for a basic store without merchants.
UNZER PUBLIC KEY Unique public key which Unzer provides to a project to accept payments. The key is store-specific.
UNZER PRIVATE KEY Unique private key which Unzer provides to a project to accept payments. The key is store-specific.
UNZER PUBLIC KEY (MAIN MERCHANT CREDENTIALS) Unique public key which Unzer provides to each merchant to accept payments. The key is merchant-specific.
UNZER PRIVATE KEY (MAIN MERCHANT CREDENTIALS) Unique private key which Unzer provides to each merchant to accept payments. The key is merchant-specific.
STORE RELATION Defines stores the Unzer payment method will be available in.
MERCHANT REFERENCE Merchant ID on the Spryker side.
PARTICIPANT ID Merchant reference on the Unzer side, which identifies a merchant who receives money when the order is paid and gets the status payment completed.

Add credentials for external merchants

  1. Go to Back Office > Unzer.
  2. On the Overview of Unzer Credentials page, against credentials you want to add external merchant credentials for, click Edit. The Edit Unzer Credentials page opens.
  3. On the External Merchant Credentials tab, click Add Merchant Unzer Credentials.
  4. For the new merchant Unzer credentials, enter a NAME .
  5. Enter UNZER PUBLIC KEY.
  6. Enter UNZER PRIVATE KEY.
  7. Select MERCHANT REFERENCE.
  8. Enter PARTICIPANT ID.
  9. Click Save.

Reference information: Add credentials for external merchants

The following table describes the attributes you select and enter when adding Unzer credentials:

ATTRIBUTE DESCRIPTION
UNZER PUBLIC KEY Unique public key which Unzer provides to each external merchant to accept payments. The key is store-specific.
UNZER PRIVATE KEY Unique private key which Unzer provides to each external merchant to accept payments. The key is store-specific.
MERCHANT REFERENCE Merchant ID on the Spryker side.
PARTICIPANT ID Merchant reference on the Unzer side, which identifies a merchant who receives money when the order is paid and gets the status payment completed.