Adyen-for-platform icon

Manage stores

Learn how to manage stores for your users.

Stores are linked to the legal entity of your user through business lines. Stores ensure that payments are processed in a compliant manner and each processed transaction has an accurate payer statement.

For every payment processed through your user's store, you can split the funds between the balance accounts in your platform, including your liable balance account. You can split funds manually for each payment, or you can add a split configuration profile to your user's store to automatically split all payments processed through that store.

This page contains instructions for common store operations, including how to:

Store identification

When you create a store, Adyen automatically assigns a unique ID to the store. You can also optionally provide a store reference for your reports. The store ID is unique to the entire Adyen platform, while the reference is only unique to your merchant account. To update the store, you need to know the store ID.

Store statuses

Stores can have three statuses that determine how they operate:

  • Active: When you create a store, it is automatically set to active. The store can then immediately process payments.

  • Inactive: When you change the store status from active to inactive, the store is blocked from accepting new transactions, but capturing outstanding transactions is still possible. When you change the store status back to active, this restriction is removed.

  • Closed: Before you can close a store, you must first change the store status to inactive. It is not possible to change the status anymore because a closed store cannot be reopened.

Create a new store

During the initial onboarding process, you need to create a store for the user. Later, you might also need to create an additional store if the user wants to:

  • Add a new store location or website.
  • Operate in a new industry or offer additional services.

You can create a store using the Customer Area or the Management API. The following tabs contain instructions for both options.

View store details

After creating a store, you can view the resource at any time using the Customer Area or the Management API. The following tabs contain instructions for both options.

Update a store

You can update a store through the Customer Area or the Management API. Depending on the option you choose, you can make various changes.

Update method Available store operations
Customer Area
  • Update your store information, including:
    • Store description.
    • Store location and contact details.
    • Split configuration profile ID assigned to the store.
  • Access your store's transaction descriptions and payment methods using the quick links.
  • Manage your store's status, with options to inactivate, reactivate, or close the store.
Management API Update your store information, including:
  • Store description and the store ID.
  • Store location and contact details.
  • Split configuration profile ID assigned to the store.
  • Business line ID that the store is associated with.
See the full list of the available parameters.

The following tabs contain instructions for both options.

Next steps