Основные варианты использования

API позволяет осуществить:

  • отправку подписанного массового платежа в формате pain.001.001
  • запрос статуса массового платежа в формате pain.002.001
  • запрос статуса отдельного платежного поручения в составе массового в формате pain.002.001
  • запрос статуса массового платежа и входящих в него платежных поручений

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

Для отправки в банк подписанного массового платежа необходимо:

  • получить AccessToken
  • сформировать и подписать xml файл в формате Pain.001.001, содержащий платежи (спецификацию формата смотрите на странице Import format файл Raiffeisen_API_isoxml_signed)
  • отправить POST запрос на адрес /dsig/iso20022, в body запроса разместив сформированное xml сообщение
  • получить синхронный ответ о статусе приема сообщения

Пример сформированного в формате Pain.001.001.raif сообщения

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.raifsig" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
	<CstmrCdtTrfInitn>
		<GrpHdr>
			<MsgId>ORCRUWIRE0320202317717602</MsgId>
			<CreDtTm>2023-02-28T05:54:55</CreDtTm>
			<NbOfTxs>2</NbOfTxs>
			<CtrlSum>1000.08</CtrlSum>
			<InitgPty>
				<Nm>ООО Компания Интернэшнл</Nm>
				<Id>
					<OrgId>
						<Othr>
							<Id>1111111118</Id>
							<SchmeNm>
								<Cd>TXID</Cd>
							</SchmeNm>
						</Othr>
					</OrgId>
				</Id>
			</InitgPty>
		</GrpHdr>
		<PmtInf>
			<PmtInfId>ORCRUWIRE0220202317717603</PmtInfId>
			<PmtMtd>TRF</PmtMtd>
			<Dbtr>
				<Nm>ООО Компания Интернэшнл</Nm>
				<Id>
					<OrgId>
						<Othr>
							<Id>1111111118</Id>
							<SchmeNm>
								<Cd>TXID</Cd>
							</SchmeNm>
						</Othr>
					</OrgId>
				</Id>
			</Dbtr>
			<DbtrAcct>
				<Id>
					<Othr>
						<Id>11111810211111888888</Id>
						<SchmeNm>
							<Cd>BBAN</Cd>
						</SchmeNm>
					</Othr>
				</Id>
			</DbtrAcct>
			<DbtrAgt>
				<FinInstnId>
					<ClrSysMmbId>
						<ClrSysId>
							<Cd>RUCBC</Cd>
						</ClrSysId>
						<MmbId>044525700</MmbId>
					</ClrSysMmbId>
					<Nm>a</Nm>
				</FinInstnId>
			</DbtrAgt>
			<DbtrAgtAcct>
				<Id>
					<Othr>
						<Id>30101810200000000700</Id>
						<SchmeNm>
							<Cd>BBAN</Cd>
						</SchmeNm>
					</Othr>
				</Id>
			</DbtrAgtAcct>
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>HMSRUEFT7841912</InstrId>
					<EndToEndId>3</EndToEndId>
				</PmtId>
				<PmtTpInf>
					<SvcLvl>
						<Cd>NURG</Cd>
					</SvcLvl>
					<LclInstrm>
						<Prtry>01</Prtry>
					</LclInstrm>
				</PmtTpInf>
				<Amt>
					<InstdAmt Ccy="RUB">500.00</InstdAmt>
				</Amt>
				<CdtrAgt>
					<FinInstnId>
						<ClrSysMmbId>
							<ClrSysId>
								<Cd>RUCBC</Cd>
							</ClrSysId>
							<MmbId>044525787</MmbId>
						</ClrSysMmbId>
						<Nm>a</Nm>
					</FinInstnId>
				</CdtrAgt>
				<CdtrAgtAcct>
	<Id>
		<Othr>
			<Id>a</Id>
			<SchmeNm>
				<Cd>BBAN</Cd>
			</SchmeNm>
		</Othr>
	</Id>
</CdtrAgtAcct>
				<Cdtr>
					<Nm>ООО ТРОЯН</Nm>
					<Id>
						<OrgId>
							<Othr>
								<Id>7734527918</Id>
								<SchmeNm>
									<Cd>TXID</Cd>
								</SchmeNm>
							</Othr>
						</OrgId>
					</Id>
				</Cdtr>
				<CdtrAcct>
					<Id>
						<Othr>
							<Id>40702810500360001171</Id>
							<SchmeNm>
								<Cd>BBAN</Cd>
							</SchmeNm>
						</Othr>
					</Id>
				</CdtrAcct>
				<Purp>
					<Prtry>5</Prtry>
				</Purp>
				<RmtInf>
					<Ustrd>Оплата сч.№ 23 от 15/02/23 абон.плата по дог.№11111 от22/07/21г за март 2023, в т.ч.НДС 83,33 руб.</Ustrd>
					<Strd>
						<RfrdDocInf>
							<RltdDt>2023-02-28</RltdDt>
						</RfrdDocInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
		</PmtInf>
		<PmtInf>
			<PmtInfId>ORCRUWIRE0220202317717604</PmtInfId>
			<PmtMtd>TRF</PmtMtd>
			<Dbtr>
				<Nm>ООО Компания Интернэшнл</Nm>
				<Id>
					<OrgId>
						<Othr>
							<Id>111111111888</Id>
							<SchmeNm>
								<Cd>TXID</Cd>
							</SchmeNm>
						</Othr>
					</OrgId>
				</Id>
			</Dbtr>
			<DbtrAcct>
				<Id>
					<Othr>
						<Id>11111810211111888888</Id>
						<SchmeNm>
							<Cd>BBAN</Cd>
						</SchmeNm>
					</Othr>
				</Id>
			</DbtrAcct>
			<DbtrAgt>
				<FinInstnId>
					<ClrSysMmbId>
						<ClrSysId>
							<Cd>RUCBC</Cd>
						</ClrSysId>
						<MmbId>044525700</MmbId>
					</ClrSysMmbId>
					<Nm>a</Nm>
				</FinInstnId>
			</DbtrAgt>
			<DbtrAgtAcct>
				<Id>
					<Othr>
						<Id>30101810200000000700</Id>
						<SchmeNm>
							<Cd>BBAN</Cd>
						</SchmeNm>
					</Othr>
				</Id>
			</DbtrAgtAcct>
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>HMSRUEFT7841913</InstrId>
					<EndToEndId>4</EndToEndId>
				</PmtId>
				<PmtTpInf>
					<SvcLvl>
						<Cd>NURG</Cd>
					</SvcLvl>
					<LclInstrm>
						<Prtry>01</Prtry>
					</LclInstrm>
				</PmtTpInf>
				<Amt>
					<InstdAmt Ccy="RUB">500.08</InstdAmt>
				</Amt>
				<CdtrAgt>
					<FinInstnId>
						<ClrSysMmbId>
							<ClrSysId>
								<Cd>RUCBC</Cd>
							</ClrSysId>
							<MmbId>044525411</MmbId>
						</ClrSysMmbId>
						<Nm>a</Nm>
					</FinInstnId>
				</CdtrAgt>
				<CdtrAgtAcct>
	<Id>
		<Othr>
			<Id>a</Id>
			<SchmeNm>
				<Cd>BBAN</Cd>
			</SchmeNm>
		</Othr>
	</Id>
</CdtrAgtAcct>
				<Cdtr>
					<Nm>ООО Софт</Nm>
					<Id>
						<OrgId>
							<Othr>
								<Id>7720714403</Id>
								<SchmeNm>
									<Cd>TXID</Cd>
								</SchmeNm>
							</Othr>
						</OrgId>
					</Id>
				</Cdtr>
				<CdtrAcct>
					<Id>
						<Othr>
							<Id>40702810400000019354</Id>
							<SchmeNm>
								<Cd>BBAN</Cd>
							</SchmeNm>
						</Othr>
					</Id>
				</CdtrAcct>
				<Purp>
					<Prtry>5</Prtry>
				</Purp>
				<Tax>
					<Rcrd>
						<TaxAmt>
							<Rate>10</Rate>
							<TtlAmt Ccy="RUB">52.09</TtlAmt>
						</TaxAmt>
						<AddtlInf>VTIN</AddtlInf>
					</Rcrd>
				</Tax>
				<RmtInf>
					<Ustrd>Оплата сч.№6 от 01.02.23г по дог.№ 2 от 24/08/22</Ustrd>
					<Strd>
						<RfrdDocInf>
							<RltdDt>2023-02-28</RltdDt>
						</RfrdDocInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
		</PmtInf>
		<SplmtryData>
			<Envlp>
				<SgntrSt>
					<ds:Signature Id="SigID1">
						<ds:SignedInfo>
							<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
							<ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>
							<ds:Reference URI="">
								<ds:Transforms>
									<ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
                                    <ds:Transform Algorithm="http://www.w3.org/2002/06/xmldsig-filter2">
										<XPath xmlns="http://www.w3.org/2002/06/xmldsig-filter2" Filter="subtract">//ds:Signature</XPath>
									</ds:Transform>
								</ds:Transforms>
								<ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
								<ds:DigestValue>2oMe1BaO2Nd8qBxdDbtv78WCYgmhbZBJdjgHrwId9oc=</ds:DigestValue>
							</ds:Reference>
						</ds:SignedInfo>
						<ds:SignatureValue>/xB3sjzeeJu9n2+JJlVVgEz8sLKm3IE5KBXrq2o9UlMISwpvzepjemPAHhhHrcta
