gateweb/P2PCredit - Зачисление средств на карту со счета ТСП

HTTP‑метод: POST
URL: /gateweb/P2PCredit/
Форма взаимодействия: Сервер-сервер
Формат тела запроса: application/x-www-form-urlencoded
Назначение: выполнение Операции P2PCREDIT для перевода средств со счета ТСП на карту

URL

URLPATH

https://b2p.wallet.kvell.group/gateweb/P2PCredit/

/gateweb/P2PCredit/

Структура запроса

Поле	Тип	Обяз.	Описание
`sector`	`str`	✔	Уникальный идентификатор учётной записи ТСП в ПЦ.
`signature`	`str`	✔	Цифровая подпись (`sector`, `id`, `amount`, `currency`, `pan`, `token`, `password`).
Условно-обязательные параметры (Обязательно указать либо id, либо совокупность параметров amount, currency, reference. Также, обязательно указать либо pan, либо token)
`id`	`int`		Идентификатор заказа в ПЦ, полученный из `webapi/Register`.
`amount`	`int`		Сумма заказа в минимальных единицах валюты (для RUB — копейки).
`currency`	`int`		Код валюты по ISO 4217 (643 — RUB, 978 — EUR, 840 — USD).
`reference`	`str`		Номер заказа на стороне ТСП.
`pan`	`str`		Номер карты получателя средств. Не обязательно при передаче параметра token.
`token`	`str`		Токен карты получателя средств. Не обязательно при передаче параметра pan.
Обязательные для перевода на иностранную карту
`address`	`str`		Адрес Плательщика. Общий формат: название улицы, номер дома, номер квартиры/офиса.
`city`	`str`		Название населённого пункта Плательщика (города, посёлка и т.д.).
`post_code`	`str`		Индекс Плательщика (ZIP code)
`countrynum`	`str`		Двухсимвольных код страны Плательщика в соответствии с ISO 3166-1.
`name`	`str`		Имя на карте отправителя.
`receiver_name`	`str`		Имя получателя средств.
Необязательные параметры
`get_token`	`int`		Флаг запроса токена карты в уведомлении (`0` — нет, `1` — да).
`email`	`str`		Email Плательщика для уведомлений.

Структура ответа

Элемент	Тип	Описание
`order_id`	`int`	Идентификатор заказа в ПЦ.
`order_state`	`str`	Статус заказа
`reference`	`str`	Номер заказа на стороне ТСП.
`id`	`int`	Идентификатор операции в ПЦ
`date`	`datetime`	Дата и время совершения операции в ПЦ (`YYYY.MM.DD HH:MM:SS`).
`type`	`str`	Тип операции.
`state`	`str`	Статус операции
`reason_code`	`int`	Код ответа на операцию ПЦ
`message`	`str`	Краткое описание кода ответа на операцию ПЦ
`name`	`str`	Имя на банковской карте Получателя денежных средств
`pan`	`str`	Маскированный номер банковской карты Получателя денежных средств
`email`	`str`	Электронная почта Получателя денежных средств
`amount`	`int`	Сумма заказа в минимальных единицах валюты (для RUB — копейки).
`curency`	`int`	Код валюты по ISO 4217 (643 — RUB, 978 — EUR, 840 — USD).
`approval_code`	`str`	Код авторизации, полученный в Банке на данную операцию.
`signature`	`str`	Цифровая подпись сообщения. В подписи участвуют значения всех тегов в порядке их следования и пароль для расчёта цифровой подписи, предоставляемый ТСП после его регистрации в ПЦ.

Пример ответов

Успех (200)Ошибка валидации (400)

<?xml version="1.0" encoding="UTF-8"?>
<operation>
    <order_id>1009982</order_id>
    <order_state>REGISTERED</order_state>
    <reference>test</reference>
    <id>5587788</id>
    <date>2024.01.28 00:23:19</date>
    <type>P2PTRANSFER</type>
    <state>APPROVED</state>
    <reason_code>1</reason_code>
    <message>Successful financial transaction</message>
    <name>cardholder name</name>
    <pan>676531******0129</pan>
    <email>mail@somesite.com</email>
    <amount>100</amount>
    <currency>643</currency>
    <approval_code>122004</approval_code>
    <signature>Y2Y0ZjllMGI3NDc0YjhjYTU2Yzk1ZTg1NGMxMmI1MDQ=</signature>
</operation>

<?xml version="1.0" encoding="UTF-8"?>
<error>
    <description>Sector not found</description>
    <code>105</code>
</error>

Примечания

Ответ может содержать ряд новых необязательных параметров, которые важно учесть при составлении подписи.