Setting up QuickPay
Guide to setting up QuickPay as a payment gateway on your Shoporama online shop. Supports Dankort, MobilePay, Visa, Mastercard and many more.
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
- Go to quickpay.net and create an account
- You must also have an acquirer agreement with e.g. Clearhaus to receive card payments
- Connect your acquirer in QuickPay under Settings → Acquirers
Find your keys in QuickPay
You need two keys from QuickPay:
- Log in to QuickPay and go to Settings → Integrations
- Private key - click on the key icon next to 'Private key' to see the key
- API user key - click on the key icon next to 'API user' to see the API key
Setting up in Shoporama
- Log in to Shoporama and go to Settings → Payment gateways
- Click Create new payment gateway and select Quickpay
- Give your gateway a name, for example "Card payment" or "MobilePay"
- 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-paymentsetc. See QuickPay's list of payment methods - Language - the language of the payment page, e.g.
dafor Danish orenfor 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 collected when the order is marked as shipped or picked up
- Add invoice data - includes order data in the payment window (required for Klarna)
- Add mobile number - pre-fills the customer's mobile number in the MobilePay window
- Enable MobilePay Checkout - lets the customer pay with MobilePay Checkout, where the address is automatically retrieved from MobilePay
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 cardmethod - Gateway 2: "MobilePay" with the
mobilepaymethod - Gateway 3: "Apple Pay" with the
apple-paymethod
3D Secure
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
- Klarna - requires invoice data to be included
- Payment links - send payment links to customers from the order page
- Capture - capture payment manually or automatically upon shipment
- Refund - refund in full or in part directly from Shoporama
- Cancel - cancel a payment that has not yet been captured
- Subscriptions - support 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 cheating with paid amounts.
Help Center
If you need help with the setup, you are welcome to contact us at support@shoporama.dk.