HJzTHZzvrPuwZKP5o2dDZQ==</ds:SignatureValue>
						<ds:KeyInfo>
							<ds:X509Data>
								<ds:X509Certificate>MIIFNzCCBOSgAwIBAgITfAAGJ4osQ81SjFsaoQABAAYnijAKBggqhQMHAQEDAjCC
AQoxGDAWBgUqhQNkARINMTIzNDU2Nzg5MDEyMzEaMBgGCCqFAwOBAwEBEgwwMDEy
MzQ1Njc4OTAxLzAtBgNVBAkMJtGD0LsuINCh0YPRidGR0LLRgdC60LjQuSDQstCw
0Lsg0LQuIDE4MQswCQYDVQQGEwJSVTEZMBcGA1UECAwQ0LMuINCc0L7RgdC60LLQ
sDEVMBMGA1UEBwwM0JzQvtGB0LrQstCwMSUwIwYDVQQKDBzQntCe0J4gItCa0KDQ
mNCf0KLQni3Qn9Cg0J4iMTswOQYDVQQDDDLQotC10YHRgtC+0LLRi9C5INCj0KYg
0J7QntCeICLQmtCg0JjQn9Ci0J4t0J/QoNCeIjAeFw0yMjA3MjYxMzI3NTBaFw0y
MjEwMjYxMzM3NTBaMIHIMSMwIQYJKoZIhvcNAQkBFhR4bi0tIC03c2JiM2FpcXJ5
MWI5ZjEcMBoGA1UEAwwT0J/RgtC40YbQsCDQnNCw0LnRjzEcMBoGA1UECwwT0J/R
gtC40YbQsCDQnNCw0LnRjzEcMBoGA1UECgwT0J/RgtC40YbQsCDQnNCw0LnRjzEc
MBoGA1UEBwwT0J/RgtC40YbQsCDQnNCw0LnRjzEcMBoGA1UECAwT0J/RgtC40YbQ
sCDQnNCw0LnRjzELMAkGA1UEBhMCUlUwZjAfBggqhQMHAQEBATATBgcqhQMCAiQA
BggqhQMHAQECAgNDAARAYFH9oNuJigPZ8GPZWvu6LF0L8pTCaJ4nN7r0PEdeC7gV
j7fu3V5hW7BxcYB+ixoDF3szm1xmvVCZB1lMXhR35KOCAlkwggJVMA4GA1UdDwEB
/wQEAwIE8DATBgNVHSUEDDAKBggrBgEFBQcDAjAdBgNVHQ4EFgQUzS2ChkN9FatS
4zE+GSu2OweIo8MwHwYDVR0jBBgwFoAUm4Ve+4HcTVkHUWPPvt/aLH/JRDwwggEP
BgNVHR8EggEGMIIBAjCB/6CB/KCB+YaBtWh0dHA6Ly90ZXN0Z29zdDIwMTIuY3J5
cHRvcHJvLnJ1L0NlcnRFbnJvbGwvITA0MjIhMDQzNSEwNDQxITA0NDIhMDQzZSEw
NDMyITA0NGIhMDQzOSUyMCEwNDIzITA0MjYlMjAhMDQxZSEwNDFlITA0MWUlMjAh
MDAyMiEwNDFhITA0MjAhMDQxOCEwNDFmITA0MjIhMDQxZS0hMDQxZiEwNDIwITA0
MWUhMDAyMigxKS5jcmyGP2h0dHA6Ly90ZXN0Z29zdDIwMTIuY3J5cHRvcHJvLnJ1
L0NlcnRFbnJvbGwvdGVzdGdvc3QyMDEyKDEpLmNybDCB2gYIKwYBBQUHAQEEgc0w
gcowRAYIKwYBBQUHMAKGOGh0dHA6Ly90ZXN0Z29zdDIwMTIuY3J5cHRvcHJvLnJ1
L0NlcnRFbnJvbGwvcm9vdDIwMTguY3J0MD8GCCsGAQUFBzABhjNodHRwOi8vdGVz
dGdvc3QyMDEyLmNyeXB0b3Byby5ydS9vY3NwMjAxMmcvb2NzcC5zcmYwQQYIKwYB
BQUHMAGGNWh0dHA6Ly90ZXN0Z29zdDIwMTIuY3J5cHRvcHJvLnJ1L29jc3AyMDEy
Z3N0L29jc3Auc3JmMAoGCCqFAwcBAQMCA0EA7VdgJhf5KOM7uRfpzx4hqRtZLJ/D
KqIl5+iFpeROGTGe9HorbwNA+I3cQkumQ8OLiUPAJAm0MmeRFz2OJeNw8w==</ds:X509Certificate>
							</ds:X509Data>
						</ds:KeyInfo>
					</ds:Signature>
					<ds:Signature Id="SigID2">
						<ds:SignedInfo>
							<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
							<ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>
							<ds:Reference URI="">
								<ds:Transforms>
									<ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
									<ds:Transform Algorithm="http://www.w3.org/2002/06/xmldsig-filter2">
										<XPath xmlns="http://www.w3.org/2002/06/xmldsig-filter2" Filter="subtract">//ds:Signature</XPath>
									</ds:Transform>
								</ds:Transforms>
								<ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
								<ds:DigestValue>2oMe1BaO2Nd8qBxdDbtv78WCYgmhbZBJdjgHrwId9oc=</ds:DigestValue>
							</ds:Reference>
						</ds:SignedInfo>
						<ds:SignatureValue>dB69wTy2QLYv7hFLj99OPULdeDZTe7Ugk1P1QydlEbcT9+JKpv/DSodIM8QGV19r
