7. Валютный перевод

URI

POST: /API/v1/ISO20022/Payments

XSD схема

pain.001.001.06

Обратите внимание

Host-to-Host - самостоятельная система, поэтому платежи, отправленные через H2H, не отображаются в АЛБО (ни в старой, ни в новой версии)

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

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

1

R

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

Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

2

R

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

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

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

3

R

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

Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs

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

4

O

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

Document.CstmrCdtTrfInitn.GrpHdr.CtrlSum

Сумма всех отдельных сумм, включенных в сообщение, независимо от валюты.

5

R

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

Document.CstmrCdtTrfInitn.PmtInf.PmtInfId

Указывается идентифкатор группы распоряжений

6

R

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

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId

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

7

R

Метод оплаты

Document.CstmrCdtTrfInitn.PmtInf.PmtMtd

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

8

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

Общий путь Document.CstmrCdtTrfInitn.PmtInf

10

R

Валюта перевода
(буквенный код)

CdtTrfTxInf.Amt.InstdAmt@Ccy

<InstdAmt Ccy="USD">
1000.00
</InstdAmt>

11

R

Сумма перевода

CdtTrfTxInf.Amt.InstdAmt

<InstdAmt Ccy="USD">
1000.00
</InstdAmt>

12

R

Дата перевода

CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt

В случае отсутствия значения в RltdDt, брать из …​/ReqdExctnDt. Формат даты YYYY-MM-DD

13

R

Номер счета плательщика

DbtrAcct.Id.Othr.Id

14

R

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

Dbtr.Nm

15

R

Адрес плательщика

Dbtr.PstlAdr.AdrLine

16

R

ИНН плательщика

Dbtr.Id.OrgId.Othr.Id

17

O

SWIFT-код банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.BICFI

18

O

Наименование банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Nm

19

O

Адрес банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.PstlAdr.AdrLine

20

O

Клиринговый код банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Othr.Issr

21

O

Клиринговый код банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Othr.Id

Поле обязательно по схеме

22

O

Номер счета банка получателя

CdtTrfTxInf.CdtrAgtAcct.Id.IBAN

23

O

Номер счета в банке-корреспонденте

CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id

24

O

SWIFT код банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.BICFI

25

O

Клиринговый код банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.Othr.Issr

26

O

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

CdtTrfTxInf.CdtrAgt.FinInstnId.Nm

27

O

Адрес банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.PstlAdr.AdrLine

28

O

Номер счета получателя IBAN

CdtTrfTxInf.CdtrAcct.Id.IBAN

29

O

Номер счета получателя, в случае если счет не IBAN

CdtTrfTxInf.CdtrAcct.Id.Othr.Id

30

R

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

CdtTrfTxInf.Cdtr.Nm

31

R

Адрес получателя

CdtTrfTxInf.Cdtr.PstlAdr.AdrLine

32

R

Назначение платежа

CdtTrfTxInf.RmtInf.Ustrd

Условия заполнения для платежей в ОАЭ

Центральным Банком Объединенных Арабских Эмиратов (ОАЭ) определены правила оформления платежей в ОАЭ
согласно которым в каждом платеже требуется указание специального кода назначения платежа (далее- код)

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

/BENEFRES/AE//КОД/далее укажите назначение платежа.

Пример: /BENEFRES/AE//SAL/ADDL NARRATIVE

33

R

Тип списания комиссии

CdtTrfTxInf.ChrgBr
или
ChrgBr

DEBT - со счета плательщика
CRED - из суммы платежа
SHAR - со счета плательщика и из суммы платежа

34

O

Номер счета списания комиссии

ChrgsAcct.Id.Othr.Id

35

R

Уникальный id ВП (сквозной)

CdtTrfTxInf.PmtId.EndToEndId

36

O

Признак "Срочность принятия на исполнение перевода банком"

PmtTpInf.InstrPrty
или
CdtTrfTxInf.PmtTpInf.InstrPrty
Приоритет за п.1

37

R

Признак "Срочный перевод"

PmtTpInf.SvcLvl.Cd
или
CdtTrfTxInf.PmtTpInf.SvcLvl.Cd

URGP - срочный платеж
NURG - обычный платеж

38

O

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

CdtTrfTxInf.RmtInf.Strd.AddtlRmtInf

