Support Center

Setting up PAYONE

Follow

 

 

Shopgate supports PAYONE as a payment service provider.

By setting up your PAYONE account at Shopgate, you will be able to accept the following types of payment from the available marketplace:

 

  Credit Card, PayPal, Invoice,
Direct Debit, Prepayments
SOFORT BankingNEW Klarna InvoiceNEW, GiroPayNEW iDEALNEW
USA No No No No
UK No No No No
Germany Yes Yes Yes No
Austria No Yes No No
Switzerland No Yes No No
Poland No No No No
France No No No No
Netherlands No Yes No Yes

 

In this article, you will find everything you need to set up PAYONE for your mobile website and apps.

 

 

Topics covered in this article:

  1. Adding PAYONE as a payment provider
  2. Entering shipping destinations
  3. Entering Transaction URL (direct debit, invoice, prepayment)
  4. Adding extra fields (iDEAL, SOFORT, Giropay, Klarna Invoice)
  5. Frequently Asked Questions (FAQ)

 

1. Adding PAYONE as a payment provider

1.1 Collecting necessary information

Please prepare the following information before you set up PAYONE as a payment provider at Shopgate.

Options Provided by PAYONE:
Merchant ID

These credentials can be found in your PAYONE account credentials.

where can I find these credentials?

Portal ID / Portal Key
Account ID
Options Defined by You:
Request Method How do you want to request your payments? Choose between "Pre-authorization" and "Authorization". This option is not available for Prepayment.
Additional Settings To set up additional charges or discounts, read Understanding additional fees of a payment

 Which Transaction Type should I use?

1.2 Setting up PAYONE at Shopgate

To set up PAYONE as a payment provider, please complete the following steps:

  1. Log in to your Shopgate Admin page. Click on Settings from the menu bar, then select Payment.
  2. In section Add payment method start typing PAYONE, and select the type of payment you accept from the list. If you accept more than one type of payment, repeat the steps until all have been added.
  3. In the pop-up window enter your PAYONE information. Click Save. Your account information will be verified.

Now you have successfully set up PAYONE as a payment provider for your shop. Please continue to enter shipping destinations.

 

1.3 Finding the required information

Your PAYONE account credentials can be found by following the steps here:

  1. Log on to your account at PAYONE and navigate to CONFIGURATION > PAYMENT PORTALS.

  2. Click Edit on the portal you want to use.
    ☞ If a portal has been created for Shopgate API, please select this portal.

  3. This will open your portal details. Click tab API-Parameter. Your PAYONE Merchant ID, Portal ID, Portal Key, and Account ID will be displayed here.

 

2. Entering shipping destinations

PAYONE needs to know which countries your shop ships to. In order to provide this information, follow the steps here:

  1. On your Shopgate Admin homepage click Settings from the menu bar, then select Shipping.
  2. On the Shipping page, click "+ Add a rate" and select all countries that you deliver to in section Delivery countries. If you have already configured your shipping methods, click Edit to add delivery countries. Click Save.

Now you have successfully set up your shipping destinations. Please continue to enter the Shopgate API link in your PAYONE account.

 

3. Entering Transaction URL (direct debit, invoice, prepayment)

This step is only necessary if you accept any of these payment types:

  • direct debit
  • invoice payments
  • prepayment

To enter the Shopgate Transaction URL in your PAYONE account, follow the steps here:

  1. Log on to PAYONE and navigate to CONFIGURATION > PAYMENT PORTALS. Locate the portal you want to use, and click Edit.
  2. On the portal admin page, navigate to tab Extended and enter this Shopgate API link in the text field TransactionStatus URL: https://api.shopgate.com/payment/payone
    If this field is already in use, read Where should I enter the Shopgate URL?

 

4. Adding extra fields (iDEAL, SOFORT, Giropay, Klarna Invoice)

This step is only necessary if you accept any of these payment types:

  • iDEAL
  • SOFORT
  • Giropay
  • Klarna Invoice

Your PAYONE system requires additional information for iDEAL, SOFORT, Giropay, and Klarna Invoice payments. Please contact Shopgate support at support@shopgate.com to add the respective fields described below.