wWUrK+bz0b6c8iE0Wjx2gQ==</ds:SignatureValue>
						<ds:KeyInfo>
							<ds:X509Data>
								<ds:X509Certificate>MIIE2zCCBIigAwIBAgITfAAGyfb/eHg2bqfbbgABAAbJ9jAKBggqhQMHAQEDAjCC
AQoxGDAWBgUqhQNkARINMTIzNDU2Nzg5MDEyMzEaMBgGCCqFAwOBAwEBEgwwMDEy
MzQ1Njc4OTAxLzAtBgNVBAkMJtGD0LsuINCh0YPRidGR0LLRgdC60LjQuSDQstCw
0Lsg0LQuIDE4MQswCQYDVQQGEwJSVTEZMBcGA1UECAwQ0LMuINCc0L7RgdC60LLQ
sDEVMBMGA1UEBwwM0JzQvtGB0LrQstCwMSUwIwYDVQQKDBzQntCe0J4gItCa0KDQ
mNCf0KLQni3Qn9Cg0J4iMTswOQYDVQQDDDLQotC10YHRgtC+0LLRi9C5INCj0KYg
0J7QntCeICLQmtCg0JjQn9Ci0J4t0J/QoNCeIjAeFw0yMjEwMDUxMjM1MTlaFw0y
MzAxMDUxMjQ1MTlaMG0xEzARBgkqhkiG9w0BCQEWBG1pdmkxDTALBgNVBAMMBG1p
dmkxDTALBgNVBAsMBG1pdmkxDTALBgNVBAoMBG1pdmkxDTALBgNVBAcMBG1pdmkx
DTALBgNVBAgMBG1pdmkxCzAJBgNVBAYTAlJVMGYwHwYIKoUDBwEBAQEwEwYHKoUD
AgIkAAYIKoUDBwEBAgIDQwAEQC38SG2Ni66RLRWqEneBHrYnDS9yx9jc/0ocL9Ra
iiXc9dw8dK6VkaTSPpUSt9l9hfP8lSsVu7Ufcpm1Y+83zbejggJZMIICVTAOBgNV
HQ8BAf8EBAMCBPAwEwYDVR0lBAwwCgYIKwYBBQUHAwIwHQYDVR0OBBYEFEMTlE+X
fcoqem3M7tpzIdtYyl5tMB8GA1UdIwQYMBaAFJuFXvuB3E1ZB1Fjz77f2ix/yUQ8
MIIBDwYDVR0fBIIBBjCCAQIwgf+ggfyggfmGgbVodHRwOi8vdGVzdGdvc3QyMDEy
LmNyeXB0b3Byby5ydS9DZXJ0RW5yb2xsLyEwNDIyITA0MzUhMDQ0MSEwNDQyITA0
M2UhMDQzMiEwNDRiITA0MzklMjAhMDQyMyEwNDI2JTIwITA0MWUhMDQxZSEwNDFl
JTIwITAwMjIhMDQxYSEwNDIwITA0MTghMDQxZiEwNDIyITA0MWUtITA0MWYhMDQy
MCEwNDFlITAwMjIoMSkuY3Jshj9odHRwOi8vdGVzdGdvc3QyMDEyLmNyeXB0b3By
by5ydS9DZXJ0RW5yb2xsL3Rlc3Rnb3N0MjAxMigxKS5jcmwwgdoGCCsGAQUFBwEB
BIHNMIHKMEQGCCsGAQUFBzAChjhodHRwOi8vdGVzdGdvc3QyMDEyLmNyeXB0b3By
by5ydS9DZXJ0RW5yb2xsL3Jvb3QyMDE4LmNydDA/BggrBgEFBQcwAYYzaHR0cDov
L3Rlc3Rnb3N0MjAxMi5jcnlwdG9wcm8ucnUvb2NzcDIwMTJnL29jc3Auc3JmMEEG
CCsGAQUFBzABhjVodHRwOi8vdGVzdGdvc3QyMDEyLmNyeXB0b3Byby5ydS9vY3Nw
MjAxMmdzdC9vY3NwLnNyZjAKBggqhQMHAQEDAgNBAGX2jH2Gy37Cg3PGArV+Na5d
iGlTWSINc8R2lqHH3UXCEeiBGOE4xaXYOaUDpiCzA4ZSh8vMmIbRTFLof8egPIQ=</ds:X509Certificate>
							</ds:X509Data>
						</ds:KeyInfo>
					</ds:Signature>
				</SgntrSt>
			</Envlp>
		</SplmtryData>
	</CstmrCdtTrfInitn>
