Как отобразить только Digital Wallets (Apple Pay / Google Pay™)

Для показа страницы только с кошельками используйте специальный роут /checkout/pl/{payment_link_id}/dw

URL структура

https://checkout.plexypay.com/checkout/pl/{payment_link_id}/dw?initiativeContext=yourdomain.com

Этот роут автоматически:

Получает платёжную сессию по ID платёжной ссылки

Перенаправляет на /embedded/{session_token}/dw с параметром walletType=all

Параметры URL

initiativeContext (опционально):

Домен родительского сайта для валидации Apple Pay при встраивании через iframe

Пример: example.com

Автоматически передаётся в embedded роут

Примеры использования

Структура postMessage

Когда платёж завершается, checkout отправляет сообщение родительскому окну/приложению.

Формат сообщения

{
  "type": "APPLE_PAY_COMPLETED",
  "action": "payment",
  "timestamp": "2026-01-08T12:34:56.789Z",
  "data": {
    "orderId": "order_123",
    "amount": 1500,
    "currency": "USD",
    "success": true,
    "error": null,
    "errorCode": null
  }
}

Типы событий

PAYMENT_SUCCESS - платёж успешен

PAYMENT_FAILURE - платёж не прошёл

PAYMENT_CANCELLED - отменён пользователем

APPLE_PAY_COMPLETED - Apple Pay завершён

GOOGLE_PAY_COMPLETED - Google Pay™ завершён

3DS_STARTED - началась 3D Secure аутентификация

3DS_COMPLETED - 3DS завершена

SESSION_EXPIRED - сессия истекла

BACK_TO_STORE - возврат в магазин

Как получить сообщение

В iframe (веб)

В iOS WKWebView

В Android WebView

В React Native

Обработка ошибок

При ошибках роут автоматически редиректит на /result/error:

404 - неверный ID платёжной ссылки → invalid_payment_session

422 - платёжная ссылка истекла → payment_link_expired

Web iFrame

Как отобразить только Digital Wallets (Apple Pay / Google Pay™)#

URL структура#

Параметры URL#

Примеры использования#

Структура postMessage#

Формат сообщения#

Типы событий#

Как получить сообщение#

В iframe (веб)#

В iOS WKWebView#

В Android WebView#

В React Native#

Обработка ошибок#