Сценарий 4. Сверки по операциям

Кошелёк Pay API

Документация перемещена

Информация на этой странице не обновляется и может быть устаревшей. Наиболее полная и актуальная версия документации для разработчиков доступна по новому адресу:

https://developers.koshelek.app

О регулярных сверках

Для поддержания регулярной отчётности по операциям, выполняемым с использованием Кошелёк Pay, реализован процесс отправки операционных реестров.

Следует учитывать, что для каждого из провайдеров платежей (Долями, СБП) предусмотрен специальный процесс сверок:

• Долями: сверки юрлица ТСП и сервиса «Долями».

• СБП: сверки юрлица ТСП и Кошелька.

Сверки Долями

Процесс сверок по операциям Долями организован следующим образом:

1	Сервер Долями формирует файл реестра и отправляет его юрлицу ТСП по указанному адресу email.
2	Юрлицо ТСП сверяет данные, полученные от Долями, со своими данными: Если всё сходится: ОК, ничего делать не нужно. Если есть расхождения: юрлицу ТСП необходимо сообщить о них сервису Долями.

• Отправитель: Долями.

• Типы реестров:

  • ежедневный реестр:

    • содержит список операций за предыдущий бизнес-день;

    • отправляется каждый день.

  • ежемесячный реестр:

    • содержит список операций за предыдущий бизнес-месяц;

    • отправляется в начале каждого месяца.

• Формат реестра: CSV.

• Адрес получателя реестра: email, указанный юрлицом ТСП.

Пример реестра Долями

Так как процесс сверок Долями проходит не через Кошелёк, а напрямую через Долями, то не следует рассматривать нижеприведенный пример в качестве образца. Поля, формат, а также правила именования файлов могут отличаться. Актуальный формат отчета согласовывается закрепляется на этапе подписания договора.

2KB

dolyame_123324_2022_09-30.csv

Сверки СБП

Процесс сверок по операциям СБП организован следующим образом:

1	Сервер Кошелька формирует файл реестра и отправляет его юрлицу ТСП по указанному адресу email.
2	Юрлицо ТСП сверяет данные, полученные от Кошелька с данными о транзакциях с использованием Кошелёк Pay, прошедших по кассе, а потом с возмещением по операциям, поступившим на р/с: Если всё сходится: ОК, ничего делать не нужно. Если есть расхождения: юрлицу ТСП необходимо сообщить о них Кошельку.

• Отправитель: Кошелёк (ООО «Бесконтакт»)

• Типы реестров:

  • ежедневный реестр:

    • содержит список операций за предыдущий бизнес-день;

    • отправляется каждый день.

  • ежемесячный реестр:

    • содержит список операций за предыдущий бизнес-месяц;

    • отправляется в начале каждого месяца.

  • Формат реестра: CSV.

  • Адрес получателя реестра: email, указанный юрлицом ТСП.

Пример реестра СБП

2KB

Реестр СБП. Бесконтакт-ООО_Ваш-Магазин_(7777777). За 2023-3-13 от 2023-03-14 T040000.csv

Маппинг полей реестра СБП с полями 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	Тип операции: payment — оплата refund — возврат	paymentType
member Id	Идентификатор банка ТСП	Конфиг memberId хранится в справочниках Кошелька
bank_account_id	Счёт ЮЛ, ИП или самозанятого для СБП	bankAccountId
Qrc Id	qrcId запроса Pay API	qrcId