Подтвердить списание
/v2/Confirm
https://securepay.tinkoff.ru/v2/Confirm
Метод подтверждает списание денег с карты покупателя.
Используется при двухстадийном платеже.
Применим только к платежам в статусе AUTHORIZED
. Сумма списания может быть меньше или равна сумме авторизации.
Запрос
Request body schema application/json
Required
TerminalKey
String
Идентификатор терминала. Выдается мерчанту в Т‑Бизнес при заведении терминала.
Required
PaymentId
String
Requirements: <= 20 characters
Идентификатор платежа в системе Т‑Бизнес.
Required
Token
String
Подпись запроса. Формируется по инструкции.
IP
String
IP-адрес покупателя.
Amount
Number
Сумма в копейках. Если не передан, используется Amount
, который был передан в методе Инициировать платеж.
Receipt
Object
JSON-объект с данными чека. Параметр обязательный, если подключена онлайн-касса.
Receipt
Object
JSON-объект с данными чека. Параметр обязательный, если подключена онлайн-касса.
- Receipt_FFD_12
- Receipt_FFD_105
Required
FfdVersion
String
Версия ФФД. Возможные значения — 1.2
и 1.05
.
Версия ФФД по умолчанию — 1.05
.
ClientInfo
Object (ClientInfo)
Информация по клиенту.
ClientInfo
Object (ClientInfo)
Информация по клиенту.
Birthdate
String
Тег ФФД: 1243
Дата рождения клиента в формате ДД.ММ.ГГГГ
.
Citizenship
String
Тег ФФД: 1244
Числовой код страны, гражданином которой является клиент. Код страны указывается в соответствии с Общероссийским классификатором стран мира ОКСМ.
DocumentСode
String
Тег ФФД: 1245
Числовой код вида документа, удостоверяющего личность.
Может принимать только следующие значения:
21
‑ Паспорт гражданина Российской Федерации22
‑ Паспорт гражданина Российской Федерации, дипломатический паспорт, служебный паспорт, удостоверяющие личность гражданина Российской Федерации за пределами Российской Федерации26
‑ Временное удостоверение личности гражданина Российской Федерации, выдаваемое на период оформления паспорта гражданина Российской Федерации27
‑ Свидетельство о рождении гражданина Российской Федерации — для граждан Российской Федерации в возрасте до 14 лотереи28
‑ Иные документы, признаваемые документами, удостоверяющими личность гражданина Российской Федерации в соответствии с законодательством Российской Федерации31
‑ Паспорт иностранного гражданина32
‑ Иные документы, признаваемые документами, удостоверяющими личность иностранного гражданина в соответствии с законодательством Российской Федерации и международным договором Российской Федерации33
‑ Документ, выданный иностранным государством и признаваемый в соответствии с международным договором Российской Федерации в качестве документа, удостоверяющего личность лица безгражданства34
‑ Вид на жительство — для лиц без гражданства35
- Разрешение на временное проживание — для лиц без гражданства36
‑ Свидетельство о рассмотрении ходатайства о признании лица без гражданства беженцем на территории Российской Федерации по существу37
‑ Удостоверение беженца38
‑ Иные документы, признаваемые документами, удостоверяющими личность лиц без гражданства в соответствии с законодательством Российской Федерации и международным договором Российской Федерации40
‑ Документ, удостоверяющий личность лица, не имеющего действительного документа, удостоверяющего личность, на период рассмотрения заявления о признании гражданином Российской Федерации или о приеме в гражданство Российской Федерации
DocumentData
String
Тег ФФД: 1246
Реквизиты документа, удостоверяющего личность. Например, серия и номер паспорта.
Address
String
Requirements: <= 256 characters
Тег ФФД: 1254
Адрес клиента-грузополучателя.
Required
Taxation
String
Requirements: [osn
, usn_income
, usn_income_outcome
, esn
, patent
]
Тег ФФД: 1055
Система налогообложения. Возможные значения:
osn
— общая СН;usn_income
— упрощенная СН (доходы);usn_income_outcome
— упрощенная СН (доходы минус расходы);esn
— единый сельскохозяйственный налог;patent
— патентная СН.
String<email>
Requirements: <= 64 characters
Тег ФФД: 1008
Электронная почта клиента.
Параметр обязательный, если не передан Phone
.
Phone
String
Requirements: <= 64 characters
Тег ФФД: 1008
Телефон клиента в формате +{Ц}
.
Параметр обязательный, если не передан Email
.
Customer
String
Тег ФФД: 1227
Идентификатор/имя клиента.
CustomerInn
String
Тег ФФД: 1228
ИНН клиента.
Required
Items
Array (Items_FFD_12)
Массив, содержащий в себе информацию о товарах. Количество товаров чеке не более 100.
Параметры, которые предусмотрены в протоколе для отправки чеков по маркируемым товарам, не являются
обязательными для товаров без маркировки. Если используется ФФД 1.2, но реализуемый товар не
подлежит маркировке, поля можно не отправлять или отправить со значением null
.
Required
Items
Array (Items_FFD_12)
Массив, содержащий в себе информацию о товарах. Количество товаров чеке не более 100.
Параметры, которые предусмотрены в протоколе для отправки чеков по маркируемым товарам, не являются
обязательными для товаров без маркировки. Если используется ФФД 1.2, но реализуемый товар не
подлежит маркировке, поля можно не отправлять или отправить со значением null
.
AgentData
Object (AgentData)
Данные агента. Параметр обязательный, если используется агентская схема.
AgentData
Object (AgentData)
Данные агента. Параметр обязательный, если используется агентская схема.
AgentSign
String
Тег ФФД: 1222
Признак агента. Возможные значения:
bank_paying_agent
— банковский платежный агент;bank_paying_subagent
— банковский платежный субагент;paying_agent
— платежный агент;paying_subagent
— платежный субагент;attorney
— поверенный;commission_agent
— комиссионер;another
— другой тип агента.
OperationName
String
Requirements: <= 64 characters
Тег ФФД: 1044
Наименование операции.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
Phones
Array
Requirements: <= 19 characters
Тег ФФД: 1073
Телефоны платежного агента в формате +{Ц}
.
Параметр обязательный, если AgentSign
передан в значениях:
bank_paying_agent
;bank_paying_subagent
;paying_agent
;paying_subagent
.
ReceiverPhones
Requirements: <= 19 characters
Тег ФФД: 1074
Телефоны оператора по приему платежей в формате +{Ц}
.
Параметр обязательный, если AgentSign
передан в значениях paying_agent
или paying_subagent
.
TransferPhones
Requirements: <= 19 characters
Тег ФФД: 1075
Телефоны оператора перевода в формате +{Ц}
.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
OperatorName
String
Requirements: <= 64 characters
Тег ФФД: 1026
Наименование оператора перевода.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
OperatorAddress
String
Requirements: <= 243 characters
Тег ФФД: 1005
Адрес оператора перевода.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
OperatorInn
String
Requirements: <= 12 characters
Тег ФФД: 1016
ИНН оператора перевода.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
SupplierInfo
Object (SupplierInfo)
Данные поставщика платежного агента.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
SupplierInfo
Object (SupplierInfo)
Данные поставщика платежного агента.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
Phones
Array
Requirements: <= 19 characters
Тег ФФД: 1171
Телефон поставщика в формате +{Ц}
.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
Name
String
Requirements: <= 239 characters
Тег ФФД: 1225
Наименование поставщика.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
Состоит из 239 символов, в которые включаются телефоны поставщика — + 4 символа на каждый телефон.
Например, если передано два телефона поставщика длиной 12 и 14 символов, максимальная длина наименования поставщика будет 239 – (12 + 4) – (14 + 4) = 205 символов.
Inn
String
Requirements: >= 10 characters
and <= 12 characters
Тег ФФД: 1226
ИНН поставщика в формате ЦЦЦЦЦЦЦЦЦЦ
.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
Required
Name
String
Requirements: <= 128 characters
Тег ФФД: 1030
Наименование товара.
Required
Price
Number
Тег ФФД: 1079
Цена в копейках.
Required
Quantity
Number
Requirements: <= 8 characters
Тег ФФД: 1023
Количество или вес товара. Максимальное количество символов — 8, где:
- целая часть — не больше 5 знаков,
- дробная — не больше 3 знаков для Атол и 2 знаков для CloudPayments.
Required
Amount
Number
Requirements: <= 10 characters
Тег ФФД: 1043
Стоимость товара в копейках.
Произведение Quantity
и Price
.
Required
Tax
String
Requirements: [none
, vat0
, vat5
, vat7
, vat10
, vat20
, vat105
, vat107
, vat110
, vat120
]
Тег ФФД: 1199
Ставка НДС. Возможные значения:
none
— без НДС;vat0
— НДС по ставке 0%;vat5
— НДС по ставке 5%;vat7
— НДС по ставке 7%;vat10
— НДС по ставке 10%;vat20
— НДС по ставке 20%;vat105
— НДС чека по расчетной ставке 5/105;vat107
— НДС чека по расчетной ставке 7/107;vat110
— НДС чека по расчетной ставке 10/110;vat120
— НДС чека по расчетной ставке 20/120.
Required
PaymentMethod
String
Requirements: [full_prepayment
, prepayment
, advance
, full_payment
, partial_payment
, credit
, credit_payment
]
Default: full_payment
Тег ФФД: 1214
Признак способа расчета. Возможные значения:
full_prepayment
— предоплата 100%;prepayment
— предоплата;advance
— аванс;full_payment
— полный расчет;partial_payment
— частичный расчет и кредит;credit
— передача в кредит;credit_payment
— оплата кредита.
Если значение не передано, по умолчанию в онлайн-кассу
отправляется признак предмета расчета full_payment
.
Required
PaymentObject
String
Requirements: [commodity
, excise
, job
, service
, gambling_bet
, gambling_prize
, lottery
, lottery_prize
, intellectual_activity
, payment
, agent_commission
, contribution
, property_rights
, unrealization
, tax_reduction
, trade_fee
, resort_tax
, pledge
, income_decrease
, ie_pension_insurance_without_payments
, ie_pension_insurance_with_payments
, ie_medical_insurance_without_payments
, ie_medical_insurance_with_payments
, social_insurance
, casino_chips
, agent_payment
, excisable_goods_without_marking_code
, excisable_goods_with_marking_code
, goods_without_marking_code
, goods_with_marking_code
, another
]
Тег ФФД: 1212
Значения реквизита «признак предмета расчета» — тег 1212, таблица 101. Возможные значения:
commodity
— товар;excise
— подакцизный товар;job
— работа;service
— услуга;gambling_bet
— ставка азартной игры;gambling_prize
— выигрыш азартной игры;lottery
— лотерейный билет;lottery_prize
— выигрыш лотереи;intellectual_activity
— предоставление, результатов интеллектуальной деятельности;payment
— платеж;agent_commission
— агентское вознаграждение;contribution
— выплата;property_rights
— имущественное право;unrealization
— внереализационный доход;tax_reduction
— иные платежи и взносы;trade_fee
— торговый сбор;resort_tax
— курортный сбор;pledge
— залог;income_decrease
— расход;ie_pension_insurance_without_payments
— взносы на ОПС ИП;ie_pension_insurance_with_payments
— взносы на ОПС;ie_medical_insurance_without_payments
— взносы на ОМС ИП;ie_medical_insurance_with_payments
— взносы на ОМС;social_insurance
— взносы на ОСС;casino_chips
— платеж казино;agent_payment
— выдача ДС;excisable_goods_without_marking_code
— АТНМ;excisable_goods_with_marking_code
— АТМ;goods_without_marking_code
— ТНМ;goods_with_marking_code
— ТМ;another
— иной предмет расчета.
UserData
String
Тег ФФД: 1191
Дополнительный реквизит предмета расчета.
Excise
String
Тег ФФД: 1229
Сумма акциза в рублях с учетом копеек, которая включена в стоимость предмета расчета:
- целая часть — не больше 8 знаков;
- дробная часть — не больше 2 знаков;
- значение не может быть отрицательным.
CountryCode
String
Requirements: <= 3 characters
Тег ФФД: 1230
Цифровой код страны происхождения товара в соответствии с Общероссийским классификатором стран мира — 3 цифры.
DeclarationNumber
String
Requirements: <= 32 characters
Тег ФФД: 1231
Номер таможенной декларации.
Required
MeasurementUnit
String
Тег ФФД: 2108
Единицы измерения.
Возможные варианты:
шт
‑ применяется для предметов расчета, которые могут быть реализованы поштучно или единицами;г
‑ грамм;кг
‑ килограмм;т
‑ тонна;см
‑ сантиметр;дм
‑ дециметр;м
‑ метр;см2
‑ квадратный сантиметр;дм2
‑ квадратный дециметр;м2
‑ квадратный метр;мл
‑ миллиметр;л
‑ китр;м3
‑ кубический метр;кВт*ч
‑ киловатт/час;Гкал
‑ гигакалория;сут
илидн
‑ сутки или день;ч
‑ час;мин
‑ минута;с
‑ секунда;Кбайт
‑ килобайт;Мбайт
‑ мегабайт;Гбайт
‑ гигабайт;Тбайт
‑ терабайт;-
‑ применяется при использовании иных едениц измерения
Также возможна передача произвольных значений.
Параметр обязательный, если версия ФФД онлайн-кассы — 1.2
.
MarkProcessingMode
String
Тег ФФД: 2102
Режим обработки кода маркировки.
Должен принимать значение, равное 0
.
Включается в чек , если предметом расчета
является товар, который подлежит обязательной
маркировке сканером — соответствующий код в поле paymentObject
.
MarkCode
Array (MarkCode)
Тег ФФД: 1163
Код маркировки. Предназначен
для нанесения на потребительскую упаковку,
товары или товарный ярлык.
Включается в чек, если предметом расчета является товар, который подлежит обязательной маркировке сканером — соответствующий код в поле paymentObject
.
MarkCode
Array (MarkCode)
Тег ФФД: 1163
Код маркировки. Предназначен для нанесения на потребительскую упаковку, товары или товарный ярлык.
Включается в чек, если предметом расчета является товар, который подлежит обязательной маркировке сканером — соответствующий код в поле paymentObject
.
Required
MarkCodeType
String
Тип штрих кода. Возможные значения:
UNKNOWN
— код товара, формат которого не идентифицирован, как один из реквизитов;EAN8
— код товара в формате EAN-8;EAN13
— код товара в формате EAN-13;ITF14
— код товара в формате ITF-14;GS10
— код товара в формате GS1, который нанесен на товар, не подлежащий маркировке;GS1M
— код товара в формате GS1, который нанесен на товар, подлежащий маркировке;SHORT
— код товара в формате короткого кода маркировки, который нанесен на товар;FUR
— контрольно-идентификационный знак мехового изделия;EGAIS20
— код товара в формате ЕГАИС-2.0;EGAIS30
— код товара в формате ЕГАИС-3.0;RAWCODE
— код маркировки, как он был прочитан сканером.
Required
Value
String
Код маркировки.
MarkQuantity
Object (MarkQuantity)
Реквизит «дробное количество маркированного товара».
Передается, только если расчет осуществляется
за маркированный товар — соответствующий код в поле
paymentObject
и значение в поле measurementUnit
равно 0
.
Пример:
{
"numenator": "1"
"denominator" "2"
}
MarkQuantity
Object (MarkQuantity)
Реквизит «дробное количество маркированного товара».
Передается, только если расчет осуществляется
за маркированный товар — соответствующий код в поле
paymentObject
и значение в поле measurementUnit
равно 0
.
Пример:
{
"numenator": "1"
"denominator" "2"
}
Numerator
Number
Тег ФФД: 1293
Числитель дробной части предмета расчета. Значение должно быть строго меньше значения реквизита «знаменатель».
Denominator
Number
Тег ФФД: 1294
Знаменатель дробной части предмета расчета. Значение равно количеству товара в партии (упаковке), которая имет общий код маркировки товара.
SectoralItemProps
Array (SectoralItemProps)
Отраслевой реквизит предмета расчета. Указывается только для товаров, которые подлежат обязательной маркировке сканером. Включение этого реквизита предусмотрено НПА отраслевого регулирования для
соответствующей товарной группы.
SectoralItemProps
Array (SectoralItemProps)
Отраслевой реквизит предмета расчета. Указывается только для товаров, которые подлежат обязательной маркировке сканером. Включение этого реквизита предусмотрено НПА отраслевого регулирования для соответствующей товарной группы.
Required
FederalId
String
Тег ФФД: 1262
Идентификатор ФОИВ — федеральный орган исполнительной власти.
Required
Date
String<date>
Тег ФФД: 1263
Дата нормативного акта ФОИВ.
Required
Number
String
Тег ФФД: 1264
Номер нормативного акта ФОИВ.
Required
Value
String
Тег ФФД: 1265
Состав значений, котрые определены нормативным актом ФОИВ.
Payments
Array (Payments)
Детали платежа.
Если объект не передан, будет автоматически указана итоговая
сумма чека с видом оплаты «Безналичный».
Если передан объект receipt.Payments
, значение в Electronic
должно быть равно итоговому значению Amount
в методе Инициировать платеж.
При этом сумма введенных значений по всем видам оплат,
включая Electronic
, должна быть равна сумме (Amount
) всех товаров,
которые были переданы в объекте receipt.Items
Payments
Array (Payments)
Детали платежа.
Если объект не передан, будет автоматически указана итоговая сумма чека с видом оплаты «Безналичный».
Если передан объект receipt.Payments
, значение в Electronic
должно быть равно итоговому значению Amount
в методе Инициировать платеж.
При этом сумма введенных значений по всем видам оплат,
включая Electronic
, должна быть равна сумме (Amount
) всех товаров,
которые были переданы в объекте receipt.Items
Cash
Number
Requirements: <= 14 characters
Тег ФФД: 1031.
Вид оплаты «Наличные». Сумма к оплате в копейках.
Required
Electronic
Number
Requirements: <= 14 characters
Тег ФФД: 1081.
Вид оплаты «Безналичный».
AdvancePayment
Number
Requirements: <= 14 characters
Тег ФФД: 1215.
Вид оплаты «Предварительная оплата (Аванс)».
Credit
Number
Requirements: <= 14 characters
Тег ФФД: 1216.
Вид оплаты «Постоплата (Кредит)».
Provision
Number
Requirements: <= 14 characters
Тег ФФД: 1217.
Вид оплаты «Иная форма оплаты».
Required
Items
Array of objects ()
Массив позиций чека с информацией о товарах. Количество товаров чеке не более 100.
Required
Items
Array of objects ()
Массив позиций чека с информацией о товарах. Количество товаров чеке не более 100.
Required
Name
String
Requirements: <= 128 characters
Тег ФФД: 1030
Наименование товара.
Required
Price
Number
Тег ФФД: 1078
Цена в копейках.
Required
Quantity
Number
Requirements: <= 8 characters
Тег ФФД: 1023
Количество или вес товара. Максимальное количество символов — 8, где:
- целая часть — не больше 5 знаков;
- дробная — не больше 3 знаков для Атол и 2 знаков для CloudPayments.
Required
Amount
Number
Requirements: <= 10 characters
Тег ФФД: 1043
Стоимость товара в копейках.
Произведение Quantity
и Price
.
PaymentMethod
String
Requirements: [full_prepayment
, prepayment
, advance
, full_payment
, partial_payment
, credit
, credit_payment
]
Default: full_payment
Тег ФФД: 1214
Признак способа расчета. Возможные значения:
full_prepayment
— предоплата 100%;prepayment
— предоплата;advance
— аванс;full_payment
— полный расчет;partial_payment
— частичный расчет и кредит;credit
— передача в кредит;credit_payment
— оплата кредита.
Если значение не передано, по умолчанию в онлайн-кассу
отправляется признак предмета расчета full_payment
.
PaymentObject
String
Requirements: [commodity
, excise
, job
, service
, gambling_bet
, gambling_prize
, lottery
, lottery_prize
, intellectual_activity
, payment
, agent_commission
, composite
, another
]
Default: commodity
Тег ФФД: 1212
Признак предмета расчета. Возможные значения:
commodity
— товар;excise
— подакцизный товар;job
— работа;service
— услуга;gambling_bet
— ставка азартной игры;gambling_prize
— выигрыш азартной игры;lottery
— лотерейный билет;lottery_prize
— выигрыш лотереи;intellectual_activity
— предоставление результатов интеллектуальной деятельности;payment
— платеж;agent_commission
— агентское вознаграждение;composite
— составной предмет расчета;another
— иной предмет расчета.
Если значение не передано, по умолчанию в онлайн-кассу
отправляется признак предмета расчета commodity
.
Required
Tax
String
Requirements: [none
, vat0
, vat5
, vat7
, vat10
, vat20
, vat105
, vat107
, vat110
, vat120
]
Тег ФФД: 1199
Ставка НДС. Перечисление со значениями:
none
— без НДС,vat0
— НДС по ставке 0%;vat5
— НДС по ставке 5%;vat7
— НДС по ставке 7%;vat10
— НДС по ставке 10%;vat20
— НДС по ставке 20%;vat105
— НДС чека по расчетной ставке 5/105;vat107
— НДС чека по расчетной ставке 7/107;vat110
— НДС чека по расчетной ставке 10/110;vat120
— НДС чека по расчетной ставке 20/120.
Ean13
String
Requirements: <= 300 characters
Тег ФФД: 1162
Штрих-код. В зависимости от типа кассы требования к штрих-коду могут отличаться:
-
АТОЛ Онлайн — шестнадцатеричное представление с пробелами. Максимальная длина – 32 байта (^[a-fA-F0-9]{2}$)|(^([afA-F0-9]{2}\s){1,31}[a-fA-F0-9]{2}$).
Пример:00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00
-
CloudKassir — длина строки: четная, от 8 до 150 байт. То есть от 16 до 300 ASCII символов ['0' - '9' , 'A' - 'F' ] шестнадцатеричного представления кода маркировки товара.
Пример:303130323930303030630333435
-
OrangeData — строка, содержащая
base64
- кодированный массив от 8 до 32 байт.
Пример:igQVAAADMTIzNDU2Nzg5MDEyMwAAAAAAAQ==
Если в запросе передается параметр Ean13
, который не
прошел валидацию, то вернется неуспешный
ответ с текстом ошибки в параметре message
=
Неверный параметр Ean13
.
ShopCode
String
Код магазина. Для параметра ShopСode
нужно использовать значение параметра
Submerchant_ID
, который возвращается в ответе при
регистрации магазинов через XML. Если XML не
используется, передавать поле не нужно.
AgentData
Object (AgentData)
Данные агента.
Параметр обязательный, если используется агентская схема.
AgentData
Object (AgentData)
Данные агента. Параметр обязательный, если используется агентская схема.
AgentSign
String
Тег ФФД: 1222
Признак агента. Возможные значения:
bank_paying_agent
— банковский платежный агент;bank_paying_subagent
— банковский платежный субагент;paying_agent
— платежный агент;paying_subagent
— платежный субагент;attorney
— поверенный;commission_agent
— комиссионер;another
— другой тип агента.
OperationName
String
Requirements: <= 64 characters
Тег ФФД: 1044
Наименование операции.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
Phones
Array
Requirements: <= 19 characters
Тег ФФД: 1073
Телефоны платежного агента в формате +{Ц}
.
Параметр обязательный, если AgentSign
передан в значениях:
bank_paying_agent
;bank_paying_subagent
;paying_agent
;paying_subagent
.
ReceiverPhones
Requirements: <= 19 characters
Тег ФФД: 1074
Телефоны оператора по приему платежей в формате +{Ц}
.
Параметр обязательный, если AgentSign
передан в значениях paying_agent
или paying_subagent
.
TransferPhones
Requirements: <= 19 characters
Тег ФФД: 1075
Телефоны оператора перевода в формате +{Ц}
.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
OperatorName
String
Requirements: <= 64 characters
Тег ФФД: 1026
Наименование оператора перевода.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
OperatorAddress
String
Requirements: <= 243 characters
Тег ФФД: 1005
Адрес оператора перевода.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
OperatorInn
String
Requirements: <= 12 characters
Тег ФФД: 1016
ИНН оператора перевода.
Параметр обязательный, если AgentSign
передан в значениях bank_paying_agent
или bank_paying_subagent
.
SupplierInfo
Object (SupplierInfo)
Данные поставщика платежного агента.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
SupplierInfo
Object (SupplierInfo)
Данные поставщика платежного агента.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
Phones
Array
Requirements: <= 19 characters
Тег ФФД: 1171
Телефон поставщика в формате +{Ц}
.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
Name
String
Requirements: <= 239 characters
Тег ФФД: 1225
Наименование поставщика.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
Состоит из 239 символов, в которые включаются телефоны поставщика — + 4 символа на каждый телефон.
Например, если передано два телефона поставщика длиной 12 и 14 символов, максимальная длина наименования поставщика будет 239 – (12 + 4) – (14 + 4) = 205 символов.
Inn
String
Requirements: >= 10 characters
and <= 12 characters
Тег ФФД: 1226
ИНН поставщика в формате ЦЦЦЦЦЦЦЦЦЦ
.
Параметр обязательный, если передается значение AgentSign
в объекте AgentData
.
FfdVersion
String
Версия ФФД. Возможные значения: 1.2
или 1.05
.
Версия ФФД по умолчанию — 1.05
.
String<email>
Requirements: <= 64 characters
Тег ФФД: 1008.
Электронная почта клиента.
Параметр обязательный, если не передан Phone
.
Phone
String
Requirements: <= 64 characters
Тег ФФД: 1008.
Телефон клиента в формате +{Ц}
.
Параметр обязательный, если не передан Email
.
Required
Taxation
String
Requirements: [osn
, usn_income
, usn_income_outcome
, esn
, patent
]
Тег ФФД: 1055.
Система налогообложения. Возможные значения:
osn
— общая СН;usn_income
— упрощенная СН (доходы);usn_income_outcome
— упрощенная СН (доходы минус расходы);esn
— единый сельскохозяйственный налог;patent
— патентная СН.
Payments
Object (Payments)
Детали платежа.
Если объект не передан, автоматически указывается итоговая сумма чека с видом оплаты «Безналичный».
Если передан объект receipt.Payments
, значение в Electronic
должно быть равно итоговому значению Amount
в методе Инициировать платеж.
При этом сумма введенных значений по всем видам оплат,
включая Electronic
, должна быть равна сумме (Amount
) всех товаров,
которые были переданы в объекте receipt.Items
.
Payments
Object (Payments)
Детали платежа.
Если объект не передан, автоматически указывается итоговая сумма чека с видом оплаты «Безналичный».
Если передан объект receipt.Payments
, значение в Electronic
должно быть равно итоговому значению Amount
в методе Инициировать платеж.
При этом сумма введенных значений по всем видам оплат,
включая Electronic
, должна быть равна сумме (Amount
) всех товаров,
которые были переданы в объекте receipt.Items
.
Cash
Number
Requirements: <= 14 characters
Тег ФФД: 1031.
Вид оплаты «Наличные». Сумма к оплате в копейках.
Required
Electronic
Number
Requirements: <= 14 characters
Тег ФФД: 1081.
Вид оплаты «Безналичный».
AdvancePayment
Number
Requirements: <= 14 characters
Тег ФФД: 1215.
Вид оплаты «Предварительная оплата (Аванс)».
Credit
Number
Requirements: <= 14 characters
Тег ФФД: 1216.
Вид оплаты «Постоплата (Кредит)».
Provision
Number
Requirements: <= 14 characters
Тег ФФД: 1217.
Вид оплаты «Иная форма оплаты».
Shops
Array of objects ()
JSON-объект с данными маркетплейса. Обязательный для маркетплейсов.
Shops
Array of objects ()
JSON-объект с данными маркетплейса. Обязательный для маркетплейсов.
Required
ShopCode
String
Код магазина.
Required
Amount
Number
Cумма в копейках, которая относится к указанному ShopCode
.
Name
String
Requirements: <= 128 characters
Наименование товара.
Fee
String
Сумма комиссии в копейках, которая удерживается из возмещения партнера в пользу маркетплейса. Если параметр не передан, используется комиссия, которая была указана при регистрации.
Route
String
Requirements: [TCB
, BNPL
]
Способ платежа.
Source
String
Requirements: [installment
, BNPL
]
Источник платежа.
Ответ
200
OK
Это полезный материал?