Платежи¶
Создание платежа¶
Запрос:
POST /api/v1/payment HTTP/1.1 Host: enter.tochka.com Accept: application/json Content-Type: application/json Authorization:Bearer <access_token> { "account_code": "", "bank_code": "", "counterparty_account_number": "40702810840020002504", "counterparty_bank_bic": "044525225", "counterparty_inn": "5001038736", "counterparty_kpp": "500101001", "counterparty_name": "ООО \"БАЙКАЛ-СЕРВИС ТК\"", "payment_amount": "700,33", "payment_date": "29.03.2018", "payment_number": "9195", "payment_priority": "5", "payment_purpose": "без НДС", "payment_purpose_code": "1", "supplier_bill_id": "0", "tax_info_document_date": "0", "tax_info_document_number": "0", "tax_info_kbk": "18210202010061010160", "tax_info_okato": "92701000", "tax_info_period": "МС.09.2017", "tax_info_reason_code": "ТП", "tax_info_status": "09" }Параметры:
- access_token (string) — получен в шаге «Получение access_token».
- account_code (string) — счёт отправителя (20, цифры)
- bank_code (string) — БИК банка отправителя (9, цифры)
- counterparty_account_number (string) — счёт получателя (20, цифры)
- counterparty_bank_bic (string) — БИК банка получателя (9, цифры)
- counterparty_inn (string) — ИНН получателя (10, 12 цифры)
- counterparty_kpp (string) — КПП получателя (9, цифры)
- counterparty_name (string) — получатель платежа (до 160, кириллица, цифры, символы)
- payment_amount (string) — сумма платежа (до 18, цифры)
- payment_date (string) — дата платежа (В соответствии с Положением Банка России от 19.06.2012 № 383-П(ред. от 11.10.2018), в формате ДД.ММ.ГГГГ)
- payment_number (string) — номер платежа (6, цифры)
- payment_priority (string) — очерёдность платежа (1, цифры)
- payment_purpose (string) — назначение платежа (до 210)
- payment_purpose_code (string) — опциональное поле. Код вида дохода физ. лица («1», «2», «3» или пусто). Подробнее: ФЗ 229, Указание Банка России N 5286, ФЗ 12.
- supplier_bill_id (string) — код УИН (1, 20, 25 кириллица, цифры)
- tax_info_document_date (string) — дата бюджетного документа (1, 10 цифры)
- tax_info_document_number (string) — номер документа (до 15)
- tax_info_kbk (string) — КБК (1, 20, цифры)
- tax_info_okato (string) — код ОКАТО/ОКТМО (1, 8 цифры)
- tax_info_period (string) — налоговый период/Код таможенного органа (1,8,10 кириллица, цифры, символы)
- tax_info_reason_code (string) — основание платежа (2, кириллица)
- tax_info_status (string) — статус плательщика (2, цифры)
Ответ:
HTTP/1.1 200 OK Content-Type: application/json { "request_id": "<request_id>" }Сообщения об ошибках:
HTTP/1.1 400 OK Content-Type: application/json { "message": "Bad JSON" }HTTP/1.1 403 OK Content-Type: application/json { "message": "Operation not allowed" }HTTP/1.1 422 OK Content-Type: application/json { "message": "Validation failed" }
Статус платежа¶
Запрос:
GET /api/v1/payment/status/<request_id> HTTP/1.1 Host: enter.tochka.com Accept: application/json Authorization:Bearer <access_token>Параметры:
- access_token — получен на шаге «Получение access_token».
- request_id — id черновика платежа, полученное на шаге Создание платежа.
Ответ:
HTTP/1.1 200 OK Content-Type: application/json { "request_id": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "status": "success" }Сообщения об ошибках:
HTTP/1.1 400 OK Content-Type: application/json { "message": "Bad JSON" }HTTP/1.1 403 OK Content-Type: application/json { "message": "Operation not allowed" }HTTP/1.1 404 OK Content-Type: application/json { "request_id": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", "status": "error" }HTTP/1.1 422 OK Content-Type: application/json { "message": "Validation failed" }