Платёжное поручение

URI

POST: /API/v1/ISO20022/Payments

XML схема

pain.001.001.06

Описание схемы

Описание Путь Комментарий
Пример

1

R

Дата и Время создания сообщения

Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm

Формат даты YYYY-MM-DDTHH:MM:SS 2018-11-27T17:13:45

2

R

Уникальный id сообщения

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

Указывается идентификатор сообщения присвоенный во внешней системе.

3

R

Количество транзакций в сообщении

Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs

Общее число поручений (секций CdtTrfTxInf) в сообщении

4

R

Уникальный id пакета платежей

Document.CstmrCdtTrfInitn.PmtInf.PmtInfId

Указывается идентифкатор группы распоряжений. Идентификатор не должен совпадать с MsgId и другими идентификаторами

5

R

Уникальный id платежа

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId

Идентифкатор исходного поручения

6

R

Метод оплаты

Document.CstmrCdtTrfInitn.PmtInf.PmtMtd

Значение "TRF" по умолчанию

7

R

Подпись 1

SplmtryData.Envlp.Signature.

8

O

Подпись n

SplmtryData.Envlp.Signature.

Описание Путь Комментарий
Пример

Document.CstmrCdtTrfInitn.PmtInf

1

R

Дата документа (4)

CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt

YYYY-MM-DD, если параметр не заполнен, считываем значение параметра ReqdExctnDt

2

R

Номер документа (3)

CdtTrfTxInf.PmtId.EndToEndId

Целое число до 6 символов. Уникальность номера в течение дня проверяется исходя из уникальности группы параметров: дата платежа, номер платежа, счет плательщика, счет получателя, сумма платежа.

3

R

Сумма документа

CdtTrfTxInf.Amt.InstdAmt

4

R

Вид платежа (5)

CdtTrfTxInf.PmtTpInf.SvcLvl.Cd

Принимаемые значения:
URGP - срочный платеж
NURG - обычный платеж

5

R

Очередность платежа (21)

CdtTrfTxInf.Purp.Prtry

"HIGH" - отправлять на обработку в первую очередь "NORM" - отправлять во вторую очередь

6

R

Код платежа (22)

CdtTrfTxInf.RmtInf.Strd.CdtrRefInf.Ref

Назначение платежа (24)
Поле формируется на стороне системы Альфа-Линк из нескольких тегов по следующему алгоритму:
['{'+ Признак валютной операции + Код валютной операции + '}'] + [Информация получателю] + [Информация о НДС]
Допускается заполнить только поле "Информация получателю" со всей необходимой информацией.
Общая длина поля (24) не должна превышать 210 символов.

7

O

Признак валютной операции

CdtTrfTxInf.RgltryRptg.Dtls.Tp

Для валютных операций - константа Tp = "VO"

8

O

Код валютной операции

CdtTrfTxInf.RgltryRptg.Dtls.Cd

Обязателен, если указан Tp

9

O

Информация получателю

CdtTrfTxInf.RmtInf.Ustrd[1..2]

10

O

Тип НДС

CdtTrfTxInf.Tax.Rcrd.AddtlInf

VTIN - Включая НДС;
VTNA - НДС не облагается;
VTPS - Не включая НДС;
Либо может содержать другое значение.

11

O

Значение НДС

CdtTrfTxInf.Tax.Rcrd.TaxAmt.Rate

Обязателен, если AddtlInf = "VTIN"

12

R

Наименование плательщика (8)

Dbtr.Nm

13

R

Наименование плательщика (8)*

Dbtr.CtctDtls.Nm

Заполняется в случае, если наименование плательщика больше 140 символов.

14

R

ИНН плательщика (60)

Dbtr.Id.OrgId.Othr.Id

15

O

КПП плательщика (102)

CdtTrfTxInf.Tax.Dbtr.TaxTp

16

R

Счет плательщика (9)

DbtrAcct.Id.Othr.Id

17

R

БИК банка плательщика (11)

DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

18

R

Наименование банка плательщика (10)

DbtrAgt.FinInstnId.Nm

19

R

Корсчет банка плательщика (12)

DbtrAgtAcct.Id.Othr.Id

20

R

Наименование получателя (16)

CdtTrfTxInf.Cdtr.Nm

21

R

ИНН получателя (61)

CdtTrfTxInf.Cdtr.Id.OrgId.Othr.Id

22

O

КПП получателя (103)