4.1 iDEAL

Your customer's iDEAL Bank information is required for all iDEAL orders. Please ask your Shopgate support expert to add an extra field for entering bank information at checkout with these settings:

Field For Customer's Ideal Bank

Label iDEAL Bank
Internal Field Name ideal_bank
Form Element Type Dropdown
Options(JSON) { "ABN_AMRO_BANK" : "ABN Amro", "RABOBANK" : "Rabobank", "FRIESLAND_BANK" : "Friesland Bank", "ASN_BANK" : "ASN Bank", "SNS_BANK" : "SNS Bank", "TRIODOS_BANK" : "Triodos", "SNS_REGIO_BANK" : "SNS Regio Bank", "ING_BANK" : "ING", "KNAB_BANK" : "Knab Bank", "VAN_LANSCHOT_BANKIERS" : "van Lanschot Bank" }
Validationrules(JSON) {"required":{"rule":"notEmpty","allowEmpty":true}}
Belongs to Order / Checkout

 

4.2 SOFORT and Giropay

Your customer's IBAN and BIC are required for all SOFORT and Giropay orders. Please ask your Shopgate support expert to add 2 extra fields for entering customer's IBAN and BIC at checkout, respectively, with these settings:

Field For IBAN

Label IBAN
Internal Field Name iban
Form Element Type Input
Validationrules(JSON) {"minLength":{"rule":["userDefined","CustomValidation","minLength","16"],"allowEmpty":true}}
Belongs to Order / Checkout

 

Field For BIC

Label BIC
Internal Field Name bic
Form Element Type Input
Validationrules(JSON) {"minLength":{"rule":["userDefined","CustomValidation","minLength","8"],"allowEmpty":true}}
Belongs to Order / Checkout

 

4.3 Klarna Invoice

Your customer's birthday and phone number are required for all Klarna Invoice orders. Please ask your Shopgate support expert to add 2 extra fields for entering customer's birthday and phone number at checkout, respectively, with these settings:

Field For customer's phone number

Label Phone
Internal Field Name phone
Form Element Type Input
Validationrules(JSON) {"minLength":{"rule":["userDefined","CustomValidation","minLength","7"],"allowEmpty":true}}
Belongs to User

 

Field For customer's birthday

Option 1 Label Birthday
Internal Field Name birthday
Form Element Type Date
Validationrules(JSON) {"formattedDate":{"rule":["userDefined","CustomValidation","formattedDate"],"allowEmpty":true}}
Belongs to User
Option 2

Add a mandatory birthday field to the registration form

  • This will require ALL of your customers to enter a birthday at registration.
  • Please ask your support personnel to check the option "Show mandatory birthday field", but no extra field needs to be added.

 

Note that you only need to add the field(s) you need. If all fields mentioned in this chapter have been added, this section will appear at checkout:

 

5. Frequently Asked Questions (FAQ)

5.1 Why couldn't I get payments from my mobile orders?

This is likely because the Transaction URL is not set up correctly. To make sure to get payments in the future, please follow Chapter 3. Entering Shopgate Transaction URL

 

5.2 I already have a TransactionStatus URL. Where should I enter the Shopgate URL?

If a TransactionStatus URL for your desktop shop is already entered here, and you are accepting direct debit, invoice payments, and/or prepayment via PAYONE, please create a new payment portal for the Shopgate TransactionStatus URL:

 

1. Navigate to CONFIGURATION > PAYMENT PORTALS and click Add portal.



2. In the new portal, navigate to tab Extended.

  • In the field TransactionStatus URL, enter the Shopgate API URL: https://api.shopgate.com/payment/payone
  • In all other fields, enter exact same info as your other (main) portal.



3. After the new portal for Shopgate is created, make sure to enter the Merchant ID, Portal ID, Portal Key, and Account ID from this portal (in API-Parameter tab) when adding PYAONE at Shopgate

 

5.3 Do I need to refund my customers manually after I cancel an order?

No, you don't need to refund the money manually via your PAYONE account. The refund is done automatically when you cancel an order.

 

 

Comments