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)
 
(14 intermediate revisions by 6 users not shown)
Line 1: Line 1:
__NOTOC__
{{PageTitle|title=Creating a shop in Barion}}
{{PageTitle|title=Creating a shop in Barion}}


Line 5: Line 6:
|}
|}


Creating a shop is mandatory for managing payments via the Barion API.
This tutorial is your point of entry into the Barion ecosystem.
This article guides you through the creation of a shop in the Barion system.


== Steps to create a shop ==
It’s set in [[Sandbox|the Barion Sandbox environment]].


# Log in to your Barion wallet on the website. Barion also offers a Sandbox environment for testing purposes - learn more about the Sandbox [[Sandbox|here]].
We highly recommend that you start out in the Barion Sandbox, and only switch to the live environment when you're ready to deploy.
# Click the "Manage my shops" menu, then click the "Create new shop" button above the grid.
# Enter the necessary data on the appearing form, then submit it.
# You receive a confirmation email about your newly opened shop, which contains you POSKey. This is the authentication key you will need to send a request to the Barion API.
# Your shop will be approved by the Barion staff in a short time. In the Sandbox environment, shops are approved instantly.
# After your shop is approved, you can send requests to the API.


== Shop properties ==
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.


{| class="wikitable api-table"
In this tutorial, you’ll
|-
 
! Property
# set up a Barion Wallet,
! Description
# top it up with test money, and
|-
# open a Barion shop to accept payments.
| Shop name
== Prerequisites ==
| The name of the shop. Must be unique in the Barion system, and must be compliant with your organization or business. General names like ''"my test shop"'', ''"online jewellery store"'' or ''"postal service"'' will not be approved!
 
|-
An email address that you have access to.
| Shop description
== Set up a Barion Wallet to accept payments ==
| A short description about the shop. This is to help the Barion staff identify the shop as a valid business.  
 
|-
<ol style="list-style-type: decimal;">
| Shop URL
<li><p>If using a web browser:</p>
| The URL to the owner's website, or the webshop itself, if applicable.
<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>
| Callback URL
<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>
| The URL the Barion system should use during the callback mechanism. Learn more about this [[Callback_mechanism|here]].
<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>
| Redirect URL
<p>Use a [https://www.fakepersongenerator.com/ a random personal details generator] if you like, for the required personal details.</p>
| The URL the payer gets redirected if they complete or cancel the payment on the Barion Smart Gateway. This is mandatory for webshops.
<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>
| Avatar
<p>You’ll soon receive an email at the address you’ve entered in the form, with the activation link.</p></li>
| 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!
<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>
| Category
<li><p>Select a security question from the list provided, enter your answer, and click Wallet activation.</p>
| Set appropriate categories that apply to your business. If your business does not fall into the selected categories, your shop will not be approved!
<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 ==
 
Log in to the newly-created Barion Wallet, and click through to Shops&gt;+Create new shop.
 
<ol style="list-style-type: decimal;">
<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>
<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>
 
<blockquote>Barion shops in the sandbox have [[Token payment 3D Secure|recurring payment scenarios]] and [[C2C Payments|Barion Bridge]] enabled by default.
</blockquote>
== Next steps ==
 
Now you’re ready to [[Making a test payment|make a test payment in your shop]].

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.