CdtTrfTxInf.Tax.Cdtr.TaxTp

23

O

Счет получателя (17)

CdtTrfTxInf.CdtrAcct.Id.Othr.Id

24

R

БИК банка получателя (14)

CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

25

R

Наименование банка получателя (13)

CdtTrfTxInf.CdtrAgt.FinInstnId.Nm

26

R

Корсчет банка получателя (15)

CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id

27

O

Код вида дохода (20)

CdtTrfTxInf.RgltryRptg.Dtls.Cd

Также необходимо заполнить поле PmtInf.CdtTrfTxInf.RgltryRptg.Dtls.Tp = "PTCD"
Данная константа является признаком того, что заполнено поле Код вида дохода

Правило заполнения Чтобы корректно заполнить поле, определите тип дохода, который получит физ. лицо в результате перевода. Если ваш платёж не подпадает под список из ФЗ, поле заполнять не нужно.

Код "1" - при переводе денежных средств, являющихся заработной платой и (или) иными доходами, в отношении которых статьей 99 Федерального закона от 2.10.2007 N 229-ФЗ установлены ограничения размеров удержания. При наличии исполнительного документа укажите взысканную вами сумму в поле «Назначение платежа (24)».

Код "2" - при переводе денежных средств, являющихся доходами, на которые в соответствии со статьей 101 Федерального закона от 2.10. 2007 N 229-ФЗ не может быть обращено взыскание, за исключением доходов, к которым в соответствии с частью 2 статьи 101 Федерального закона от 2.10.2007 N 229-ФЗ ограничения по обращению взыскания не применяются.

Код "3" - при переводе денежных средств, являющихся доходами, к которым в соответствии с частью 2 статьи 101 Федерального закона от 2.10. 2007 N 229-ФЗ ограничения по обращению взыскания не применяются. При наличии исполнительного листа укажите в поле «Назначение платежа (24)» взысканную вами сумму. Обратите внимание, что по доходам с кодом 3 взыскания могут совершаться только по алиментным обязательствам в отношении несовершеннолетних лиц или по обязательствам о возмещении вреда в связи со смертью кормильца.

В остальных случаях код не указывается

Как указать взысканную сумму в поле «Назначение платежа (24)»? Если из переводимых физическому лицу денежных средств, составляющих доходы, указанные в ст. 99 или 101 Федерального закона "Об исполнительном производстве", вами произведено удержание по исполнительному документу, то в поле «Назначение платежа (24)» укажите взысканную сумму в формате: //ВЗС//рубли-копейки//. Например, //ВЗС//100000-00//.

Закон и порядок Подробная информация в Федеральном законе от 21.02.2019 N 12-ФЗ "О внесении изменений в Федеральный закон "Об исполнительном производстве", Указании Банка России от 14.10.2019 N 5286-У "О порядке указания кода вида дохода в распоряжениях о переводе денежных средств

28

O

Код выплат (110)

CdtTrfTxInf.Tax.Rcrd.Tp

Правило заполнения

Чтобы корректно заполнить поле «Код выплат (110)», определите тип дохода, который получит физ. лицо в результате перевода. Если ваш платёж не подпадает под перечень из Постановления, код указывать не нужно.

Код 1 проставляется в случае выплат на счёт физ. лица:

1. Пособия по временной нетрудоспособности (только в отношении граждан, подвергшихся воздействию радиации);

2. Пособия по беременности и родам;

3. Единовременного пособия женщинам, вставшим на учёт в медицинских организациях в ранние сроки беременности;

4. Единовременного пособия при рождении ребенка;

5. Ежемесячного пособия по уходу за ребёнком.

Все виды доходов, подпадающих под код 1, перечислены в частях 5.5 и 5.6 статьи 30.5 Федерального закона «О национальной платёжной системе».

В остальных случаях код не указывается. В случае некорректного заполнения поля возможны претензии со стороны физических лиц и/или контролирующих органов.

Закон и порядок Подробная информация в статье 30.5 Закона РФ от 27.06.2011 № 161-ФЗ «О национальной платёжной системе», Постановлении Правительства РФ от 01.12.2018 № 1466 «Об утверждении перечня иных выплат за счет средств бюджетов бюджетной системы Российской Федерации для целей применения частей 5 и 5.1 статьи 30.5 Федерального закона «О национальной платежной системе»

Бюджетные реквизиты платежного поручения

29

O

Статус составителя документа (101)

