ym88659208ym87991671
Получение документа 'Валютное платежное поручение' | Документация для разработчиков

Получение документа 'Валютное платежное поручение'

Обновлено 13 марта 2025
GET
/v1/pay-doc-cur/{externalId}

Возвращает полные данные ранее созданного валютного платежного поручения. Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка и идентификатор документа (externalId), указанный при его создании.

Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис PAY_DOC_CUR.

Запрос

Path Parameters

    externalId
    uuid
    required

    Уникальный идентификатор документа, присвоенный партнером

    Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

Ответы

Успешное выполнение запроса

Schema

    bankStatus
    string

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

    bankComment
    string

    Банковский комментарий к статусу документа

    addInfo
    string

    Возможные значения: <= 300 characters

    Примечание

    additionalInfo
    string

    Возможные значения: <= 220 characters

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

    amountTransfer

    object

    amount
    number
    required

    Возможные значения: >= 0.01

    Сумма

    currencyCode
    string
    required

    Значение должно соответствовать регулярному выражению ^[A-Z\d]\d{2}$

    Цифровой код валюты

    currencyName
    string
    required

    Значение должно соответствовать регулярному выражению ^[A-Z]{3}$

    Буквенный ISO-код валюты

    authPersonName
    string

    Возможные значения: <= 60 characters

    ФИО ответственного лица

    authPersonTelfax
    string

    Возможные значения: <= 40 characters

    Телефон ответственного лица

    b77info
    string

    Возможные значения: <= 109 characters

    Информация для регулирующих органов

    beneficiaryAccount
    string

    Возможные значения: <= 34 characters, Value must match regular expression ^[0-9]{1,34}$

    Счет бенефициара

    beneficiaryAddress
    string

    Возможные значения: <= 255 characters

    Адрес бенефициара

    beneficiaryBankAccount
    string

    Значение должно соответствовать регулярному выражению ^[0-9]{1,35}$

    Корреспондентский счет банка бенефициара

    beneficiaryBankAddress
    string

    Возможные значения: <= 255 characters

    Адрес банка бенефициара

    beneficiaryBankBranchName
    string

    Возможные значения: <= 70 characters

    Наименование филиала банка бенефициара

    beneficiaryBankClearingCode

    object

    Клиринговый код банка бенефициара

    clearingCode
    string

    Возможные значения: <= 11 characters

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

    countryCode
    string

    Значение должно соответствовать регулярному выражению ^[A-Z]{2}$

    Обозначение национального клирингового кода банка-посредника

    shortName
    string

    Возможные значения: <= 140 characters

    Сокращенное наименование национального клирингового кода банка-посредника

    symbol
    string

    Значение должно соответствовать регулярному выражению ^[A-Z]{2}$

    Обозначение национального клирингового кода банка-посредника

    beneficiaryBankCountryDigital
    string
    required

    Значение должно соответствовать регулярному выражению ^[0-9]{3}$

    Цифровой код страны банка бенефициара

    beneficiaryBankCountryIso2
    string
    required

    Значение должно соответствовать регулярному выражению ^[A-Z]{2}$

    2х буквенный ISO-код страны банка бенефициара

    beneficiaryBankName
    string
    required

    Возможные значения: <= 140 characters

    Наименование банка бенефициара

    beneficiaryBankPlace
    string
    required

    Возможные значения: <= 255 characters

    Местонахождение банка бенефициара

    beneficiaryBankSwift
    string

    Возможные значения: <= 11 characters

    SWIFT-код банка бенефициара

    beneficiaryBeiCode
    string

    Возможные значения: <= 11 characters

    BEI-код (SWIFT-код)

    beneficiaryCountryDigital
    string
    required

    Значение должно соответствовать регулярному выражению ^[0-9]{3}$

    Цифровой код страны бенефициара

    beneficiaryCountryIso2
    string
    required

    Значение должно соответствовать регулярному выражению ^[A-Z]{2}$

    2х буквенный ISO-код страны бенефициара

    beneficiaryCountryName
    string

    Возможные значения: <= 255 characters, Value must match regular expression ^[А-Яа-я]*$

    Наименование страны бенефициара на русском языке (краткое наименование)

    beneficiaryInn
    string

    Значение должно соответствовать регулярному выражению ^([0-9]{10}|[0-9]{12}|0)$

    ИНН бенефициара. 10 либо 12 цифр, либо 0

    beneficiaryName
    string
    required

    Возможные значения: <= 140 characters

    Наименование бенефициара

    beneficiaryPlace
    string
    required

    Возможные значения: <= 35 characters

    Город (месторасположение) бенефициара

    chargesType
    string
    required

    Значение должно соответствовать регулярному выражению ^(BEN|SHA|OUR)$

    Тип комиссии за перевод BEN, SHA или OUR

    codes23e

    object[]

  • Array [

    • code
    string
    required

    Возможные значения: <= 4 characters

    Код инструкции

    description
    string

    Возможные значения: <= 255 characters

    info
    string

    Возможные значения: <= 30 characters

    Дополнительная информация

  • ]

    • date
    date
    required

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

    digestSignatures

    object[]

    Электронные подписи по дайджесту документа

  • Array [

    • certificateUuid
    uuid
    required

    Уникальный идентификатор сертификата ключа проверки электронной подписи (UUID)

    base64Encoded
    string
    required

    Возможные значения: non-empty

    Значение электронной подписи, закодированное в Base64

  • ]

    • externalId
    uuid
    required

    Идентификатор документа в организации-партнере (UUID)

    factRate
    number

    Фактический курс конверсии

    iMediaBankAddress
    string

    Возможные значения: <= 255 characters

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

    iMediaBankCountryDigital
    string

    Значение должно соответствовать регулярному выражению ^[0-9]{3}$

    Цифровой код страны банка-посредника

    iMediaBankCountryIso2
    string

    Значение должно соответствовать регулярному выражению ^[A-Z]{2}$

    2х буквенный ISO-код страны банка-посредника

    iMediaBankName
    string

    Возможные значения: <= 140 characters

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

    iMediaBankPlace
    string

    Возможные значения: <= 35 characters

    Местоположение банка-посредника

    iMediaBankSwift
    string

    Возможные значения: <= 11 characters

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

    iMediaClearingCode

    object

    Клиринговый код банка бенефициара

    clearingCode
    string

    Возможные значения: <= 11 characters

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

    countryCode
    string

    Значение должно соответствовать регулярному выражению ^[A-Z]{2}$

    Обозначение национального клирингового кода банка-посредника

    shortName
    string

    Возможные значения: <= 140 characters

    Сокращенное наименование национального клирингового кода банка-посредника

    symbol
    string

    Значение должно соответствовать регулярному выражению ^[A-Z]{2}$

    Обозначение национального клирингового кода банка-посредника

    iMediaFilialBankName
    string

    Возможные значения: <= 140 characters

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

    inn
    string
    required

    Значение должно соответствовать регулярному выражению ^([0-9]{10}|[0-9]{12}|0)$

    ИНН клиента

    linkedDocs

    object[]

  • Array [

    • docExtId
    uuid
    required

    Идентификатор документа в организации-партнере (UUID)

    type
    string
    required

    Возможные значения: non-empty и <= 50 characters

    Тип связанного документа

  • ]

    • number
    string

    Значение должно соответствовать регулярному выражению ^[0-9]{1,7}$

    Номер документа

    option50a
    string
    required

    Значение должно соответствовать регулярному выражению ^[KF]$

    Опция "K" , "F" для поля 50а

    option56a
    string

    Значение должно соответствовать регулярному выражению ^[AD]$

    Опция "A", "D" для поля 56а

    option57a
    string
    required

    Значение должно соответствовать регулярному выражению ^[AD]$

    Опция "A", "D" для поля 57а

    option59a
    string

    Значение должно соответствовать регулярному выражению ^[AF]$

    Опция "А", "F" для поля 59а или «без опции»

    orgName
    string
    required

    Возможные значения: <= 160 characters

    Наименование организации клиента

    payerAccount
    string
    required

    Значение должно соответствовать регулярному выражению ^[0-9]{20}$

    Счет перевододателя

    payerAddress
    string
    required

    Возможные значения: <= 120 characters

    Адрес перевододателя

    payerBankBic
    string
    required

    Значение должно соответствовать регулярному выражению ^[0-9]{9}$

    БИК банка перевододателя

    payerBankPlace
    string

    Возможные значения: <= 35 characters

    Местонахождение банка перевододателя

    payerCountryDigital
    string
    required

    Значение должно соответствовать регулярному выражению ^[0-9]{3}$

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

    payerCountryIso2
    string
    required

    Значение должно соответствовать регулярному выражению ^[A-Z]{2}$

    2х буквенный ISO-код страны перевододателя

    payerCountryName
    string
    required

    Возможные значения: <= 80 characters

    Наименование страны перевододателя на русском языке (краткое наименование)

    payerName
    string
    required

    Возможные значения: <= 140 characters

    Международное наименование перевододателя

    payerPlace
    string
    required

    Возможные значения: <= 35 characters

    Город (местонахождение) перевододателя

    paymentDetails
    string
    required

    Возможные значения: <= 146 characters

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

    paymentDirection
    string
    required

    Возможные значения: <= 10 characters

    Направление платежа (Платеж внутри или вне СБРФ): 1-внутри, 0-вне

    rateAgree
    boolean
    required

    С курсом проведения конверсионной операции согласны

    urgent
    boolean
    required

    Срочность. Значение необходимо отправлять, если по счету списания есть возможность отправлять неотложные платежи.

    valueDate
    date

    Дата валютирования/возврата

    amountDebitTotal
    number

    Возможные значения: >= 0.01

    Фактическая сумма списанной валюты

Loading...
Loading...
Это полезный материал?
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.