Ответ

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

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

200

OK

-

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

403

Err

User is disabled

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

500

Err

Warrant service error

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

403

Err

User does not have permission

Нет прав на выполнение запроса

406

Err

Signature is missing

Нет подписи

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

403

Err

The signer certificate is not valid (revoked or not active)

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

406

Err

Signature value 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

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

409

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">
  <CstmrCdtTrfInitn>
    <GrpHdr>
      <MsgId>5077018948painMSG2021090100001</MsgId>
      <CreDtTm>2021-09-01T17:08:04+03:00</CreDtTm>
      <NbOfTxs>1</NbOfTxs>
      <CtrlSum>10000</CtrlSum>
      <InitgPty>
        <Nm>"Test Alfa-Link" Limited Liability Company</Nm>
        <Id>
          <OrgId>
            <Othr>
              <Id>7013602245</Id>
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>5077018948painMSG2021090100001</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <PmtTpInf>
        <InstrPrty>NORM</InstrPrty>
      </PmtTpInf>
      <ReqdExctnDt>2021-09-01</ReqdExctnDt>
      <Dbtr>
        <Nm>"Test Alfa-Link" Limited Liability Company</Nm>
        <PstlAdr>
          <Ctry>RU</Ctry>
          <AdrLine>Moscow, Moscovskaya st. 1, RUSSIAN FEDERATION</AdrLine>
        </PstlAdr>
        <Id>
          <OrgId>
            <Othr>
              <Id>7013602245</Id>
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </Dbtr>
      <DbtrAcct>
        <Id>
          <Othr>
            <Id>40702840200000000529</Id>
          </Othr>
        </Id>
        <Ccy>USD</Ccy>
      </DbtrAcct>
      <DbtrAgt>
        <FinInstnId>
          <BICFI>ALFARUMM</BICFI>
        </FinInstnId>
      </DbtrAgt>
      <ChrgsAcct>
        <Id>
          <Othr>
            <Id>40702840200000000529</Id>
          </Othr>
        </Id>
      </ChrgsAcct>
      <CdtTrfTxInf>
        <PmtId>
          <InstrId>5077018948painMSG2021090100001</InstrId>
          <EndToEndId>01372</EndToEndId>
        </PmtId>
        <PmtTpInf>
          <SvcLvl>
            <Cd>NURG</Cd>
          </SvcLvl>
        </PmtTpInf>
        <Amt>
          <InstdAmt Ccy="USD">10000</InstdAmt>
        </Amt>
        <ChrgBr>DEBT</ChrgBr>
        <CdtrAgt>
          <FinInstnId>
            <BICFI>ALFARUMM</BICFI>
            <Nm>AO "ALFA-BANK"</Nm>
            <PstlAdr>
              <Ctry>RU</Ctry>
              <AdrLine>27, KALANCHYOVSKAYA UL. MOSCOW RUSSIAN FEDERATION</AdrLine>
            </PstlAdr>
          </FinInstnId>
        </CdtrAgt>
        <Cdtr>
          <Nm>"Test Alfa-Link Recipient" Limited Liability Company</Nm>
          <PstlAdr>
            <Ctry>RU</Ctry>
            <AdrLine>Moscow, Moscovskaya st. 1, RUSSIAN FEDERATION</AdrLine>
          </PstlAdr>
          <CtryOfRes>RU</CtryOfRes>
        </Cdtr>
        <CdtrAcct>
          <Id>
            <Othr>
              <Id>40702840600000000734</Id>
            </Othr>
          </Id>
        </CdtrAcct>
        <RmtInf>
          <Ustrd>{VO50000} Withdrawal of property from the trust management of the contract</Ustrd>
          <Strd>
            <RfrdDocInf>
              <Tp>
                <CdOrPrtry>
                  <Prtry>POD</Prtry>
                </CdOrPrtry>
              </Tp>
              <RltdDt>2021-09-01</RltdDt>
            </RfrdDocInf>
          </Strd>
        </RmtInf>
      </CdtTrfTxInf>
    </PmtInf>
    <SplmtryData>
      <Envlp>
        <SgntrSt/>
      </Envlp>
    </SplmtryData>
  </CstmrCdtTrfInitn>
</Document>
Пример Валютного Перевода с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива