Платеж кошельком QIWI
Вы можете принимать платежи кошельками QIWI. Этот способ годится только для плательщиков-резидентов.
Cценарий получения платежа кошельком QIWI
- Создаете платеж
session/init/payment
. В параметрах платежного запроса можно передать URL для перехода пользователя после оплаты, время жизни инвойса и дополнительное описание платежа; - Получаете вебхук
action_required
от Банка 131. В вебхуке передается URL c параметрами оплаты; - Перенаправляете пользователя по URL, пользователь авторизовывается в кошельке и подтверждает платеж смс-кодом. На совершение платежа пользователю по умолчанию отводится 1 час. Время ожидания можно настроить в параметре
expiration_at
, но оно не должно быть более 1 часа; - Получаете от Банка 131 вебхук
payment_finished
с результатом проведения платежа и номером телефона плательщика. Статусsucceeded
сообщает вам, что платеж успешно проведен.
Пример запроса на создание платежной сессии
В запросе в объекте payment_options
можно передать URL для перехода пользователя после оплаты и время жизни инвойса.
curl -X POST \
https://demo.bank131.ru/api/v1/session/create \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: 721af394d5a7aefd0e91f5390abc4d7e20fb2b5784b091fef621f3c61b7abb4b' \
-d '{
"payment_details": {
"type": "wallet",
"wallet": {
"type": "qiwi",
"qiwi": {
"description": "my description"
}
}
},
"customer": {
"reference": "190558917",
"contact": [
{
"email": "ramdevi@example.com"
}
]
},
"amount_details": {
"amount": 100,
"currency": "rub"
},
"metadata": {
"key": "value"
},
"payment_options": {
"return_url": "http://xxxx.ru",
"recurrent": false
}
}
Пример вебхука action_required
(вебхук содержит URL для перехода пользователя после оплаты, время жизни инвойса и дополнительное описание платежа)
curl -X POST \
https://partner.ru \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-SIGN: a4f1698616d6ad7b8b73a9d72d281eeb443b64dee3f38df430eeed6aa29e1dc' \
-d '{
"type": "action_required",
"session": {
"id": "ps_629464",
"status": "in_progress",
"created_at": "2023-06-16T08:20:11.100714Z",
"updated_at": "2023-06-16T08:20:11.758451Z",
"acquiring_payments": [
{
"id": "pm_301086",
"status": "pending",
"created_at": "2023-06-16T08:20:11.195507Z",
"customer": {
"reference": "190558917"
},
"payment_details": {
"type": "wallet",
"wallet": {
"type": "qiwi",
"qiwi": {
"account": "",
"description": "my description"
}
}
},
"amount_details": {
"amount": 100,
"currency": "RUB"
},
"amounts": {
"net": {
"amount": 95,
"currency": "RUB"
},
"gross": {
"amount": 100,
"currency": "RUB"
}
},
"customer_interaction": {
"type": "redirect",
"redirect": {
"url": "https://oplata.qiwi.com/form?invoiceUid=6691a752-9a2f-445a-8121-7936a7244a63&successUrl=http%3A%2F%2Fya.ru",
"base_url": "https://oplata.qiwi.com/form",
"method": "GET",
"qs": {
"invoiceUid": "6691a752-9a2f-445a-8121-7936a7244a63",
"successUrl": "http://xxxx.ru"
},
"params": {}
}
},
"metadata": {
"key": "value"
},
"payment_options": {
"return_url": "http://xxxx.ru",
"recurrent": false
}
}
]
}
}
Пример вебхука action_required
(вебхук содержит время жизни инвойса и дополнительное описание платежа)
curl -X POST \
https://partner.ru \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-SIGN: a4f1698616d6ad7b8b73a9d72d281eeb443b64dee3f38df430eeed6aa29e1dc' \
-d '{
"type": "action_required",
"session": {
"id": "ps_1093171",
"status": "in_progress",
"created_at": "2023-07-12T13:53:21.802280Z",
"updated_at": "2023-07-12T13:53:22.341487Z",
"acquiring_payments": [
{
"id": "pm_773370",
"status": "pending",
"created_at": "2023-07-12T13:53:21.906913Z",
"customer": {
"reference": "190100500"
},
"payment_details": {
"type": "wallet",
"wallet": {
"type": "qiwi",
"qiwi": {
"account": "",
"description": "комментарий в 256 символов"
}
}
},
"amount_details": {
"amount": 400,
"currency": "RUB"
},
"amounts": {
"net": {
"amount": 400,
"currency": "RUB"
},
"gross": {
"amount": 400,
"currency": "RUB"
}
},
"customer_interaction": {
"type": "redirect",
"redirect": {
"url": "https://oplata.qiwi.com/form?invoiceUid=d5f8fcf2-3f52-4101-9495-d7c00c4599b5&successUrl=https%3A%2F%2Fwww.131.ru%2F",
"base_url": "https://oplata.qiwi.com/form",
"method": "GET",
"qs": {
"invoiceUid": "d5f8fcf2-3f52-4101-9495-d7c00c4599b5",
"successUrl": "https://www.131.ru/"
},
"params": {}
}
},
"metadata": {
"key": "value"
},
"payment_options": {
"return_url": "https://www.131.ru/",
"recurrent": false,
"description": "комментарий в 256 символов"
}
}
]
}
}
Пример вебхука payment_finished
- успешная оплата
{
"type": "payment_finished",
"session": {
"id": "ps_1100755",
"status": "accepted",
"created_at": "2023-08-03T07:51:59.878059Z",
"updated_at": "2023-08-03T07:58:59.286803Z",
"acquiring_payments": [
{
"id": "pm_773469",
"status": "succeeded",
"created_at": "2023-08-03T07:51:59.984814Z",
"finished_at": "2023-08-03T07:58:59.072221Z",
"customer": {
"reference": "190100500"
},
"payment_details": {
"type": "wallet",
"wallet": {
"type": "qiwi",
"qiwi": {
"account": "79011234567",
"description": "коомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментари1"
}
}
},
"amount_details": {
"amount": 400,
"currency": "RUB"
},
"amounts": {
"net": {
"amount": 400,
"currency": "RUB"
},
"gross": {
"amount": 400,
"currency": "RUB"
}
},
"payment_options": {
"return_url": "https://www.131.ru/",
"recurrent": false,
"description": "коомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментарий в 256 символовкоомментари1",
"expiration_at": "2023-08-03 10:55:59"
}
}
]
}
}