Payment Methods
See which payment methods a merchant has, activate Klarna, Swish, Vipps, MobilePay, American Express, Apple Pay and more, add their pricing to the billing plan, and deactivate methods.
Overview
The Payment Methods tab on a merchant shows every payment method the merchant has and lets you activate new ones. For most methods the merchant does not need their own agreement with the provider, because the flow goes through Surfboard.
Open the merchant from Merchants and click the Payment Methods tab. Stores have the same tab, see Payment methods per store.
Core Methods
The top of the tab lists the methods the merchant already has, such as CARD, CASH, CPOC (SoftPOS, taking card payments on a phone) and B2BINV (B2B invoice). Each shows its payment method ID and a status:
| Status | Meaning |
|---|---|
| ACTIVATED | In use |
| REGISTERED | Registered, but not yet live |
| DEACTIVATED | Switched off |
CARD, CASH and CPOC are always available and cannot be deactivated.
Additional Payment Methods
Below the core methods is the catalogue of methods you can add: Klarna, American Express, Vipps, Account to Account, MobilePay and Swish, plus Apple Pay on stores that qualify. What appears depends on your partner agreement and the merchant’s country.
Each card shows a status badge, whether the method is in the merchant’s billing plan, and an action at the bottom:
| What the card says | What you can do |
|---|---|
| Ready to activate | Click Activate |
| No billing plan — Add {method} to the merchant’s billing plan to activate it | Click Set up billing plan first, see below |
| Active | Shows the payment method ID. Click Deactivate to switch it off |
| Registered | Registered and waiting to go live |
| Previously deactivated | Click Re-activate |
| Failed | Shows why activation failed. Click Retry |
Note: Deactivate takes effect immediately. There is no confirmation step, so make sure you have the right merchant and method.
Add the method to the billing plan
A method can only be activated once the merchant’s billing plan has a price for it. When the card says No billing plan, click Set up billing plan:
- Enter the In-store pricing: Fixed %, Fixed fee and Minimum fee.
- Tick Set a different price for online payments if online payments should cost something else, and fill in the same three fields for online.
- Click Add to plan.
Fees cannot be negative, and the minimum fee must be greater than the fixed fee.
Important: The price is added to the billing plan, not to this merchant alone. The dialog tells you how many merchants are on the plan, and all of them get the new price. If the merchant has no billing plan yet, the dialog says so, and the price can’t be added until a plan is assigned.
See Billing Plans for how plans work.
Activating Methods
Click Activate on the method’s card. Most methods activate straight away; some ask for more first.
Swish
Confirm the activation. Nothing else is needed.
Klarna
Usually a confirmation is enough. Depending on your partner agreement, you may be asked for the merchant’s own Klarna Merchant ID, Username and Password.
American Express
There are two routes:
- Through Surfboard — click Get signing link and send the link to the merchant. Amex is activated once they sign. Activating again later shows the same link until it has been signed.
- Merchant has their own Amex contract — enter the merchant’s Amex MID and click Register and open ticket. Amex shows as Registered and a support ticket is opened automatically so Surfboard can complete the setup. The card links to that ticket.
Amex is activated per store. If the merchant has stores where it isn’t active yet, the card offers Activate for all stores.
Apple Pay
Apple Pay for online payments is activated on a store, not on the merchant, and only on stores whose checkout runs on their own domain with the Surfboard SDK. The merchant must host Apple’s domain association file at /.well-known/apple-developer-merchantid-domain-association on that domain; the dialog links to the file. Click Activate. If the domain changes, use Re-verify.
Dankort (Danish merchants)
For merchants in Denmark, an extra section lets you enable Dankort, the Danish domestic card, which is acquired through Nets. Enter the merchant’s Nets BAX ID and click Activate.
Set on the merchant, it applies to all stores. A store can override it with its own BAX ID from the store’s Payment Methods tab; otherwise the store inherits the merchant’s setting.
Payment Methods per Store
Each store has its own Payment Methods tab (open the store from the merchant’s Stores tab). It works the same way as the merchant tab but shows the store’s own methods. This is where you activate Apple Pay and set a store-specific Dankort BAX ID.
Related
- Billing Plans — pricing per payment method
- Stores — store details and online setup
- Merchant Management — the merchant page and its tabs
- Payment Methods — the developer guide