Are you looking for test card numbers?

Would you like to contact support?

No momento, esta página não está disponível em português
Payment-method icon

Swish for API only

Add Swish to an existing API-only integration.

Accept Swish payments using our APIs, and build your own payment form to have full control over the look and feel of your checkout page.

Before you begin

These instructions explain how to add Swish to your existing API-only integration. The API-only integration works the same way for all payment methods. If you haven't yet done this integration, refer to our API-only integration guide.

Before starting your Swish integration:

  1. Make sure that you have set up your back end implementation.
  2. Add Swish in your test Customer Area.

Build your payment form for Swish

Show Swish as an available payment method in your payment form. You don't need to collect any information from the shopper in your payment form.

We provide a Swish logo which you can use on your payment form. For more information, refer to Downloading logos.

You can also submit a /paymentMethods request specifying:

  • countryCode: SE
  • amount.currency: SEK.

In the response, you receive paymentMethod.type: swish.

Make a payment

When a shopper chooses to pay with Swish mobile, you need to redirect them to the Swish app, depending on how they are accessing your site:

  • For shoppers on desktop or laptop, present a QR code.
  • For shoppers on mobile, present a button that redirects to the Swish app.
  • For shoppers on tablet, you can present a QR code or a button that redirects to the Swish app, or both.

We recommend that you use screen size to determine whether the shopper is accessing your site on mobile, desktop, or tablet.

  1. From your server, make a /payments request, providing:

    • paymentMethod.type: swish
    • returnUrl : The URL where the shopper is redirected back to after completing the payment.

    The following code sample is a /payments request for a Swish payment.

    curl https://checkout-test.adyen.com/v68/payments \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
    "shopperLocale": "en-US",
    "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
    "channel": "Web",
    "reference": "YOUR_ORDER_NUMBER",
    "amount": {
        "currency": "SEK",
        "value": 1000
    },
    "countryCode": "SE",
    "returnUrl": "https://your-company.com/checkout?shopperOrder=12xy..",
    "paymentMethod": {
        "type": "swish"
    }
}'
    # Set your X-API-KEY with the API key from the Customer Area.
adyen = Adyen::Client.new
adyen.api_key = "YOUR_X-API-KEY"
 
response = adyen.checkout.payments({
  :amount => {
    :currency => "SEK",
    :value => 1000
  },
  :reference => "YOUR_ORDER_NUMBER",
  :paymentMethod => {
    :type => "swish"
  },
  :countryCode => "SE",
  :merchantAccount => "YOUR_MERCHANT_ACCOUNT",
  :shopperLocale => "en-US",
  :channel => "Web",
  :returnUrl => "https://your-company.com/checkout?shopperOrder=12xy.."
})
    // Set YOUR_X-API-KEY with the API key from the Customer Area.
// Change to Environment.LIVE and add the Live URL prefix when you're ready to accept live payments.
    Client client = new Client("YOUR_X-API-KEY", Environment.TEST);
    Checkout checkout = new Checkout(client);

    PaymentsRequest paymentsRequest = new PaymentsRequest();

    String merchantAccount = "YOUR_MERCHANT_ACCOUNT";
    paymentsRequest.setMerchantAccount(merchantAccount);

    Amount amount = new Amount();
    amount.setCurrency("SEK");
    amount.setValue(15000L);
    paymentsRequest.setAmount(amount);

    DefaultPaymentMethodDetails paymentMethodDetails = new DefaultPaymentMethodDetails();
    paymentMethodDetails.setType("swish");
    paymentsRequest.setPaymentMethod(paymentMethodDetails);

    paymentsRequest.setShopperLocale("en-US");
    paymentsRequest.setReference("YOUR_ORDER_NUMBER");
    paymentsRequest.setReturnUrl("https://your-company.com/checkout?shopperOrder=12xy..");
    paymentsRequest.setChannel("Web");
    paymentsRequest.setCountryCode("SE");

    PaymentsResponse paymentsResponse = checkout.payments(paymentsRequest);
    // Set your X-API-KEY with the API key from the Customer Area.
$client = new \Adyen\Client();
$client->setXApiKey("YOUR_X-API-KEY");
$service = new \Adyen\Service\Checkout($client);

