Сценарий 4. Сверки по операциям
Pay API
О регулярных сверках
Для поддержания регулярной отчётности по операциям Koshelek Pay реализован процесс отправки операционных реестров. Следует учитывать, что для каждого из провайдеров платежей (Долями, СБП) предусмотрен отдельный процесс сверок:
- Долями: сверки осуществляются между юр. лицом ТСП и сервисом «Долями».
- СБП: сверки осуществляются между юр. лицом ТСП и Кошельком.
Сверки Долями
Процесс сверок по операциям Долями организован следующим образом:
- Сервер Долями формирует файл реестра и отправляет его юр. лицу ТСП по указанному адресу email.
- Юр. лицо ТСП сверяет данные, полученные от Долями, со своими данными:
- Если всё сходится: ОК, ничего делать не нужно.
- Если есть расхождения: юр. лицу ТСП необходимо сообщить о них сервису Долями.
Свойства реестра Долями
Отправитель реестра: сервис «Долями».
Типы отправляемых реестров:
а) ежедневный реестр:
- содержит список операций за предыдущий бизнес-день;
- отправляется каждый день.
б) ежемесячный реестр:
- содержит список операций за предыдущий бизнес-месяц;
- отправляется в начале каждого месяца.
Формат реестра: CSV.
Адрес получателя реестра: email, указанный юр. лицом ТСП.
Пример реестра Долями
Так как процесс сверок Долями проходит не через Кошелёк, а напрямую через Долями, то не следует рассматривать нижеприведённый пример в качестве образца. Поля, формат, а также правила именования файлов могут отличаться. Итоговый формат реестра согласовывается и закрепляется на этапе подписания договора.
:fontawesome-regular-file-lines: dolyame_123324_2022_09-30.csv
Сверки СБП
Процесс сверок по операциям СБП организован следующим образом:
- Сервер Кошелька формирует файл реестра и отправляет его юр. лицу ТСП по указанному адресу email.
- Юр. лицо ТСП сверяет данные, полученные от Кошелька с данными о транзакциях с использованием Koshelek Pay, прошедших по кассе, а затем — с возмещением по операциям, поступившим на расчётный счёт:
- Если всё сходится: ОК, ничего делать не нужно.
- Если есть расхождения: юр. лицу ТСП необходимо сообщить о них Кошельку.
Свойства реестра СБП
Отправитель реестра: Кошелёк (ООО «Бесконтакт»).
Типы отправляемых реестров:
а) ежедневный реестр:
- содержит список операций за предыдущий бизнес-день;
- отправляется каждый день.
б) ежемесячный реестр:
- содержит список операций за предыдущий бизнес-месяц;
- отправляется в начале каждого месяца.
Формат реестра: CSV.
Адрес получателя реестра: email, указанный юр. лицом ТСП.
Пример реестра СБП
Маппинг полей реестра СБП с полями Pay API
| Поле реестра СБП | Описание | Параметр Pay API |
|---|---|---|
Operation Id |
Уникальный ID операции оплаты или возврата. | transactionId — для оплаты;refTransactionId — для возврата. |
Original payment operation id |
Ссылка на ID операции оплаты. Заполняется только для возврата. | transactionId — для возврата. |
Request Id |
Уникальный ID от кассы для оплаты/возврата. | requestId |
Order ID |
Идентификатор покупки в системе ТСП. | orderId |
Date/Time from POS |
Дата / время получения от ТСП запроса на выполнение операции. | — |
Date/Time to SBP |
Дата / время передачи запроса на выполнение операции от Кошелька в СБП для оплаты /возврата. | — |
Date/Time payment status from SBP |
Дата / время получения финального статуса по операции от СБП. | — |
Payment Store ID |
ID магазина операции оплаты. | storeId оплаты |
Refund Store ID |
ID магазина операции возврата. Для операции оплаты будет передано пустое значение. | storeId возврата |
Merchant Id |
ID ТСП, выданный системой СБП. Выдаётся банком-получателем, который подключает ТСП к СБП. | merchantId |
Payment Terminal id |
ID кассы операции оплаты. | terminalId оплаты |
Refund Terminal id |
ID кассы операции возврата. | terminalId возврата |
Amount |
Сумма операции в рублях. | totalAmount |
Operation Type |
Тип операции:
|
paymentType |
member Id |
Идентификатор банка ТСП. | Конфигурация memberId хранится в справочниках Кошелька. |
bank_account_id |
Счёт ЮЛ, ИП или самозанятого для СБП. | bankAccountId |
Qrc Id |
qrcId запроса. |
qrcId |