Paypal

Countries & currencies

Supported countries

• Afghanistan
• Albania
• Algeria
• American Samoa
• Andorra
• Angola
• Anguilla
• Antigua and Barbuda
• Argentina
• Armenia
• Aruba
• Australia
• Austria
• Azerbaijan
• Bahamas
• Bahrain
• Bangladesh
• Barbados
• Belarus
• Belgium
• Belize
• Benin
• Bermuda
• Bhutan
• Bolivia
• Bonaire, Saba and Sint Eustatius
• Bosnia and Herzegovina
• Botswana
• Brazil
• Brunei
• Bulgaria
• Burkina Faso
• Burundi
• Cambodia
• Cameroon
• Canada
• Cape Verde
• Cayman Islands
• Central African Republic
• Chad
• Chile
• China
• Colombia
• Comoros
• Congo (Democratic Republic)
• Congo (Republic)
• Cook Islands
• Costa Rica
• Croatia
• Cyprus
• Czech Republic
• Denmark
• Djibouti
• Dominican Republic
• Dominica
• Ecuador
• Egypt
• El Salvador
• Eswatini
• Equatorial Guinea
• Eritrea
• Estonia
• Ethiopia
• Falkland Islands
• Faroe Islands
• Fiji
• Finland
• France
• French Guiana
• French Polynesia
• Gabon
• Gambia
• Georgia
• Germany
• Ghana
• Gibraltar
• Greece
• Greenland
• Grenada
• Guadeloupe
• Guam
• Guatemala
• Guinea
• Haiti
• Honduras
• Hong Kong
• Hungary
• Iceland
• India
• Indonesia
• Iraq
• Ireland
• Israel
• Italy
• Ivory Coast
• Jamaica
• Japan
• Jordan
• Kazakhstan
• Kenya
• Kiribati
• Kuwait
• Kyrgyzstan
• Laos
• Latvia
• Lebanon
• Lesotho
• Liberia
• Libya
• Liechtenstein
• Lithuania
• Luxembourg
• Macao
• Macedonia
• Madagascar
• Malawi
• Malaysia
• Maldives
• Mali
• Malta
• Marshall Islands
• Martinique
• Mauritania
• Mauritius
• Mexico
• Micronesia
• Moldova
• Monaco
• Mongolia
• Montenegro
• Morocco
• Mozambique
• Myanmar
• Namibia
• Nauru
• Nepal
• Netherlands Antilles
• Netherlands
• New Caledonia
• New Zealand
• Nicaragua
• Nigeria
• Niger
• Niue
• Norfolk Island
• Northern Mariana Islands
• Norway
• Oman
• Pakistan
• Palau
• Panama
• Papua New Guinea
• Paraguay
• Peru
• Philippines
• Poland
• Portugal
• Puerto Rico
• Qatar
• Réunion
• Romania
• Russia
• Rwanda
• Saint Helena
• Saint Kitts and Nevis
• Saint Lucia
• Saint Pierre and Miquelon
• Saint Vincent and The Grenadines
• Samoa
• San Marino
• São Tomé and Príncipe
• Saudi Arabia
• Senegal
• Serbia
• Seychelles
• Sierra Leone
• Singapore
• Slovakia
• Slovenia
• Solomon Islands
• Somalia
• South Africa
• South Korea
• Spain
• Sri Lanka
• Sudan
• Suriname
• Sweden
• Switzerland
• Taiwan
• Tajikistan
• Tanzania
• Thailand
• Togo
• Tonga
• Trinidad and Tobago
• Tunisia
• Turkmenistan
• Turks and Caicos Islands
• Tuvalu
• Uganda
• Ukraine
• United Arab Emirates
• United Kingdom
• United States
• Uruguay
• Uzbekistan
• Vanuatu
• Vatican City
• Venezuela
• Vietnam
• Virgin Islands (British)
• Virgin Islands (U.S.)
• Yemen
• Zambia
• Zimbabwe

Supported currencies

• Australian dollar (AUD)
• Brazilian real (BRL)
• Canadian dollar (CAD)
• Czech koruna (CZK)
• Danish krone (DKK)
• Euro (EUR)
• Hong Kong dollar (HKD)
• Hungarian forint (HUF)
• Israeli new shekel (ILS)
• Japanese yen (JPY)
• Malaysian ringgit (MYR)
• Mexican peso (MXN)
• New Taiwan dollar (TWD)
• New Zealand dollar (NZD)
• Norwegian krone (NOK)
• Philippine peso (PHP)
• Polish zloty (PLN)
• Pound sterling (GBP)
• Russian ruble (RUB)
• Singapore dollar (SGD)
• Swedish krona/kronor (SEK)
• Swiss franc (CHF)
• Thai baht (THB)
• United States dollar (USD)