$params = array(
  "amount" => array(
    "currency" => "SEK",
    "value" => 1000
  ),
  "reference" => "YOUR_ORDER_NUMBER",
  "paymentMethod" => array(
    "type" => "swish"
  ),
  "countryCode" => "SE",
  "merchantAccount" => "YOUR_MERCHANT_ACCOUNT",
  "shopperLocale" => "en-US",
  "channel" => "Web",
  "returnUrl" => "https://your-company.com/checkout?shopperOrder=12xy.."
);
$result = $service->payments($params);
    #Set your X-API-KEY with the API key from the Customer Area.
adyen = Adyen.Adyen()
adyen.client.xapikey = 'YOUR_X-API-KEY'

result = adyen.checkout.payments({
   'amount': {
      'value': 1000,
      'currency': 'SEK'
   },
   'reference': 'YOUR_ORDER_NUMBER',
   'paymentMethod': {
      'type': 'swish'
   },
   'countryCode': 'SE',
   'merchantAccount': 'YOUR_MERCHANT_ACCOUNT',
   'shopperLocale': 'en-US',
   'channel': 'Web',
   'returnUrl': 'https://your-company.com/checkout?shopperOrder=12xy..'
})
    // Set your X-API-KEY with the API key from the Customer Area.
var client = new Client ("YOUR_X-API-KEY", Environment.Test);
var checkout = new Checkout(client);

var amount = new Adyen.Model.Checkout.Amount("SEK", 1000);
var details = new Adyen.Model.Checkout.DefaultPaymentMethodDetails{
  Type = "swish"
};
var paymentsRequest = new Adyen.Model.Checkout.PaymentRequest
{
  Reference = "YOUR_ORDER_NUMBER",
  Amount = amount,
  CountryCode = "SE",
  MerchantAccount = "YOUR_MERCHANT_ACCOUNT",
  PaymentMethod = details,
  Channel = Adyen.Model.Checkout.PaymentRequest.ChannelEnum.Web,
  ShopperLocale = "en-US",
  ReturnUrl = "https://your-company.com/checkout?shopperOrder=12xy.."
};

var paymentResponse = checkout.Payments(paymentsRequest);
    // Set your X-API-KEY with the API key from the Customer Area.
const {Client, Config, CheckoutAPI} = require('@adyen/api-library');
const config = new Config();
// Set your X-API-KEY with the API key from the Customer Area.
config.apiKey = '[API_KEY]';
config.merchantAccount = '[YOUR_MERCHANT_ACCOUNT]';
const client = new Client({ config });
client.setEnvironment("TEST");
const checkout = new CheckoutAPI(client);
checkout.payments({
    amount: { currency: "SEK", value: 1000 },
    paymentMethod: {
        type: 'swish'
    },
    reference: "YOUR_ORDER_NUMBER",
    merchantAccount: config.merchantAccount,
    countryCode: "SE",
    shopperLocale: "en-US",
    channel: "Web",
    returnUrl: "https://your-company.com/checkout?shopperOrder=12xy.."
}).then(res => res);

    The /payments response contains:

    • action.qrCodeData: Use this to present the QR code.
    • action.url: Use this to redirect the shopper to the Swish app.
    /payments response 
    {
    "resultCode": "Pending",
    "action": {
        "qrCodeData": "D4XJQf4wJSQWYGBUue55Wy8TiV7t_r5vC",
        "paymentMethodType": "swish",
        "type": "qrCode",
        "paymentData": "Ab02b4c0!...==",
        "url": "swish://paymentrequest?..."
    }
}

Present QR code

  1. Use the qrCodeData from the action object to render the QR code on your checkout page.
  2. When the shopper completes the payment, we'll send a webhook informing you of the payment result.

Redirect shopper

  1. Use the url from the action object to redirect the shopper to the Swish app.
  2. When the shopper completes the payment, we'll send a webhook informing you of the payment result.

Test and go live

When you make a Swish payment in the test environment, the payment is authorised within 15 seconds. You can simulate different refusal scenarios, as outlined in the Merchant Swish Simulator, by adding the error code to the shopperStatement property. For example, "shopperStatement": "FF08".

Check the status of Swish test payments in your Customer Area > Transactions > Payments.

To go live with Swish you need an agreement with one of these banks supporting Swish:

  • Swedbank
  • Handelsbanken
  • Nordea
  • SEB Bank
  • Danske bank

Make sure that your Swish bank has connected your Swish number with Adyen's technical supplier certificate - 9875158603.

To accept live Swish payments, you must submit a request for Swish in your live Customer Area.

See also