Утверждено


НазваниеУтверждено
страница5/8
ТипДокументы
filling-form.ru > Договоры > Документы
1   2   3   4   5   6   7   8

Таблица 4.1.2.1. Параметры ответа операций testDeposition, makeDeposition

Параметр

Тип

Описание

status

xs:int

Результат выполнения операции. По значению этого поля ИС Контрагента должна принимать решение о состоянии запроса. См. табл. 5.1.1 «Коды состояний запроса».

error

xs:int

Код ошибки выполнения запроса (см. таблицу 5.2.1). Является дополнительной расшифровкой к полю status. В случае успеха поле отсутствует.

clientOrderId

ClientTransactionNumber

Копия параметра clientOrderId запроса.

processedDT

xs:dateTime

Время обработки запроса по часам сервера Системы. В случае успеха операции зачисления — фактическое время зачисления средств на счет.

balance

xs:decimal

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

techMessage

xs:string

Опциональное поле. Может содержать дополнительный поясняющий текст к отказам в приеме перевода. Этот текст содержит техническую информацию и не должен отображаться в каком-либо интерфейсе пользователя.


Пример ответа о возможности зачисления:





status="0"

processedDT="2011-07-01T20:38:01.000Z"/>


Пример ответа об успешном зачислении:





status="0"

processedDT="2011-07-01T20:38:01.000Z"

balance="1000.00"/>


Передача идентификационных данных (makeIdentificationDeposition)

Запрос предназначен для передачи Системе идентификационных данных пользователя (см. раздел «Принципы работы»), подтвержденных Контрагентом. Передача идентификационных данных невозможна без осуществления парного перевода.

Важно! Необходимо осуществлять проверку возможности зачисления указанной суммы на указанный Счет в Системе, а также корректность идентификационных данных до выполнения makeIdentificationDeposition. Запрос testIdentificationDeposition позволяет проверить параметры запроса до принятия средств от клиента.
Примечание: нельзя полностью исключить вероятность того, что между «проверкой возможности зачисления с идентификацией» и «зачислением с идентификацией» состояние Системы изменится и зачисление будет отвергнуто.
Адрес операции проверки возможности зачисления с идентификацией: https://server:port/webservice/deposition/api/testIdentificationDeposition
Адрес операции зачисления с идентификацией: https://server:port/webservice/deposition/api/makeIdentificationDeposition

Формат запросов ИС

Таблица 4.3.1.1. Параметры запроса операций testIdentificationDeposition, makeIdentificationDeposition (все параметры обязательные, кроме отмеченных символом «*»)

Параметр

Тип

Описание

clientOrderId

ClientTransactionNumber

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

requestDT

xs:dateTime

Дата и время формирования запроса операции на стороне ИС, по часам Контрагента.

dstAccount

YMAccount

Идентификатор пользователя в Системе, на Счет которого будет зачислен перевод, например:

4100175017397.

Номера телефонов и иные идентификаторы получателя перевода не допускаются.

amount

CurrencyAmount

Сумма перевода, например: 12.34

currency

CurrencyCode

Код валюты перевода. Возможные значения:

  • 643 — рубль Российской Федерации;

  • 10643 — тестовая валюта (демо-рублики демо-системы «Яндекс.Деньги»).

agentId

xs:long

Идентификатор Контрагента. Выдается Системой.

subAgentId (*)

xs:long

Уникальный идентификатор канала приема переводов. Указывается только в случае разделения приема переводов по нескольким каналам. Выдается Системой.

contract


xs:normalizedString, до 128 символов

Основание для зачисления перевода.

Необходимо указывать «Идентификация через систему Название_Контрагента».

docType

xs:int

Тип идентифицирующего документа:

  • 21 - паспорт гражданина РФ;

  • 7 - военный билет солдата (матроса, сержанта, старшины).

(Прочие коды см. в документе «Справочник типов идентифицирующих документов».)

docNumber