</Document>

После выполнения POST запроса в синхронном ответе вы получите статус приема сообщения.

Коды ответа

КодОписание кодаПричина ENGПричина RUS
200CreatedThe message successfully is accepted by the bankCообщение успешно принято банком
400Bad requestXML validation errorОшибка валидации XML
401UnauthorizedAuthorization errorОшибка авторизации
403ForbiddenAn access is deniedДоступ к запрошенному ресурсу запрещен
413Payload too largeSize of the file exceeds the limitРазмер файла превышает допустимый
500Internal Server ErrorAn unexpected error has occurred (server unavailablity, etc.)Произошла непредвиденная ошибка (недоступность сервера и т.д.)

Кроме стандартных кодов REST вы получите в body response сообщение в формате Pain.002.001 которое будет содержать статус приема сообщения банком в ISO формате и дополнительное текстовое описание ошибки.

В ответе на отправленное сообщение вы можете получить только два ISO статуса, которые сообщают об упешности приема сообщения банком:

  • PDNG -сообщение принято
  • RJCT - сообщение отклонено

Пример ответа об успешном приеме банком сообщения (код 200+ISO PDNG )

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
	<CstmrPmtStsRpt>
		<GrpHdr>
			<MsgId>087845946c5f490bad0d8ec19059357c</MsgId>
			<CreDtTm>2023-02-28T16:24:34.966268+03:00</CreDtTm>
			<InitgPty>
				<Nm>АО Райффайзенбанк</Nm>
				<PstlAdr>
					<Ctry>RU</Ctry>
				</PstlAdr>
			</InitgPty>
		</GrpHdr>
		<OrgnlGrpInfAndSts>
			<OrgnlMsgId>77700000000000h000000f0011fa57</OrgnlMsgId>
			<OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
			<OrgnlCreDtTm>2022-11-17T15:46:15Z</OrgnlCreDtTm>
			<OrgnlNbOfTxs>1</OrgnlNbOfTxs>
			<OrgnlCtrlSum>30.23</OrgnlCtrlSum>
			<GrpSts>PDNG</GrpSts>
		</OrgnlGrpInfAndSts>
	</CstmrPmtStsRpt>
</Document>

Сообщение может быть не принято (код ISO=RJCT) , в следующих случаях:

  • аутентификация на API Portal не была успешной
  • авторизация в сервисе CIB Ruble payments не была успешной:
    • пользователь, совершающий запрос не является пользователем организации, от имени которой иницируется сообщение с платежной информацией;
    • у организации отстутствуют контракты, позволяющие использовать данный сервис;
    • у пользователя, иницирующего запрос, не достаточно прав и полномочий на выполнение данного запроса
  • xml сообщение, входящее в запрос, не соответствует xsd схеме сообщений сервиса

