Swish

Вариант интеграции APR

Оплата

Процесс оплаты

Покупатель инициирует оплату на сайте торговца.
Торговец отправляет PaySage.io запрос оплаты.
PaySage.io присылает в ответе торговцу ссылку на страницу оплаты с QR-кодом.
Торговец перенаправляет покупателя на страницу оплаты.
Покупатель сканирует QR-код и подтверждает платёж в приложении Swish.
PaySage.io отправляет торговцу автоматическое уведомление с финальным статусом платежа.

Info

Этот вариант интеграции поддерживает только валюту SEK.

Запрос

Отправьте запрос оплаты, указав следующие данные:

object

amount

обязательный

bigInteger
Сумма транзакции в минимальных денежных единицах, например, 50000 (500 SEK).

currency

обязательный

string
SEK.

description

обязательный

string
Описание заказа.

return_url

обязательный

string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.

ip

обязательный

string
IP-адрес покупателя.

object
Секция параметров способа оплаты.

type

обязательный

string
swish.

object
Секция информации о покупателе.

external_id обязательный	string (255) Уникальный идентификатор покупателя в системе торговца.
email обязательный	string Адрес электронной почты покупателя.
phone обязательный	string (200) Номер телефона покупателя с кодом страны без `+` и без пробелов.
first_name обязательный	string (60) Имя покупателя.
last_name обязательный	string (60) Фамилия покупателя.
birth_date обязательный	string Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).
city обязательный	string (120) Город покупателя.
address обязательный	string (510) Адрес покупателя.
zip обязательный	string (40) Почтовый индекс покупателя. Например, `211 41`.

Пример запроса

{
  "request": {
    "amount": 50000,
    "currency": "SEK",
    "description": "Beställning 1001",
    "return_url": "https://merchant.example.com/return",
    "ip": "192.0.2.10",
    "customer": {
      "external_id": "se-customer-1001",
      "email": "elsa.svensson@example.com",
      "phone": "46701234567",
      "first_name": "Elsa",
      "last_name": "Svensson",
      "birth_date": "1990-05-22",
      "city": "Malmö",
      "address": "Exempelgatan 12",
      "zip": "211 41"
    },
    "method": {
      "type": "swish"
    }
  }
}

Ответ

Отправьте покупателя на URL, указанный в параметре form.action. Покупатель сканирует QR-код на странице оплаты и подтверждает платёж в приложении Swish. Финальный статус платежа придёт в автоматическом уведомлении.

Пример ответа

{
    "transaction": {
        "uid": "0695636c-d246-47ef-a461-c8971ef05fef",
        "type": "payment",
        "status": "pending",
        "amount": 50000,
        "currency": "SEK",
        "description": "Beställning 1001",
        "created_at": "2026-10-02T10:03:57Z",
        "updated_at": "2026-10-02T10:03:57Z",
        "method_type": "swish",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/0695636c-d246-47ef-a461-c8971ef05fef/c8c697af054ec799290fa6d6b5d043b2f818d373b148f03d4174652b5cf1bcfd",
        "payment": {
            "status": "pending",
            "gateway_id": 7494,
            "ref_id": "511606409061",
            "message": "Transaction was initialized."
        },
        "swish": {
            "type": "swish"
        },
        "customer": {
            "zip": "211 41",
            "city": "Malmö",
            "email": "elsa.svensson@example.com",
            "phone": "46701234567",
            "address": "Exempelgatan 12",
            "last_name": "Svensson",
            "birth_date": "1990-05-22",
            "first_name": "Elsa",
            "external_id": "se-customer-1001",
            "ip": "192.0.2.10"
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": false,
        "billing_address": {
            "zip": "211 41",
            "city": "Malmö",
            "email": "elsa.svensson@example.com",
            "phone": "46701234567",
            "address": "Exempelgatan 12",
            "last_name": "Svensson",
            "birth_date": "1990-05-22",
            "first_name": "Elsa"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "skipped"
        },
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}