Перейти к содержанию

Apple Pay Alternative

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

Оплата

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет в MerchantPay запрос оплаты со значением apple_pay_alt в параметре method.type.
  3. MerchantPay возвращает URL страницы оплаты в параметре redirect_url.
  4. Торговец перенаправляет покупателя на этот URL. Покупатель выбирает Apple Pay и подтверждает оплату.
  5. MerchantPay отправляет торговцу автоматическое уведомление с финальным статусом оплаты. Торговец также может отправить запрос получения статуса транзакции.

Info

Доступные валюты зависят от настроек шлюза. Настройки по умолчанию включают EUR, GBP и PLN.

Запрос

Отправьте запрос оплаты со следующими данными:
object
amount
обязательный
 bigInteger
Сумма транзакции в минимальных денежных единицах, например, 1000 (10 единиц выбранной валюты).
currency
обязательный
 string (3)
Валюта транзакции в формате ISO 4217 alpha-3.
description
обязательный
 string (512)
Описание заказа.
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
ip
 string
IP-адрес покупателя.
language
 string (2)
Язык покупателя.
object
Секция параметров способа оплаты.
type
обязательный
 string
apple_pay_alt.
object
Секция информации о покупателе.
first_name
обязательный
 string (60)
Имя покупателя.
last_name
обязательный
 string (60)
Фамилия покупателя.
email
обязательный
 string
Адрес электронной почты покупателя.
external_id
 string (128)
Идентификатор покупателя в системе торговца.
birth_date
 string
Дата рождения покупателя в формате ISO 8601 (YYYY-MM-DD).
phone
 string (18)
Номер телефона покупателя, включая код страны.
country
обязательный
 string (2)
Страна покупателя в формате ISO 3166-1 alpha-2.
address
обязательный
 string (300)
Платёжный адрес покупателя.
city
обязательный
 string (50)
Город покупателя.
state
 string (40)
Штат или регион покупателя.
zip
обязательный
 string (12)
Почтовый индекс покупателя.
Пример запроса 
{
    "request": {
        "amount": 1000,
        "currency": "EUR",
        "description": "Order 1234",
        "return_url": "https://example.com/return",
        "ip": "203.0.113.10",
        "language": "en",
        "method": {
            "type": "apple_pay_alt"
        },
        "customer": {
            "first_name": "Joan",
            "last_name": "Collins",
            "email": "joan@example.com",
            "external_id": "customer-1234",
            "birth_date": "1990-05-14",
            "phone": "+447700900123",
            "country": "GB",
            "address": "10 Downing Street",
            "city": "London",
            "zip": "SW1A 1AA"
        }
    }
}
Ответ

Перенаправьте покупателя на URL из параметра redirect_url. Возврат покупателя на сайт торговца не подтверждает статус оплаты. Для получения результата используйте автоматическое уведомление или запрос получения статуса транзакции.

Пример ответа 
{
    "transaction": {
        "uid": "8b58d761-cea0-484b-9509-9c07d38569b8",
        "type": "payment",
        "status": "pending",
        "amount": 1000,
        "currency": "EUR",
        "description": "Order 1234",
        "created_at": "2026-10-21T13:38:32Z",
        "updated_at": "2026-10-21T13:38:33Z",
        "method_type": "apple_pay_alt",
        "receipt_url": "https://backoffice.universepay.eu/customer/transactions/8b58d761-cea0-484b-9509-9c07d38569b8/283251d7fa6c5fe98d593752ca41b3a84e5525dc1433c801673465fbab960946?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 6749,
            "ref_id": "a338ffaaff3f44cb8715e7d127a3b1d9",
            "message": "Transaction was initialized."
        },
        "apple_pay_alt": {
            "type": "apple_pay_alt"
        },
        "customer": {
            "zip": "SW1A 1AA",
            "city": "London",
            "email": "joan@example.com",
            "phone": "+447700900123",
            "address": "10 Downing Street",
            "country": "GB",
            "last_name": "Collins",
            "birth_date": "1990-05-14",
            "first_name": "Joan",
            "external_id": "customer-1234",
            "ip": "203.0.113.10"
        },
        "manually_corrected_at": null,
        "version": 2,
        "message": "Transaction was initialized.",
        "test": false,
        "language": "en",
        "billing_address": {
            "zip": "SW1A 1AA",
            "city": "London",
            "email": "joan@example.com",
            "phone": "+447700900123",
            "address": "10 Downing Street",
            "country": "GB",
            "last_name": "Collins",
            "birth_date": "1990-05-14",
            "first_name": "Joan"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}

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

Запрос

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