CdtTrfTxInf.Tax.Rcrd.DbtrSts

30

O

Код бюджетной классификации (104)

CdtTrfTxInf.Tax.Rcrd.CtgyDtls

31

O

ОКТМО (105)

CdtTrfTxInf.Tax.AdmstnZn

32

O

Код основания налогового платежа (106)

CdtTrfTxInf.Tax.Rcrd.Ctgy

33

O

Номер налогового документа (108)

CdtTrfTxInf.Tax.RefNb

34

O

Дата налогового документа (109)

CdtTrfTxInf.Tax.Dt

Реквизит "Код налогового периода (107)": код таможенного органа, показателя налогового периода, дата уплаты налогов.
Данное поле является составным и формируется системой Альфа-Линк по алгоритму, указанному после таблицы.

35

O

Дата уплаты налогов

CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt

Алгоритм обработки приведен ниже

36

O

Конец периода
(не используется)

CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.ToDt

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

37

O

Год налогового периода

CdtTrfTxInf.Tax.Rcrd.Prd.Yr

38

O

Налоговый период в кодировке ISO20022

CdtTrfTxInf.Tax.Rcrd.Prd.Tp

MM - МС;
QTR - КВ;
HLF - ПЛ;
не указано - ГД.

39

O

Код таможенного органа

CdtTrfTxInf.Tax.Cdtr.RegnId

Алгоритм обработки параметра "Код налогового периода (107)" на стороне банка

Если FrDt содержит значение, то необходимо FrDt, преобразовать к формату ДД.ММ.ГГГГ. Иначе:

  1. Если Tp начинается с 'MM', то Код налогового периода = ''МС.'+substring(Tp,3,2)+YEAR(Yr);

  2. Если Tp начинается с 'QTR', Код налогового периода = ''КВ.0'+substring(Tp,4,1)+YEAR(Yr);

  3. Если Tp начинается с 'HLF', Код налогового периода = ''ПЛ.0'+substring(Tp,4,1)+YEAR(Yr);

  4. Если Tp не указано, то Код налогового периода = 'ГД.00.'+YEAR(Yr).

Иначе, если RegnId содержит значение, то Код налогового периода = RegnId. Если не заполнены RegnId, FrDt, Yr, Tp, то Код налогового периода = 0.

Где:
FrDt - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt - дата налогового периода
Yr - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Yr - год налогового периода
Tp - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Tp - налоговый период
RegnId - PmtInf.CdtTrfTxInf.Tax.Cdtr.RegnId - код налогового органа
(прим. ToDt - Не используется, указывается для соблюдения формата)

Пример:

12.03.2016

ГД.00.2016

ПЛ.01.2015

КВ.03.2016

МС.10.2014

10001010

Ответ

Ответом является XML-документ, соответвующий схеме pain.002.001.06.

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

User is disabled

Пользователь заблокирован

401

Err

Warrant is expired

Доверенность истекла

401

Err

Warrant was not found

Доверенность не найдена

401

Err

Warrant service error

Сервис проверки доверенности не отвечает

406

Err

User does not have permission

Нет прав на выполнения операции

406

Err

Signature is missing

Нет подписи

406

Err

Certificate is not valid

Сертификат подписи невалидный

406

Err

Signature is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

500

Err

Internal Error

Внутренняя ошибка приложения

400

Err

MsgId is not unique

Id запроса неуникальный

400

Err

XML does not match schema

Документ не соответствует схеме

