Создать сделку

POST

https://secured-openapi.tbank.ru/api/v1/partner-payments-china-pay/deals

Метод создает сделку, когда она сопровождается во внешнем банке.

Авторизация

Security

Bearer API Token

MTLS-сертификат

RPS

Ограничение — 20 запросов в секунду

Scopes

Платежи через партнеров → Работа со сделками китайской схемы

Запрос

Header parameters

Required

Idempotency-Key

String<uuid>

Ключ идемпотентности. Подробнее.

X-Request-Id

String<uuid>

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

Request body schema application/json

Required

initiator

String

Requirements: [russian, chinese]

Инициатор заявки.

Required

direction

String

Requirements: [import, export]

Направление платежа.

Required

amount

Number<double>

Сумма платежа в юанях, два знака после запятой.

Required

commission

Размер комиссии в процентах.

province

String

Наименование китайской провинции на русском.

Required

contracts

Array of objects ()

Required

number

String

Номер иностранного контракта.

Required

date

String<date>

Дата иностранного контракта.

unk

String

Номер УНК.

invoices

Array of objects ()

Required

number

String

Номер инвойса.

Required

date

String<date>

Дата инвойса.

agentAgreementNumber

String

Номер договора с агентом.

Required

russianCounterparty

Object

Required

nameRus

String

Название на русском.

Required

nameEng

String

Название на английском.

Required

contacts

String

Контакты.

Required

inn

String

ИНН.

Required

chineseCounterparty

Object

Required

nameEng

String

Название на английском.

contacts

String

Контакты.

address

String

Адрес.

Required

goods

Array of objects ()

Категория товара в сделке. Определяется по первому ТН ВЭД коду.

Required

nameRus

String

Название на русском.

Required

nameEng

String

Название на английском.

Required

code

String

Код ТН ВЭД.

goodsSemaphore

String

Requirements: [red, yellow, green]

Светофор товара.

Ответ

200

Номер созданной сделки

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку