Платежи

Создание платежа

Запрос:

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"
}