Пример платежа с подписью
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
  <CstmrCdtTrfInitn>
    <GrpHdr>
      <MsgId>9703ab757ffe418a9118b9e538e2f2e6</MsgId>
      <CreDtTm>2019-01-29T12:25:53.0000000</CreDtTm>
      <NbOfTxs>1</NbOfTxs>
      <CtrlSum>58.00</CtrlSum>
      <InitgPty>
        <Nm>АО "ДИСКИ"</Nm>
        <Id>
          <OrgId>
            <Othr>
              <Id>5036045205</Id>
              <SchmeNm>
                <Prtry>CFTBIC</Prtry>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>PKG8922c37e1e564965be5c4220680fff75</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <NbOfTxs>1</NbOfTxs>
      <ReqdExctnDt>2019-01-29</ReqdExctnDt>
      <Dbtr>
        <Nm>ОАО "ДИСКИ"</Nm>
        <Id>
          <OrgId>
            <Othr>
              <Id>5036045205</Id>
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </Dbtr>
      <DbtrAcct>
        <Id>
          <Othr>
            <Id>40702810901300013000</Id>
          </Othr>
        </Id>
        <Ccy>RUB</Ccy>
      </DbtrAcct>
      <DbtrAgt>
        <FinInstnId>
          <ClrSysMmbId>
            <ClrSysId>
              <Cd>RUCBC</Cd>
            </ClrSysId>
            <MmbId>044525593</MmbId>
          </ClrSysMmbId>
          <Nm>АО "АЛЬФА-БАНК", Г МОСКВА, УЛ КАЛАНЧЁВСКАЯ, 27</Nm>
          <PstlAdr>
            <Ctry>RU</Ctry>
          </PstlAdr>
        </FinInstnId>
      </DbtrAgt>
      <DbtrAgtAcct>
        <Id>
          <Othr>
            <Id>30101810200000000593</Id>
            <SchmeNm>
              <Cd>BBAN</Cd>
            </SchmeNm>
          </Othr>
        </Id>
      </DbtrAgtAcct>
      <CdtTrfTxInf>
        <PmtId>
          <InstrId>PMTebe7f52168b84c55a9d3419e95c006e7</InstrId>
          <EndToEndId>85114</EndToEndId>
        </PmtId>
        <PmtTpInf>
          <SvcLvl>
            <Cd>NURG</Cd>
          </SvcLvl>
        </PmtTpInf>
        <Amt>
          <InstdAmt Ccy="RUB">58.00</InstdAmt>
        </Amt>
        <ChrgBr>DEBT</ChrgBr>
        <CdtrAgt>
          <FinInstnId>
            <ClrSysMmbId>
              <ClrSysId>
                <Cd>RUCBC</Cd>
              </ClrSysId>
              <MmbId>044525593</MmbId>
            </ClrSysMmbId>
            <Nm>АО "АЛЬФА-БАНК", Г МОСКВА, УЛ КАЛАНЧЁВСКАЯ, 27</Nm>
            <PstlAdr>
              <Ctry>RU</Ctry>
            </PstlAdr>
          </FinInstnId>
        </CdtrAgt>
        <CdtrAgtAcct>
          <Id>
            <Othr>
              <Id>30101810200000000593</Id>
            </Othr>
          </Id>
        </CdtrAgtAcct>
        <Cdtr>
          <Nm>ОАО "ДИСКИ"</Nm>
          <PstlAdr>
            <Ctry>RU</Ctry>
          </PstlAdr>
          <Id>
            <OrgId>
              <Othr>
                <Id>5036045205</Id>
                <SchmeNm>
                  <Cd>TXID</Cd>
                </SchmeNm>
              </Othr>
            </OrgId>
          </Id>
        </Cdtr>
        <CdtrAcct>
          <Id>
            <Othr>
              <Id>40702810001850000500</Id>
              <SchmeNm>
                <Cd>BBAN</Cd>
              </SchmeNm>
            </Othr>
          </Id>
        </CdtrAcct>
        <Purp>
          <Prtry>5</Prtry>
        </Purp>
        <Tax>
          <Cdtr>
            <TaxTp>509950001</TaxTp>
          </Cdtr>
          <Dbtr>
            <TaxTp>997350001</TaxTp>
          </Dbtr>
        </Tax>
        <RmtInf>
          <Ustrd>Пополнение расчетного счета предприятия для текущей деятельности. НДС не облагается</Ustrd>
          <Strd>
            <RfrdDocInf>
              <Tp>
                <CdOrPrtry>
                  <Prtry>POD</Prtry>
                </CdOrPrtry>
              </Tp>
              <RltdDt>2019-01-29</RltdDt>
            </RfrdDocInf>
          </Strd>
        </RmtInf>
      </CdtTrfTxInf>
    </PmtInf>
    <SplmtryData>
      <Envlp>
        <SgntrSt>
          <ds:Signature>
            <ds:SignedInfo>
              <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#" />
              <ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102001-gostr3411" />
              <ds:Reference URI="">
                <ds:Transforms>
                  <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
                </ds:Transforms>
                <ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr3411" />
                <ds:DigestValue>41oYHqGcb3FQN+/ouYfrhrgNVywZiJIx2YKgCPILYmg=</ds:DigestValue>
              </ds:Reference>
            </ds:SignedInfo>
            <ds:SignatureValue>NUGY+R8KqtLZZ3gonWBawbVfx17gC4vW3E7/oISjLtQDfPoBIgCVywxMmLbDjHZ3
