Swish

Features
Method	Async - GET Redirect / Async
Merchant countries	Europe
Consumer countries	Sweden
Processing currencies	SEK
Increments	-
Captures	-
Partial/Multiple partial captures	-
Cancels	-
Partial/Multiple partial cancels	-
Refunds	✅
Partial/Multiple partial refunds	✅
Recurring	-
Installments	-
Credits	-
Disputes	-
Max Amount	999999999999.99
Min Amount	0.01
Account verification	-

Swish is a popular payment method in Sweden, allowing users to make payments using their bank account. Payments are authorized quickly and easily within the user’s Swish mobile application, providing a hassle-free and secure payment experience.

There are two ways to make Swish payments:

• self_phone_number_collection: when the phone number is handled by the merchant. The merchant sends the phone number in the request and no redirection step is required.

• redirection: the returned redirection URL is a link to complete the purchase.

Redirection payment flow

Payment flow

Payment

Request

{
    "processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
    "merchantReference": "2d34c62d-7c26-45cd-9ef1-6419aa329565",
    "amount": {
        "value": 200,
        "currency": "sek"
    },
    "paymentMethod": {
        "type": "swish",
        "swish": {
            "flowType": "redirection",
            "returnUrl": "https://merchant.site/complete-payment"
        }
    }
}

Response

{
    "id": "27yiW9MgzBtwiodreuNOXk0rtIw",
    "merchantReference": "2d34c62d-7c26-45cd-9ef1-6419aa329565",
    "status": "pending",
    "trackingUrl": "/v1/tracks/payments/{trackId}",
    "reason": {
        "code": "required_next_step",
        "description": "An additional step is needed to complete the payment."
    },
    "nextStep": {
        "type": "redirect",
        "redirect": {
            "method": "get",
            "url": "https://payment.method/complete"
        }
    }
}

Self phone number collection payment flow

Payment flow

Payment

Request

{
    "processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
    "merchantReference": "2d34c62d-7c26-45cd-9ef1-6419aa329565",
    "amount": {
        "value": 200,
        "currency": "eur"
    },
    "paymentMethod": {
        "type": "swish",
        "swish": {
            "flowType": "self_phone_number_collection",
            "returnUrl": "https://merchant.site/complete-payment",
            "consumer": {
                "name": "John Doe",
                "phoneNumber": "+46700000000"
            }
        }
    }
}

Response

{
    "id": "27yiW9MgzBtwiodreuNOXk0rtIw",
    "merchantReference": "c2d34c62d-7c26-45cd-9ef1-6419aa329565",
    "status": "pending",
    "trackingUrl": "/v1/tracks/payments/{trackId}",
    "reason": {
        "code": "waiting_confirmation",
        "description": "Confirmation is pending for the non-instant operation."
    }
}