Пример ответа об отказе в приеме сообщения (код 400+ ISO code RJCT)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>e61f35da3d2e41889f3ebbecf8dc7ffe</MsgId>
            <CreDtTm>2023-06-19T07:55:23.147Z</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <GrpSts>RJCT</GrpSts>
            <StsRsnInf>
                <AddtlInf>Schema validation error</AddtlInf>
                <AddtlInf>FATAL_ERROR: cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:iso:std:iso:20022:tech:xsd:pain.001.001.raif":Sc</AddtlInf>
                <AddtlInf>hmeNm}'. One of '{"urn:iso:std:iso:20022:tech:xsd:pain.001.001.raif":Id}' is expected.</AddtlInf>
                <AddtlInf>line: 14; column: 8; </AddtlInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
    </CstmrPmtStsRpt>
</Document>

Детальная информация по ошибке передается в ответном сообщении в тегах AddtLInf, в следующем порядке:

  • <AddtlInf> Schema validation error </AddtlInf> - причина, по которой банк отверг сообщение
  • <AddtlInf>FATAL_ERROR: cvc-complex-type.2.4.a: Invalid content was found starting with element '{"urn:iso:std:iso:20022:tech:xsd:pain.001.001.raif":Sc</AddtlInf>
  • <AddtlInf>hmeNm}'. One of '{"urn:iso:std:iso:20022:tech:xsd:pain.001.001.raif":Id}' is expected.</AddtlInf> - детальное описание ошибки
  • <AddtlInf> line: 1; column: 808; </AddtlInf> - местоположение в файле закрывающего тэга, в котором произошла ошибка.

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

Пример ответа об отказе в приеме сообщения (код 401+ ISO code RJCT)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>1b9b021c6e7c48d6abff17b5757f58eb</MsgId>
            <CreDtTm>2023-02-28T18:44:17.532542+03:00</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <GrpSts>RJCT</GrpSts>
            <StsRsnInf>
                <AddtlInf>Authorization error</AddtlInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
    </CstmrPmtStsRpt>
</Document>

***В случае недоступности сервиса в ответе будет передан только код = 500 ***

Запрос статуса Массового платежа и отдельного РПП в составе Массового платежа

Вы можете запросить следующие статусы обработки платежных документов:

  • статус Массового платежа
  • статус Массового платежа и статусы всех входящих в него Рублевых платежных поручений
  • статус отдельного Рублевого платежного поручения, входящего в состав Массового платежа

Запрос статуса Массового платежа

Для получения статуса обработки Массового платежа необходимо:

  • получить AccessToken
  • сформировать и отправить GET запрос /iso20022/message/{msgId}/status, где msgId это идентификатор отправленного вами сообщения с платежами
  • получить синхронный ответ со статусом сообщения с платежами

Для Массового платежа вам будут доступны следующие статусы:

ISO CODESTATUSDESCRIPTION
RJCTREJECTEDОтклонен
PDNGPENDINGВ очереди на обработку
FSGNREADY FOR SENDINGЖдет отправки
ACSPPROCESSINGВ работе
ATTNNEEDS ATTENTIONТребует внимания
PARTPARTIALLY DONEЧастично исполнен
ACSCDONEИсполнен
NPMTPAYMENT ID NOT FOUNDПлатеж с таким идентификатором не найден, проверьте идентификатор
DBLCDUPLICATEПлатеж не был создан так как является дубликатом

Формат сообщения pain.002.001, содержащего статус Массового платежа

Подробно с форматом сообщения вы можете ознакомиться в разделе Import format загрузив файл Raiffeisen_pain002001_payments_status.

В ответе, кроме статуса обработки Массового платежа, мы предоставляем информацию о текущем состоянии Массового платежа:

  • количество Рублевых платежных поручений в составе Массового платежа на момент запроса статуса
  • общая сумма Рублевых платежных поручений в составе Массового платежа на момент запроса статуса

Примеры сообщения со статусом Массового платежа

ISO Code - ACSP, Status - PROCESSING

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>2f01d4ea45fa4864a33722e7d4ed74f7</MsgId>
            <CreDtTm>2023-07-14T08:21:48.263Z</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>1233924782</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <OrgnlCreDtTm>2023-07-13T12:28:09.000Z</OrgnlCreDtTm>
            <GrpSts>PDNG</GrpSts>
            <NbOfTxsPerSts>
                <DtldNbOfTxs>2</DtldNbOfTxs>
                <DtldSts>ACSP</DtldSts>
                <DtldCtrlSum>320.28</DtldCtrlSum>
            </NbOfTxsPerSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <TxInfAndSts>
                <StsRsnInf>
                    <AddtlInf>PROCESSING</AddtlInf>
                </StsRsnInf>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>

