Samsung Pay Alternative

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

Процесс проведения оплаты

Покупатель инициирует оплату на сайте торговца.
Торговец отправляет запрос оплаты в Freepayment.
Freepayment присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
Продавец перенаправляет покупателя на страницу из параметра form.action из ответа Freepayment. Если в настройках шлюза (настраивается менеджером) включена опция Все мобильные оплаты, а также активированы способы оплаты Google Pay Alternative и/или Apple Pay Alternative, то на странице оплаты покупателю будут отображаться все активированные мобильные способы оплаты.
Покупатель завершает оплату.
Freepayment отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у Freepayment с помощью запроса получения статуса транзакции. Если транзакция успешна, уведомление или ответ на запрос статуса могут содержать параметр samsung_pay_alt.account_number с маской карты.

Info

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

Оплата

Запрос

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

object

return_url

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

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

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

type

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

string
samsung_pay_alt

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

{
    "request": {
        "amount": 500,
        "currency": "EUR",        
        "test": true,
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "samsung_pay_alt"
        }
    }
}

Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

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

{
    "transaction": {
        "uid": "da1a6777-4f15-45ef-916d-4afd475c3eb5",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2026-07-10T12:24:52Z",
        "updated_at": "2026-07-10T12:24:53Z",
        "method_type": "samsung_pay_alt",
        "receipt_url": "https://account.freepayment.online/customer/transactions/da1a6777-4f15-45ef-916d-4afd475c3eb5/81b910896cf7698973befc0952b2ef9d575c99950450aac2827f3d7d2c923480",
        "payment": {
            "status": "pending",
            "gateway_id": 4829,
            "ref_id": "4248806",
            "message": "Sender card details entry required",
            "bank_code": 35
        },
        "samsung_pay_alt": {
            "type": "samsung_pay_alt"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Sender card details entry required",
        "test": true,
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}

Возврат средств

Запрос

Отправьте стандартный запрос возврата средств. Сумма возврата должна быть равна сумме соответствующей транзакции оплаты.