7. Валютный перевод
URI
POST: /API/v1/ISO20022/Payments
XSD схема
pain.001.001.06
Описание схемы
Описание | Путь | Комментарий Пример |
||
---|---|---|---|---|
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"> |
11 |
R |
Сумма перевода |
CdtTrfTxInf.Amt.InstdAmt |
<InstdAmt Ccy="USD"> |
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 |
DEBT - со счета плательщика |
34 |
O |
Номер счета списания комиссии |
ChrgsAcct.Id.Othr.Id |
|
35 |
R |
Уникальный id ВП (сквозной) |
CdtTrfTxInf.PmtId.EndToEndId |
|
36 |
O |
Признак "Срочность принятия на исполнение перевода банком" |
PmtTpInf.InstrPrty |
|
37 |
R |
Признак "Срочный перевод" |
PmtTpInf.SvcLvl.Cd |
URGP - срочный платеж |
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>