Setting up QuickPay

QuickPay is one of the most popular Danish payment gateways and is used by thousands of webshops. Shoporama has a deep integration with QuickPay that supports most payment methods, subscriptions, capture, refund and much more.

Create a QuickPay account

1. Go to quickpay.net and create an account
2. You must also have an acquirer agreement with e.g. Clearhaus to receive card payments
3. Connect your acquirer in QuickPay under Settings " Acquirers

Find your keys in QuickPay

You need two keys from QuickPay:

1. Log in to QuickPay and go to Settings " Integrations
2. Private key. Click on the key icon next to 'Private key' to see the key
3. API user key. Click on the key icon next to 'API user' to see the API key

Setting up in Shoporama

1. Log in to Shoporama and go to Settings " Payment gateways
2. Click Create new payment gateway and select Quickpay
3. Give your gateway a name, for example "Card payment" or "MobilePay"
4. Click Save

Configuration

Fill in the following fields:

• Private key. Your private key from QuickPay (used to verify callbacks)
• API key. Your API user key from QuickPay (used for capture, refund etc.)
• Payment methods. Comma-separated list of methods, e.g. creditcard, mobilepay, apple-pay, klarna-payments etc. See QuickPay's list of payment methods
• Language. The language of the payment page, e.g. da for Danish or en for English
• Branding. Optional branding ID from QuickPay if you have created a branding theme
• Text on statement. Text that appears on the customer's bank statement (Clearhaus only, max 22 characters)

Settings

• Automatically collect on shipment. The amount is automatically charged when the order is marked as shipped or picked up
• Add invoice data. Includes order data in the payment window (required for Klarna and PayPal)
• Add mobile number. Pre-fills the customer's mobile number in the MobilePay window
• Get customer address from MobilePay/PayPal. Lets the customer select the address directly in MobilePay or PayPal, so the address is returned to Shoporama after payment. Note that the setting applies to both MobilePay and PayPal simultaneously

Multiple payment methods

If you want to offer multiple payment options (e.g. both card payment and MobilePay), simply create multiple payment gateways in Shoporama, one for each type. They all use the same QuickPay account, but with different payment methods.

Example:

• Gateway 1: "Card payment" with the credit card method
• Gateway 2: "MobilePay" with the mobilepay method
• Gateway 3: "Apple Pay" with the apple-pay method

PayPal via QuickPay

PayPal is phasing out their old checkout and moving all transactions to PayPal Payments (PPCP). If you receive PayPal via QuickPay, you don't need to switch to a new gateway in Shoporama. Instead, you upgrade the agreement with QuickPay so that payments are now routed via PPCP. PayPal customers are often loyal repeat customers with higher basket averages, so a closed PayPal button means lost revenue from day one. The switch is a deadline task.

How to get started

1. Log in to QuickPay Manager and create a PayPal Payments agreement under the acquirer settings. Follow QuickPay's on-screen instructions.
2. PayPal must approve the agreement before it becomes active. Contact PayPal if the approval takes a while.
3. In Shoporama, create a separate QuickPay gateway dedicated to PayPal. Leave Payment methods with exactly paypal. The actual routing to PPCP is controlled by QuickPay, so there is no separate "ppcp" value to set in Shoporama.
4. Turn on Add invoice data on the PayPal gateway. Without it, order lines and addresses will not be sent and PayPal will often reject the payment.
5. Enable Get customer address from MobilePay/PayPal so that Shoporama gets the shipping and invoice address back from PayPal after payment. Note that this setting also enables address retrieval for MobilePay.

Toggle: Use PayPal 2.0 format

The Use PayPal 2.0 format option only becomes active if you have also enabled Add invoice data and only have PayPal as a payment method on the gateway. When enabled, Shoporama will distribute any discounts into the product prices themselves instead of sending them as separate discount lines to PayPal. This is a format detail for how order lines are transferred to PayPal and has nothing to do with PPCP.

For most stores, the recommendation is: leave the setting as it is. Only turn it on if you experience problems with discounts or voucher codes on your PayPal orders.

Checklist when switching from legacy PayPal to PPCP

• The PayPal Payments agreement is created in QuickPay and approved by PayPal.
• PayPal is set up as a standalone QuickPay gateway in Shoporama with PayPal as the only payment method.
• Add invoice data and Get customer address from MobilePay/PayPal are enabled.
• Make a real minimum payment with your own PayPal login (not just sandbox) and confirm that the order lands correctly in Shoporama, including address from PayPal.
• Refund the test payment from the order and check that the refund goes through with PayPal.
• Check that the order confirmation email shows PayPal as the payment method.
• Check that the entry is posted correctly in e-conomic, Dinero or Billy if you use an accounting integration.
• Test the entire flow on mobile. PayPal conversion is typically highest there.
• Only turn off the old PayPal integration when the new one is confirmed live.

3D Secure

If you want to activate 3D Secure, add 3d- in front of the payment method. For example, change credit card to 3d-creditcard. 3D Secure is a requirement from most card issuers and reduces fraud.

Supported features

• Card payment. Visa, Mastercard, Dankort, JCB, Diners and more
• MobilePay. Incl. MobilePay Checkout with address retrieval
• Apple Pay. Requires activation in QuickPay and Clearhaus
• PayPal Payments (PPCP). The new PayPal solution routed via QuickPay
• Klarna. Requires invoice data to be included
• Payment links. Send payment links to customers from the order page
• Capture. Collect payment manually or automatically upon shipment
• Refund. Fully or partially refund directly from Shoporama
• Cancel. Cancel a payment that has not yet been collected
• Subscriptions. Supports recurring payments
• REST API. Create payment links via Shoporama's REST API

Security and security

All callbacks from QuickPay are verified with a checksum based on your private key. The amount in the callback is compared to the order amount, so there is no possibility of cheating with paid amounts.

Frequently asked questions

Will PayPal stop working in my shop if I do nothing?

Yes, eventually. PayPal is phasing out the old checkout. If you receive PayPal via QuickPay, QuickPay will take care of moving you over to PayPal Payments (PPCP). You need to contact QuickPay yourself and confirm that the agreement will be upgraded. In the Shoporama admin itself, you do not need to change anything in the current setup.

How do I know if we've already switched to PPCP?

Log in to quickpay.net and go to the acquirer settings. Here you can see if the PayPal agreement is listed as PayPal Payments (the new one) or an old type. If in doubt, write to QuickPay support. The customer will not notice any difference in the checkout, so you can't see it from outside the shop.

Should I change the "Payment methods" field to paypal, ppcp or similar?

No, you don't. Leave the field with exactly paypal. There is no "ppcp" value in Shoporama. The routing to PPCP is completely controlled on the QuickPay side as soon as your PayPal Payments agreement is activated. So you don't need to fiddle with the field.

What does "Use PayPal 2.0 format" actually do and should I enable it?

The setting has nothing to do with PPCP. It controls how discounts are sent to PayPal: when enabled, the discount is distributed into the product prices instead of being sent as a separate discount line. It is only active if "Add invoice data" is enabled AND you only have PayPal as a payment method on the gateway. Our recommendation: leave it as it is, unless you experience specific discount issues.

Can I merge PayPal with card payment in the same QuickPay gateway?

Don't do this. Create a standalone QuickPay gateway for PayPal with PayPal as the only payment method. If you mix, PayPal's format won't work properly and you risk declined payments. It's also easier to troubleshoot when PayPal is on its own.

Does switching to PPCP affect my bookkeeping or VAT management?

No, it doesn't. The cash flow is the same as before: QuickPay settles collectively with your shop, not PayPal directly. VAT, chart of accounts and bookkeeping will not change. If you use e-conomic, Dinero or Billy, the order is automatically booked as before. The change is purely technical.

Will the customer see anything different in the checkout after the switch?

No, not in the Shoporama checkout itself. The customer chooses PayPal as before and gets the same PayPal button. The difference is on the PayPal side, where the customer can now meet more payment options via PayPal's "smart payment buttons". This is managed by QuickPay and PayPal, so you don't need to update anything in theme or marketing.

What do I do if a customer reports that PayPal is not working?

First, check the order list in the Shoporama admin for failed orders from that customer. Then make a test payment of a small amount with your own PayPal login and refund it afterwards. If the test works, the error is most likely with the customer. If the test also fails, write to support@shoporama.dk with the order number and error message.

Help Center

If you need help with the setup, you are welcome to contact us at support@shoporama.dk.