ISO Code - ACSC, Status - DONE

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>2f01d4ea45fa4864a33722e7d4ed74f7</MsgId>
            <CreDtTm>2023-07-14T08:52:38.263Z</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>1233924782</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <OrgnlCreDtTm>2023-07-13T12:28:09.000Z</OrgnlCreDtTm>
            <GrpSts>PDNG</GrpSts>
            <NbOfTxsPerSts>
                <DtldNbOfTxs>2</DtldNbOfTxs>
                <DtldSts>ACSC</DtldSts>
                <DtldCtrlSum>320.28</DtldCtrlSum>
            </NbOfTxsPerSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <TxInfAndSts>
                <StsRsnInf>
                    <AddtlInf>DONE</AddtlInf>
                </StsRsnInf>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>

ISO Code - NPMT, Status - PAYMENT ID NOT FOUND

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>7d534186414d45d7a8bc56d1343f8eda</MsgId>
            <CreDtTm>2024-07-03T12:21:33.846Z</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>8ffebe938878454fa549aeef980f7af2</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <GrpSts>NPMT</GrpSts>
            <StsRsnInf>
                <AddtlInf>PAYMENT ID NOT FOUND</AddtlInf>
                <AddtlInf>Mass payment with MsgId 8ffebe938878454fa549aeef980f7af2 was not found</AddtlInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
    </CstmrPmtStsRpt>
</Document>

Запрос статуса Массового платежа и всех входящих в него рублевых платежных поручений

Для получения статуса обработки Массового платежа и статусов всех входящих в него Рублевых платежных поручений, необходимо:

  • получить AccessToken
  • сформировать и отправить GET запрос /iso20022/message/{msgId}/status/full, где msgId это идентификатор отправленного вами сообщения с платежами
  • получить синхронный ответ со статусами документов: Массовый платеж и Рублевые платежные поручения.

Для Массового платежа вам будут доступны следующие статусы:

ISO CODESTATUSDESCRIPTION
RJCTREJECTEDОтклонен
PDNGPENDINGВ очереди на обработку
FSGNREADY FOR SENDINGЖдет отправки
ACSPPROCESSINGВ работе
ATTNNEEDS ATTENTIONТребует внимания
PARTPARTIALLY DONEЧастично исполнен
ACSCDONEИсполнен
NPMTPAYMENT ID NOT FOUNDПлатеж с таким идентификатором не найден, проверьте идентификатор
DBLCDUPLICATEПлатеж не был создан так как является дубликатом

Для Рублевого платежного поручения вам будут доступны следующие статусы:

ISO CODESTATUSDESCRIPTION
RJCTREJECTEDОтклонен
PDNGPENDINGВ очереди на обработку
FSGNREADY FOR SENDINGЖдет отправки
ACSPPROCESSINGВ работе
ATTNNEEDS ATTENTIONТребует внимания
CANCREVOKEDОтозван
ACSCDONEИсполнен
NPMTPAYMENT ID NOT FOUNDПлатеж с таким идентификатором не найден, проверьте идентификатор
DBLCDUPLICATEПлатеж не был создан так как является дубликатом

Формат сообщения pain002.001, содержащего статусы рублевых платежных поручений в составе Массового платежа

Подробно с форматом сообщения вы можете ознакомиться в разделе Import format загрузив файл Raiffeisen_pain002001_payments_status.

Пример сообщения со статусом Массового платежа и всех Рублевых платежных поручений, в составе Массового платежа

Массовый платеж, содержит пять Рублевых платежных поручений и находится в статусе "Частично исполнен", так как два из пяти Рублевых платежных поручений были отклонены, а три исполнены.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>7500032fd7fd4cc09867798f38fd70e4</MsgId>
            <CreDtTm>2024-06-24T09:28:15.110Z</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>1184946705</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <OrgnlCreDtTm>2024-03-07T13:28:49.000Z</OrgnlCreDtTm>
            <OrgnlNbOfTxs>5</OrgnlNbOfTxs>
            <OrgnlCtrlSum>9000.99</OrgnlCtrlSum>
            <GrpSts>PDNG</GrpSts>
            <NbOfTxsPerSts>
                <DtldNbOfTxs>5</DtldNbOfTxs>
                <DtldSts>PART</DtldSts>
                <DtldCtrlSum>9000.99</DtldCtrlSum>
            </NbOfTxsPerSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>1154694812</OrgnlPmtInfId>
            <PmtInfSts>ACSC</PmtInfSts>
        </OrgnlPmtInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>1163926138</OrgnlPmtInfId>
            <PmtInfSts>ACSC</PmtInfSts>
        </OrgnlPmtInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>1054259923</OrgnlPmtInfId>
            <PmtInfSts>ACSC</PmtInfSts>
        </OrgnlPmtInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>1162364846</OrgnlPmtInfId>
            <PmtInfSts>RJCT</PmtInfSts>
        </OrgnlPmtInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>1108107023</OrgnlPmtInfId>
            <PmtInfSts>RJCT</PmtInfSts>
        </OrgnlPmtInfAndSts>
	 </CstmrPmtStsRpt>