xs:normalizedString, до 33 символов

Серия и номер предъявленного документа. Между серией и номером один пробел, символ № не используется. Пример: 4004 123987.

issueDate

xs:date

Дата выдачи документа. yyyy-mm-dd.

authorityName

xs:normalizedString, до 129 символов

Наименование государственного органа, выдавшего документ (кем выдан).

authorityCode (*)

xs:normalizedString, до 65 символов

Код подразделения, выдавшего документ. В случае предъявления паспорта гражданина РФ (docType=21) является обязательным параметром. Пример: 780-025.

expirationDate (*)

xs:date

Дата окончания действия предъявленного документа. Заполняется, только если дата явно указана в документе.

residence

xs:normalizedString, до 256 символов

Адрес места жительства владельца Счета.

nationality

xs:int

Гражданство владельца Счета:

  • 643 – Российская Федерация;

  • 112 – Беларусь;

  • 398 – Казахстан;

  • 804 – Украина.

(Прочие коды см. в документе «Справочник кодов стран мира».)

birthDate

xs:date

Дата рождения владельца Cчета. yyyy-mm-dd.

birthPlace

xs:normalizedString, до 65 символов

Место рождения владельца счета. Заполняется по данным, предоставленным владельцем счета, если место рождения не указано в документе.

surname

xs:normalizedString, до 65 символов

Фамилия владельца Cчета. Допустимо использование дефиса внутри двойных фамилий.

name

xs:normalizedString, до 65 символов

Имя владельца Cчета. Допустимо использование дефиса внутри двойных имен.

patronymic (*)

xs:normalizedString, до 65 символов

Отчество владельца Cчета. Отчество может отсутствовать.

comment (*)

xs:normalizedString, до 256 символов

Неформализованный комментарий.





agentId="123"

clientOrderId="12345"

requestDT="2011-07-01T20:38:00.000Z"

dstAccount="410011234567"

amount="10.00"

currency="643"

contract="Идентификация через систему Название_системы">


docType="21"

docNumber="4004 123987"

issueDate="1976-01-01"

authorityName="25 о/м Приморского р-на г. Санкт-Петербурга"

authorityCode="780-025"

residence="г.Санкт-Петербург, 3-я улица Строителей, д.25, кв.12"

nationality="643"

birthDate="1940-01-01"

birthPlace="гор.Ленинград"

surname="ЛУКАШИН"

name="ЕВГЕНИЙ"

patronymic="МИХАЙЛОВИЧ"

/>


Пример запроса проверки возможности зачисления с идентификацией:
Пример запроса проверки возможности зачисления с идентификацией c указанием subAgentId:





agentId="123"

subAgentId="456"

clientOrderId="12345"

requestDT="2011-07-01T20:38:00.000Z"

dstAccount="410011234567"

amount="10.00"

currency="643"

contract="Идентификация через систему Название_системы">


docType="21"

docNumber="4004 123987"

issueDate="1976-01-01"

authorityName="25 о/м Приморского р-на г. Санкт-Петербурга"

authorityCode="780-025"

residence="г.Санкт-Петербург, 3-я улица Строителей, д.25, кв.12"

nationality="643"

birthDate="1940-01-01"

birthPlace="гор.Ленинград"

surname="ЛУКАШИН"

name="ЕВГЕНИЙ"

patronymic="МИХАЙЛОВИЧ"

/>








agentId="123"

clientOrderId="12345"

requestDT="2011-07-01T20:38:00.000Z"

dstAccount="410011234567"

amount="10.00"

currency="643"

contract="Идентификация через систему Название_системы">


docType="21"

docNumber="4004 123987"

issueDate="1976-01-01"

authorityName="25 о/м Приморского р-на г. Санкт-Петербурга"

authorityCode="780-025"

residence="г.Санкт-Петербург, 3-я улица Строителей, д.25, кв.12"

nationality="643"

birthDate="1940-01-01"

birthPlace="гор.Ленинград"

