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 Model.Checkout.Amount("SEK", 1000);
    var details = new Model.Checkout.DefaultPaymentMethodDetails{
      Type = "swish"
    };
    var paymentRequest = new Adyen.Model.Checkout.PaymentRequest
    {
      Reference = "YOUR_ORDER_NUMBER",
      Amount = amount,
      CountryCode = "SE",
      MerchantAccount = "YOUR_MERCHANT_ACCOUNT",
      PaymentMethod = details,
      Channel = "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 notification 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 notification webhook informing you of the payment result.

Test and go live

When you make a Swish payment in the test environment, the payment is immediately approved.
Check the status of Swish test payments in your Customer Area > Transactions > Payments.

Refused payments and other scenarios must be tested in your live environment using real payment details and small amounts.

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