Расширенные методы
Примеры для расширенных методов оплаты, которым требуются дополнительные поля, такие как `customer`.
Эта страница содержит готовые примеры JSON body для различных методов оплаты: Apple Pay, Google Pay, Open Banking и оплаты банковской картой (CC).
Как это работает
Все примеры ниже отправляются так же, как и обычное создание заказа — через POST-запрос на:
Чем это отличается от обычного заказа?
Для альтернативных методов оплаты необходимо добавить дополнительные поля: extraParams, customer и/или card. Остальные поля (amount, currency, successUrl, failUrl и т.д.) остаются такими же, как и при обычном создании заказа.
Дополнительные поля для обычного заказа
| Поле | Тип | Описание |
|---|---|---|
extraParams | string | Указывает метод оплаты ("APPLEPAY", "googlepay", "apple_pay" и т.д.) |
customer | object | Данные покупателя (email, телефон, адрес и т.д.) |
card | object | Данные банковской карты (номер, CVV, срок действия) |
Open Banking
Оплата банковским переводом. Требуются данные клиента, включая дату рождения.
Поля customer
| Поле | Тип | Описание |
|---|---|---|
email | string | Email покупателя |
birthday | string | Дата рождения (YYYY-MM-DD) |
firstName | string | Имя |
lastName | string | Фамилия |
Все поля обязательны
Пример запроса
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://success.com",
"failUrl": "https://fail.com",
"customer": {
"email": "pay_to_me@pay.com",
"birthday": "1999-12-12",
"firstName": "Jane",
"lastName": "Doe"
}
}Apple Pay / Google Pay (STD)
Стандартная интеграция Apple Pay или Google Pay. Требуются полные данные покупателя, включая адрес.
Поля customer
| Поле | Тип | Описание |
|---|---|---|
email | string | Email покупателя |
phone | string | Номер телефона |
firstName | string | Имя |
lastName | string | Фамилия |
country | string | Код страны (ISO 3166-1) |
city | string | Город |
state | string | Штат / регион |
postcode | string | Почтовый индекс |
address | string | Адрес |
Все поля обязательны
Пример запроса
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://success.com",
"failUrl": "https://fail.com",
"extraParams": "APPLEPAY",
"customer": {
"email": "pay_to_me@pay.com",
"phone": "1999999999",
"firstName": "Jane",
"lastName": "Doe",
"country": "PT",
"city": "Maia",
"state": "Porto",
"postcode": "4450",
"address": "Adasd Asdeda"
}
}Для Google Pay используйте "extraParams": "GOOGLEPAY" вместо "APPLEPAY".
Apple Pay / Google Pay (LR)
Упрощённая интеграция — требуется только email покупателя.
Поля customer
| Поле | Тип | Описание |
|---|---|---|
email | string | Email покупателя |
Все поля обязательны
Пример запроса
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://success.com",
"failUrl": "https://fail.com",
"extraParams": "apple_pay",
"customer": {
"email": "pay_to_me@pay.com"
}
}Для Google Pay используйте "extraParams": "google_pay" вместо "apple_pay".
Оплата банковской картой (CC FTD)
Первый депозит с карты. Требуются полные данные карты и покупателя.
Поля card
| Поле | Тип | Описание |
|---|---|---|
cardholderName | string | Имя владельца карты |
cardNumber | string | Номер карты |
cvv | string | CVV-код |
expiryDate | string | Срок действия (MM/YY) |
Все поля обязательны
Поля customer
| Поле | Тип | Описание |
|---|---|---|
email | string | Email покупателя |
phone | string | Номер телефона |
firstName | string | Имя |
lastName | string | Фамилия |
birthday | string | Дата рождения (YYYY-MM-DD) |
country | string | Код страны (ISO 3166-1) |
city | string | Город |
region | string | Штат / регион |
postcode | string | Почтовый индекс |
address | string | Адрес |
Все поля обязательны
Пример запроса
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://success.com",
"failUrl": "https://fail.com",
"card": {
"cardholderName": "Jonister Stefan",
"cardNumber": "4444444444444444",
"cvv": "228",
"expiryDate": "12/26"
},
"customer": {
"email": "pay_to_me@pay.com",
"phone": "1999999999",
"firstName": "Jane",
"lastName": "Doe",
"birthday": "2000-05-05",
"country": "PT",
"city": "Maia",
"region": "Porto",
"postcode": "4450",
"address": "Adasd Asdeda"
}
}Оплата банковской картой (STD CC)
Стандартная оплата картой с упрощёнными данными — требуется только email.
Поля customer
| Поле | Тип | Описание |
|---|---|---|
email | string | Email покупателя |
Все поля обязательны
Пример запроса
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://success.com",
"failUrl": "https://fail.com",
"extraParams": "apple_pay",
"customer": {
"email": "pay_to_me@pay.com"
}
}Google Pay (Standalone)
Отдельная интеграция Google Pay с IP-адресом покупателя.
Поля customer
| Поле | Тип | Описание |
|---|---|---|
email | string | Email покупателя |
ip | string | IP-адрес покупателя |
Все поля обязательны
Пример запроса
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://success.com",
"failUrl": "https://fail.com",
"extraParams": "googlepay",
"customer": {
"email": "pay_to_me@pay.com",
"ip": "8.8.8.8"
}
}Apple Pay (Standalone)
Отдельная интеграция Apple Pay с IP-адресом покупателя.
Поля customer
| Поле | Тип | Описание |
|---|---|---|
email | string | Email покупателя |
ip | string | IP-адрес покупателя |
Все поля обязательны
Пример запроса
{
"amount": "10.99",
"currency": "EUR",
"successUrl": "https://success.com",
"failUrl": "https://fail.com",
"extraParams": "applepay",
"customer": {
"email": "pay_to_me@pay.com",
"ip": "8.8.8.8"
}
}