surname="ЛУКАШИН"

name="ЕВГЕНИЙ"

patronymic="МИХАЙЛОВИЧ"

/>


Пример запроса на зачисление с идентификацией:
Пример запроса на зачисление с идентификацией c указанием subAgentId:





agentId="123"

subAgentId="456"

clientOrderId="12345"

requestDT="2011-07-01T20:38:00.000Z"

dstAccount="410011234567"

amount="10.00"

currency="643"

contract="Идентификация через систему Название_системы">


docType="21"

docNumber="4004 123987"

issueDate="1976-01-01"

authorityName="25 о/м Приморского р-на г. Санкт-Петербурга"

authorityCode="780-025"

residence="г.Санкт-Петербург, 3-я улица Строителей, д.25, кв.12"

nationality="643"

birthDate="1940-01-01"

birthPlace="гор.Ленинград"

surname="ЛУКАШИН"

name="ЕВГЕНИЙ"

patronymic="МИХАЙЛОВИЧ"

/>





Формат ответов Системы

Таблица 4.3.2.1. Параметры ответа операций testIdentificationDeposition, makeIdentificationDeposition

Параметр

Тип

Описание

status

xs:int

Результат выполнения операции. По значению этого поля ИС Контрагента должна принимать решение о состоянии запроса. См. табл. 5.1.1 «Коды состояний запроса».

error

xs:int

Код ошибки выполнения запроса (см. таблицу 5.2.1). Является дополнительной расшифровкой к полю status. В случае успеха поле отсутствует.

clientOrderId

ClientTransactionNumber

Копия параметра clientOrderId запроса.

processedDT

xs:dateTime

Время обработки запроса по часам сервера Системы. В случае успеха операции зачисления с идентификацией — фактическое время зачисления средств на счет.

balance

xs:decimal

Разница между суммой переводов, принятых Контрагентом в пользу Системы, и суммой средств, перечисленных Контрагентом на расчетный счет Системы. Может быть отрицательным. Данный параметр передается в ответе только на запрос makeIdentificationDeposition и только если зачисление с идентификацией выполнено успешно.

techMessage

xs:string

Опциональное поле. Может содержать дополнительный поясняющий текст к отказам в приеме перевода. Этот текст содержит техническую информацию и не должен отображаться в каком-либо интерфейсе пользователя.


Пример ответа о возможности зачисления с идентификацией:





status="0"

processedDT="2011-07-01T20:38:01.000Z"/>






Пример ответа об успешном зачислении с идентификацией:





status="0"

processedDT="2011-07-01T20:38:01.000Z"

balance="1000.00"/>



Запрос баланса Контрагента (balance)

Данный запрос позволяет узнать баланс в Системе по операциям Контрагента. В ответе на запрос возвращается разница между суммой переводов, принятых Контрагентом в пользу Системы, и суммой средств перечисленных Контрагентом на расчетный счет Системы.
Адрес операции: https://server:port/webservice/deposition/api/balance
Формат запроса ИС:
1   2   3   4   5   6   7   8

Похожие:

Утверждено iconУтверждено утверждено
Муниципальное общеобразовательное бюджетное учреждение средняя общеобразовательная школа №20 г. Сочи организована в 1936 году. Руководит...

Утверждено iconВ московском энергетическом институте (техническом университете)
Российской Федерации (утверждено постановлением Правительства, РФ от 14. 02. 2008 г. №71), на основании Положения о курсовых экзаменах...

Утверждено iconУтверждено

Утверждено iconУтверждено

Утверждено iconУтверждено утверждено

Утверждено iconУтверждено

Утверждено iconУтверждено

Утверждено iconУтверждено

Утверждено icon«Утверждено»

Утверждено iconУтверждено

Вы можете разместить ссылку на наш сайт:


Все бланки и формы на filling-form.ru




При копировании материала укажите ссылку © 2019
контакты
filling-form.ru

Поиск