Creating a shop: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
No edit summary
m (→‎Create a shop for your Wallet: replaced token payment with recurring payments as per UL)
 
(6 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{PageTitle|title=Creating a shop in Barion}}
{{PageTitle|title=Creating a shop in Barion}}


Creating a shop is mandatory for managing payments via the Barion API.
{| style="margin-left:2em;" align="right"
This article guides you through the creation of a shop in the Barion system.
| __TOC__
|}
 
This tutorial is your point of entry into the Barion ecosystem.
 
It’s set in [[Sandbox|the Barion Sandbox environment]].
 
We highly recommend that you start out in the Barion Sandbox, and only switch to the live environment when you're ready to deploy.
 
You can safely explore Barion API functionality, handle potential errors, and debug your integration in the controlled setting of Barion Sandbox, without the risk of disrupting your live webshop, so your deployment to production is smooth and issue-free.
 
In this tutorial, you’ll


== How to create a shop in Barion ==
# set up a Barion Wallet,
# top it up with test money, and
# open a Barion shop to accept payments.
== Prerequisites ==


# Login to your Barion wallet on the website. Barion also offers a Sandbox environment for testing purposes - learn more about the Sandbox [[Sandbox|here]].
An email address that you have access to.
# Click '''Manage my shops''' > '''Create new shop'''.
== Set up a Barion Wallet to accept payments ==
# Fill out the displayed form with [[#Shop properties|the relevant properties]]. You can save your shop in draft mode at any time. You receive a confirmation email about your newly opened shop, which contains your POSKey. This is the authentication key you need to send a request to the Barion API.
# After you filled out '''all''' fields, send your shop for approval. In the Sandbox environment, you still have to press this button even though shops are approved instantly.
# In the Live environment, the Barion staff approves your shop shortly.
# After your shop is approved and open, you can send requests to the API.


== Shop properties ==
<ol style="list-style-type: decimal;">
<li><p>If using a web browser:</p>
<p>Go to [https://secure.test.barion.com/Registration/Organization?IsEmailLocked=False the Barion Sandbox in your browser]:</p>
<p>If using the Barion mobile app:</p>
<p>Access the Other&gt;Profile&gt;Add profile screen, enter the email address you’d like to register, prefixed by “test#”, and select “Register”.</p>
<blockquote><p>Note that you need the “test#” prefix to make sure that you’re registering a Barion Wallet [[Sandbox|in the Barion Sandbox]].</p></blockquote></li>
<li><p>Make sure you pick the “Business” type of Barion Wallet, and fill in the form.</p>
<p>Use a [https://www.fakepersongenerator.com/ a random personal details generator] if you like, for the required personal details.</p>
<blockquote>Shops for Barion Wallets in the sandbox environment are approved automatically, so you don’t need to worry about having the shop details checked for now. Live webshops associated with a real business are, however, strictly controlled – read about opening a shop in the live Barion environment [[Going live|here]].</blockquote></li>
<li><p>Click Registration/Sign up.</p>
<p>You’ll soon receive an email at the address you’ve entered in the form, with the activation link.</p></li>
<li><p>Click the link to the activation page in the activation email.</p>
<p>This opens the account activation page in your browser.</p></li>
<li><p>Select a security question from the list provided, enter your answer, and click Wallet activation.</p>
<blockquote><p>Read more about registering an account [[https://www.barion.com/en/help/how-can-i-get-a-barion-wallet/|in the dedicated support article]].</p></blockquote></li></ol>
== Create a shop for your Wallet ==


{| class="wikitable api-table"
Log in to the newly-created Barion Wallet, and click through to Shops&gt;+Create new shop.
|-
 
! Property
<ol style="list-style-type: decimal;">
! Description
<li><p>Enter the shop and contact details for the shop as required.</p>
|-
<p>Feel free to use the random personal details generator as before.</p></li>
| Shop name
<li><p>Select the first and last options in the “To-do list” section, then click “Save as draft”, then “Submit form”.</p></li></ol>
| The name of the shop. Must be unique in the Barion system, and must be compliant with your organization or business. Generic names like ''"my test shop"'', ''"online jewelry store"'' or ''"postal service"'' are not accepted.
 
|-
<blockquote>Barion shops in the sandbox have [[Token payment 3D Secure|recurring payment scenarios]] and [[C2C Payments|Barion Bridge]] enabled by default.
| Shop description
</blockquote>
| A short description of the shop. This is to help the Barion staff identify the shop as a valid business.  
== Next steps ==
|-
 
| Shop URL
Now you’re ready to [[Making a test payment|make a test payment in your shop]].
| The URL to the owner's website, or the webshop itself, if applicable.
|-
| Avatar
| An image representing the organization or business. This should be your company logo. Avoid stock photos and such - if the image is misleading or irrelevant to your business, your shop will not be approved!
|-
| Category
| Set appropriate categories that apply to your business. If your business does not fall into the selected categories, your shop will not be approved!
|}

Latest revision as of 07:28, 16 August 2024

Creating a shop in Barion

This tutorial is your point of entry into the Barion ecosystem.

It’s set in the Barion Sandbox environment.

We highly recommend that you start out in the Barion Sandbox, and only switch to the live environment when you're ready to deploy.

You can safely explore Barion API functionality, handle potential errors, and debug your integration in the controlled setting of Barion Sandbox, without the risk of disrupting your live webshop, so your deployment to production is smooth and issue-free.

In this tutorial, you’ll

  1. set up a Barion Wallet,
  2. top it up with test money, and
  3. open a Barion shop to accept payments.

Prerequisites

An email address that you have access to.

Set up a Barion Wallet to accept payments

  1. If using a web browser:

    Go to the Barion Sandbox in your browser:

    If using the Barion mobile app:

    Access the Other>Profile>Add profile screen, enter the email address you’d like to register, prefixed by “test#”, and select “Register”.

    Note that you need the “test#” prefix to make sure that you’re registering a Barion Wallet in the Barion Sandbox.

  2. Make sure you pick the “Business” type of Barion Wallet, and fill in the form.

    Use a a random personal details generator if you like, for the required personal details.

    Shops for Barion Wallets in the sandbox environment are approved automatically, so you don’t need to worry about having the shop details checked for now. Live webshops associated with a real business are, however, strictly controlled – read about opening a shop in the live Barion environment here.

  3. Click Registration/Sign up.

    You’ll soon receive an email at the address you’ve entered in the form, with the activation link.

  4. Click the link to the activation page in the activation email.

    This opens the account activation page in your browser.

  5. Select a security question from the list provided, enter your answer, and click Wallet activation.

    Read more about registering an account [the dedicated support article].

Create a shop for your Wallet

Log in to the newly-created Barion Wallet, and click through to Shops>+Create new shop.

  1. Enter the shop and contact details for the shop as required.

    Feel free to use the random personal details generator as before.

  2. Select the first and last options in the “To-do list” section, then click “Save as draft”, then “Submit form”.

Barion shops in the sandbox have recurring payment scenarios and Barion Bridge enabled by default.

Next steps

Now you’re ready to make a test payment in your shop.