Payments
Using API payment methods, you can:
- make mass payments using bank details to its counterparties—legal entities and individuals;
- pay taxes and other payments to the budget;
- make payments to T‑Bank card;
- create payment order draft for payments to the budget and contractors.
Send a Payment
To send payments:
Make sure that the user has access to make payments.
To do this, in your personal account go to Профиль → Компании (Profile → Companies) and select the necessary user in the Доступы → Пользователи (Accesses → Users) section. Go to the Право подписи (Sign right) tab and check for the signature. How to add an employee and give the sign right.
Issue a token with the necessary permissions.
For the Make a payment method—Совершение платежей с рублевого расчётного счёта компании с ИНН {inn} и КПП {kpp} (Making payments from the company's ruble settlement account with INN {inn} and KPP {kpp}).
Learn more about token issueIssue a certificate. Learn more about certificate issue.
The token and certificate are linked after the first successful request. If you want to reissue the token, you also need to reissue the certificate.
To secure payments, set two types of limits:
- EDS limits. Apply to all payments regardless of the interface: web, mobile app, API. You can set it up in several ways:
- A user with the CEO role changes the limits themselves in the T‑Business personal account in the Лимиты (Limits) section.
- Via a personal manager.
- T‑API limits. Apply only to payments via T‑API interface. You can also change them in the T-Business personal account in the Limits section.
- EDS limits. Apply to all payments regardless of the interface: web, mobile app, API. You can set it up in several ways:
By Bank Details of Legal Entities and Individuals and to the Budget
Use the Make a payment method.
ID is a unique identifier for all your company's payments sent via T-API. A different ID is used for each request. If you send multiple requests with the same ID, only one payment will be created.
Examples of requests:
Check the Sent Payment Status
Use the Get payment status method by passing the unique operation ID.
On successful request, a 200 response is returned.
The number of requests per second (RPS (requests per second)) for the method is 20. If you need to increase the number, contact us at openapi@tbank.ru.
You can receive information about events via webhooks without calling the method. The bank automatically will send data when the payment status changes. To do this, make a public handle.
The public handle must be unauthorized. You can filter events by the IP address we'll provide you with. If you have any questions, contact us at openapi@tbank.ru.
Create Payment Order Draft
To create payment order drafts, issue a token with the Создание черновиков платежей в компании с ИНН {inn} и КПП {kpp} (Creating payment drafts in the company with INN {inn} and KPP {kpp}) permission for the Create payment order draft method.
By Details of Legal Entities and Individuals and to the Budget
Use the Create payment order draft method.
A draft is considered created if the 200 response with x-request-id in the headers is returned
in the method response. Save the identifier—the bank can use it to analyze if you
have any questions on sending the draft.
Examples of requests:
The number of requests per second (RPS (requests per second)) for the method is 10. If you need to increase the number, contact us at openapi@tbank.ru.
Sign the Sent Draft
Go to T‑Business personal account and select the Черновики (Drafts) section in the operations feed.
Select the payment and click Отправить (Send).
Only a user with signing rights can sign a payment. If you don't have the right to make payments, any employee with this right can sign the payment in their personal account.
Enter the code from SMS to confirm the payment.
To check the payment status, click the payment in the transactions feed.
Examples of Errors on Method Calls
400
401
403
Access errors (user rights, certificates, tokens)
errorCode: FORBIDDEN