Integration

Redirect your customers to the Paypal payment portal via our Hosted Checkout Page. Find a high level overview in the "Process flows" chapter.

Our platform allows both Express Checkout Mark and Express Checkout Shortcut mode. Depending on the mode, , differences apply:

• Express Checkout Mark
• Express Checkout Shortcut

Express Checkout Mark mode

Add the following properties to a standard CreateHostedCheckout request:

{
   "order": {
      "amountOfMoney": {
         "currencyCode": "EUR",
         "amount": 1000
      }
   },
   "hostedCheckoutSpecificInput": {
      "returnUrl": "https://yourReturnURL.com"
   },
   "redirectPaymentMethodSpecificInput": {
      "paymentProduct840SpecificInput": {
         "addressSelectionAtPayPal": false
      },
      "PaymentProductId": "840"
   }
}

Express Checkout Shortcut mode

Add the following properties to a standard CreateHostedCheckout request:

{
   "order": {
      "amountOfMoney": {
         "currencyCode": "EUR",
         "amount": 1000
      }
   },
   "hostedCheckoutSpecificInput": {
      "returnUrl": "https://yourReturnURL.com"
   },
   "redirectPaymentMethodSpecificInput": {
      "paymentProduct840SpecificInput": {
         "addressSelectionAtPayPal": true
      },
      "PaymentProductId": "840"
   }
}

Process flows

1. Your customers finalise an order in your shop and select PayPal.
2. You send one of these CreateHostedCheckout requests (Express Checkout Mark or Express Checkout Shortcut) to our platform.
3. You redirect your customers via the redirectUrl to the PayPal portal. They confirm the order with their login credentials (email address and password).
4. We receive the transaction result.
5. We redirect your customer to your returnUrl
6. You request the transaction result from our platform via GetHostedCheckout or receive the result via webhooks.
7. If the transaction was successful, you can deliver the goods / services.

Testing

Refer to our Test cases for test data and detailed instructions.

Additional information

To offer this payment method to your customers, make sure to

• Sign an acquiring contract with PayPal and activate the payment method in your PSPID. We are happy to assist you.
• Create PayPal test / live accounts and link them to our platform.
• Set up your PayPal account.
• Configure the payment method in your PSPID.

Check out the following chapters to get all set!

Create PayPal test/live accounts

Both our and PayPal's test environment offer you to test your integration before going live.
Linking your PAYONE E-Payment test account to the PayPal Sandbox with dedicated test credentials allow you to stage scenarios in a safe and realistic way. Create your test account on our platform and learn here how to set up the PayPal Sandbox for end-to-end testing.

Once you are done testing, create your live account on our platform and your PayPal live account and configure them both.

Configure PayPal account

To link your PAYONE E-Payment account with your PayPal (Business) account, you need to allow PayPal to access your API credentials. To do so, follow these steps:

1. Login to your Paypal account with your PayPal Business e-mail address in either the sandbox or live environment.
2. Enter the following credentials in field "Third Party Permission Username". Click then on "Lookup":
   

   Environment	API username
   Test	jbpPSP_1220517189_biz_api1.ogone.com
   Production	support_api1.v-psp.com

3. Tick the following boxes and click then "Add":
   • "Use Express Checkout to process payments".
   • "Issue a refund for a specific transaction".
   • "Authorize and capture your PayPal transactions".
   • "Obtain information about a single transaction".
   • "Search your transactions for items that match specific criteria and display the results".

Once you have configured your PayPal account, activate the payment method in the Merchant Portal.

Configure Merchant Portal

To activate PayPal in your account, follow these steps: 

1. Login to the Merchant Portal. Go to Business > Payment methods > PayPal. 
2. In "How to activate PayPal", click on "Create and login to your PayPal account". 
3. You are redirected to the PayPal Platform. If you do not have a PayPal account yet, create one using the Integrated Sign Up (ISU). If you already have an account, login via the ISU.
4. Grant PayPal permission to connect your PayPal account with our platform by clicking on the "Allow" button. Click on the "Return" button to go back to the Merchant Portal. 
5. Go to Business > Payment methods > PayPal. Check in "
6. How to activate PayPal" that the "PayPal Payer ID" field has been filled in. Click on the "Activate PayPal".

The payment method will now be available on your account and to your customers.