Apple Pay / Google Pay
Оплата через кошельки на платёжной странице
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Создание платежа
Базовый запрос на создание заказа, который расширяет эта страница.
Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.
Обзор
Apple Pay и Google Pay — это обычные заказы с двумя дополнительными полями:
| Поле | Тип | Описание |
|---|---|---|
extraParams | string | Выбирает кошелёк. Точное значение зависит от вашего варианта интеграции |
customer | object | Данные плательщика. Набор обязательных полей зависит от вашего варианта интеграции |
Плательщик перенаправляется на paymentLink, где ему показывается форма оплаты через кошелёк. Оплата через кошельки работает преимущественно на мобильных устройствах и в Safari (Apple Pay) или Chrome (Google Pay).
Варианты интеграции
К платформе подключено несколько провайдеров, и каждый ожидает своё значение extraParams и свой набор данных плательщика. Ваш терминал подключён к одному из вариантов ниже.
Перед интеграцией уточните у менеджера, какой вариант включён для вашего аккаунта. Неверное значение extraParams приводит к отклонению заказа.
| Вариант | Apple Pay | Google Pay | Обязательные поля customer |
|---|---|---|---|
| Стандартный | apple-pay | google-pay | country, email, firstName, lastName, ip |
| Полные данные плательщика | APPLEPAY | GOOGLEPAY | email, phone, firstName, lastName, country, city, state, postcode, address |
| Только email | apple_pay | google_pay | email |
| Email и IP | applepay | googlepay | email, ip |
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
country | string | ✅ Да | Страна плательщика, ISO 3166-1 alpha-2 |
email | string | ✅ Да | Email плательщика |
firstName | string | ✅ Да | Имя |
lastName | string | ✅ Да | Фамилия |
ip | string | ✅ Да | IP-адрес плательщика (реальный) |
curl -X POST "https://api.riopay.online/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": "1500.00",
"externalId": "order_12345",
"purpose": "Payment for order #12345",
"extraParams": "apple-pay",
"customer": {
"country": "DE",
"email": "customer@example.com",
"firstName": "John",
"lastName": "Doe",
"ip": "192.168.1.1"
}
}'Для Google Pay используйте "extraParams": "google-pay".
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
email | string | ✅ Да | Email плательщика |
phone | string | ✅ Да | Номер телефона |
firstName | string | ✅ Да | Имя |
lastName | string | ✅ Да | Фамилия |
country | string | ✅ Да | Страна, ISO 3166-1 alpha-2 |
city | string | ✅ Да | Город |
state | string | ✅ Да | Штат или регион |
postcode | string | ✅ Да | Почтовый индекс |
address | string | ✅ Да | Адрес (улица, дом) |
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"extraParams": "APPLEPAY",
"customer": {
"email": "customer@example.com",
"phone": "1999999999",
"firstName": "Jane",
"lastName": "Doe",
"country": "PT",
"city": "Maia",
"state": "Porto",
"postcode": "4450",
"address": "Rua Example 1"
}
}Для Google Pay используйте "extraParams": "GOOGLEPAY".
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
email | string | ✅ Да | Email плательщика |
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"extraParams": "apple_pay",
"customer": {
"email": "customer@example.com"
}
}Для Google Pay используйте "extraParams": "google_pay".
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
email | string | ✅ Да | Email плательщика |
ip | string | ✅ Да | IP-адрес плательщика (реальный) |
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"extraParams": "applepay",
"customer": {
"email": "customer@example.com",
"ip": "8.8.8.8"
}
}Для Google Pay используйте "extraParams": "googlepay".
Ответ
В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.
Поля объекта заказа
Рекомендации
- Передавайте реальный IP-адрес плательщика, а не вашего сервера.
- Заполняйте все обязательные поля
customerдля вашего варианта: отсутствующие поля — самая частая причина отклонений. - Тестируйте на реальных устройствах: Apple Pay не работает в симуляторах и в браузерах, отличных от Safari, на iOS.