</Document>

Запрос статуса Рублевого платежного поручения в составе Массового платежа

Для получения статуса обработки отдельного Рублевого платежного поручения, отправленного в составе Массового платежа, необходимо:

  • получить AccessToken
  • сформировать и отправить GET запрос /iso20022/message/{msgId}/payment/{PmtInfId}/status , где msgId это идентификатор отправленного вами сообщения с платежами, а PmtInfId это идентификатор Рублевого платежного поручения
  • получить синхронный ответ со статусами документов

Для Рублевого платежного поручения вам будут доступны следующие статусы:

ISO CODESTATUSDESCRIPTION
RJCTREJECTEDОтклонен
PDNGPENDINGВ очереди на обработку
FSGNREADY FOR SENDINGЖдет отправки
ACSPPROCESSINGВ работе
ATTNNEEDS ATTENTIONТребует внимания
CANCREVOKEDОтозван
ACSCDONEИсполнен
NPMTPAYMENT ID NOT FOUNDПлатеж с таким идентификатором не найден, проверьте идентификатор
DBLCDUPLICATEПлатеж не был создан так как является дубликатом

Формат сообщения pain002.001, содержащего статус Рублевого платежного поручения, в составе Массового платежа

Подробно с форматом сообщения вы можете ознакомиться в разделе Import format загрузив файл Raiffeisen_pain002001_payments_status.

Примеры сообщения со статусом Рублевого платежного поручения, отправленного в составе Массового платежа

ISO Code - RJCT, Status - REJECTED

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>2e90f47d07424c20b0ec6c7dbe20f219</MsgId>
            <CreDtTm>2024-07-09T14:23:52.878Z</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>1224505675</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <OrgnlCreDtTm>2024-07-09T17:09:14.000Z</OrgnlCreDtTm>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>1234822979</OrgnlPmtInfId>
            <PmtInfSts>RJCT</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>55C3667d5cf54fb4b19d29443b91b389</OrgnlInstrId>
                <OrgnlEndToEndId>477206</OrgnlEndToEndId>
                <TxSts>RJCT</TxSts>
                <StsRsnInf>
                    <AddtlInf>REJECTED</AddtlInf>
                    <AddtlInf>3.13 Реквизит "(9) Счет плательщика" не найден в справочнике клиентов банка.</AddtlInf>
                </StsRsnInf>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>

ISO Code - ATTN, Status - NEEDS ATTENTION

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>9968b942b9dc4a72abf1b36e683e4a65</MsgId>
            <CreDtTm>2024-07-09T12:09:27.839Z</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>ORCR111UWIRE032012317717602</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <OrgnlCreDtTm>2024-07-03T05:54:55.000Z</OrgnlCreDtTm>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>ORCRUWIRE0220202317717605</OrgnlPmtInfId>
            <PmtInfSts>ATTN</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>HMSRUEFT7841922</OrgnlInstrId>
                <OrgnlEndToEndId>4</OrgnlEndToEndId>
                <TxSts>ATTN</TxSts>
                <StsRsnInf>
                    <AddtlInf>NEEDS ATTENTION</AddtlInf>
                </StsRsnInf>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>

ISO Code - ACSC, Status -DONE

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.12">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>9968b942b9dc4a72abf1b36e683e4a65</MsgId>
            <CreDtTm>2024-07-09T12:09:27.839Z</CreDtTm>
            <InitgPty>
                <Nm>АО Райффайзенбанк</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>ORCR111UWIRE032012317717602</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.raif</OrgnlMsgNmId>
            <OrgnlCreDtTm>2024-07-03T05:54:55.000Z</OrgnlCreDtTm>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>ORCRUWIRE0220202317717608</OrgnlPmtInfId>
            <PmtInfSts>ACSC</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>HMSRUEFT7847913</OrgnlInstrId>
                <OrgnlEndToEndId>4</OrgnlEndToEndId>
                <TxSts>ACSC</TxSts>
                <StsRsnInf>
                    <AddtlInf>DONE</AddtlInf>
                </StsRsnInf>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>