IUNwSTZBG5uwTM/fKJqafA==</ds:SignatureValue>
            <ds:KeyInfo>
              <ds:X509Data>
                <ds:X509Certificate>MIIDZzCCAxagAwIBAgITEgAvajwQ6+aBm0dZ1AAAAC9qPDAIBgYqhQMCAgMwfzEj
MCEGCSqGSIb3DQEJARYUc3VwcG9ydEBjcnlwdG9wcm8ucnUxCzAJBgNVBAYTAlJV
MQ8wDQYDVQQHEwZNb3Njb3cxFzAVBgNVBAoTDkNSWVBUTy1QUk8gTExDMSEwHwYD
VQQDExhDUllQVE8tUFJPIFRlc3QgQ2VudGVyIDIwHhcNMTgxMTIxMDg0MDA5WhcN
MTkwMjIxMDg1MDA5WjB2MRswGQYJKoZIhvcNAQkBFgxtYWlsQG1haWwucnUxDTAL
BgNVBAMMBE5SRDIxDTALBgNVBAsMBGRlcHQxDDAKBgNVBAoMA29yZzENMAsGA1UE
BwwEY2l0eTEPMA0GA1UECAwGcmVnaW9uMQswCQYDVQQGEwJSVTBjMBwGBiqFAwIC
EzASBgcqhQMCAiQABgcqhQMCAh4A0MABEBhJ8tNt//ZiUVpJdfGv1jaD7FmBFaR
du1AszW5HgBOBQEJbr50GRdq+9LtfSWCj0sX5kpscWxmPO8BXrvJmvxso4IBcDCC
AWwwDgYDVR0PAQH/BAQDAgTwMBMGA1UdJQQMMAoGCCsGAQUFBwMCMB0GA1UdDgQW
BBQsNWab0rMXh6+o8Sz0S7J5q+TPXDAfBgNVHSMEGDAWgBQVMXywjRreZtcVnElS
lxckuQF6gzBZBgNVHR8EUjBQME6gTKBKhkhodHRwOi8vdGVzdGNhLmNyeXB0b3By
by5ydS9DZXJ0RW5yb2xsL0NSWVBUTy1QUk8lMjBUZXN0JTIwQ2VudGVyJTIwMi5j
cmwwgakGCCsGAQUFBwEBBIGcMIGZMGEGCCsGAQUFBzAChlVodHRwOi8vdGVzdGNh
LmNyeXB0b3Byby5ydS9DZXJ0RW5yb2xsL3Rlc3QtY2EtMjAxNF9DUllQVE8tUFJP
JTIwVGVzdCUyMENlbnRlciUyMDIuY3J0MDQGCCsGAQUFBzABhihodHRwOi8vdGVz
dGNhLmNyeXB0b3Byby5ydS9vY3NwL29jc3Auc3JmMAgGBiqFAwICAwNBAFLI0inU
sUiMcl0WlXOL1M1r7cBg251dX5vuHDsTZSsKdfGJXJkZE2EV/QPWIeKOFnBEXACX
pao0IO/aIWRHeao=</ds:X509Certificate>
              </ds:X509Data>
            </ds:KeyInfo>
          </ds:Signature>
        </SgntrSt>
      </Envlp>
    </SplmtryData>
  </CstmrCdtTrfInitn>
</Document>
Пример квитанции на платеж pain.002.001.06
В случае успеха:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.06">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>3c402c01c9b849a0ac5c0434299aecc1</MsgId>
            <CreDtTm>2019-01-30T16:13:24.665+03:00</CreDtTm>
            <InitgPty>
                <Id>
                    <OrgId>
                        <AnyBIC>ALFARUMM</AnyBIC>
                        <Othr>
                            <Id>044525593</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>0b94215ea5604a5ab00aad436dad0900</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
            <OrgnlCreDtTm>2019-01-29T15:25:53.000+03:00</OrgnlCreDtTm>
            <GrpSts>RCVD</GrpSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>PKG31d00a62a203465095f93ed1c924ca67</OrgnlPmtInfId>
            <PmtInfSts>RCVD</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>PMTec020f8f93884a8baad2361eaf13f70b</OrgnlInstrId>
                <TxSts>ACTC</TxSts>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>
----
++++
</details>
++++