Tochka

https://enter.tochka.com/doc/v2/
Admin
Tochka is a financial services platform providing API documentation and integration tools for...
Tokens:192,029
Snippets:798
Trust Score:9.3
Update:1 year ago
Show doc for...
Tokens:
Raw
### Tochka API - Collections and Environment Setup

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-vozvratami

Guides on using Postman collections for API requests, including setup and execution.

```APIDOC
Postman Collections:
  - How to use the provided Postman collection for API requests.
  - Setup instructions for the Postman environment.
  - Guidance on executing requests using the collection.
```

--------------------------------

### API Request Collection Setup

Source: https://enter.tochka.com/doc/v2/redoc/section/Algoritm-raboty-po-OAuth-2

Guides users on how to set up and use a collection of API requests, likely for tools like Postman. This includes environment configuration and executing requests.

```APIDOC
Request Collection Usage:

1. How to Use the Collection:
   - Import the provided API request collection into your preferred API client (e.g., Postman).

2. How to Configure the Environment:
   - Set up environment variables within your API client to match your Tochka Pro API credentials and base URLs.
   - This typically includes variables for:
     - `base_url`
     - `client_id`
     - `client_secret`
     - `access_token`
     - `refresh_token`

3. How to Execute Requests:
   - Select the appropriate environment.
   - Choose an API request from the collection.
   - Send the request to the API endpoint.
   - Inspect the response for data or status codes.
```

--------------------------------

### Request Collections and Usage

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

Guides on using request collections, setting up the environment, and executing requests.

```APIDOC
Request Collections:
  - Links: https://enter.tochka.com/doc/v2/redoc/section/Kollekciya-zaprosov#Ssylki
  - How to Use the Collection: https://enter.tochka.com/doc/v2/redoc/section/Kollekciya-zaprosov#Kak-ispolzovat-kollekciyu
  - How to Set Up the Environment: https://enter.tochka.com/doc/v2/redoc/section/Kollekciya-zaprosov#Kak-nastroit-okruzhenie
  - How to Execute Requests: https://enter.tochka.com/doc/v2/redoc/section/Kollekciya-zaprosov#Kak-vypolnyat-zaprosy
```

--------------------------------

### Tochka Pro API - Request Collection and Usage

Source: https://enter.tochka.com/doc/v2/redoc/section/Pro-API

Information on using the provided collection of API requests, including setup and execution.

```APIDOC
Request Collection:

- Links: Collection of requests.
- How to use the collection.
- How to set up the environment.
- How to make requests.
```

--------------------------------

### Tochka Pro API - Request Collection Usage

Source: https://enter.tochka.com/doc/v2/redoc/section/Terminologiya

Guides on how to use the provided request collection for interacting with the Tochka Pro API. Includes setup and execution instructions.

```APIDOC
Request Collection Usage:

- How to use the collection.
- How to set up the environment.
- How to execute requests.
```

--------------------------------

### Postman Collection and Environment Setup

Source: https://enter.tochka.com/doc/v2/redoc/section/Kollekciya-zaprosov

Instructions and links for importing Postman collections and environment settings to interact with the Tochka API. This includes setting up client ID and secret.

```APIDOC
Postman Collection:
  URL: https://enter.tochka.com/doc/openapi/static/postman/OpenAPI.postman_collection.json
  Description: Main Postman collection for Tochka API requests.

Postman Environment Setup:
  URL (Production): https://enter.tochka.com/doc/openapi/static/postman/Setting.postman_environment.json
  URL (Sandbox): https://enter.tochka.com/doc/openapi/static/postman/Sandbox.postman_environment.json
  Description: Environment files for setting up Postman variables, including client_id and client_secret.
```

--------------------------------

### Tochka Pro API Request Collection

Source: https://enter.tochka.com/doc/v2/redoc/section/Obnovleniya-API

Guidance on using a Postman collection for interacting with the Tochka Pro API. Includes setup, environment configuration, and executing requests.

```APIDOC
API Request Collection:

How to Use the Collection:
  - Import the provided collection into your API client (e.g., Postman).

How to Set Up the Environment:
  - Configure environment variables such as base URLs, API keys, and access tokens.

How to Execute Requests:
  - Select the desired request from the collection and send it.
  - Utilize pre-request scripts and tests for dynamic data handling and validation.
```

--------------------------------

### Get All Consents List (cURL)

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-razresheniyami

Example cURL request to retrieve a list of all consents.

```curl
curl -g --request GET 'https://enter.tochka.com/uapi/v1.0/consents' \
--header 'Authorization: Bearer <token>'
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-QR-kodami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Python Webhook Handler Example

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

An example of a Python code snippet using aiohttp to handle incoming webhooks. It demonstrates basic setup for a web server and includes imports for JWT handling, suggesting potential security or data verification mechanisms.

```Python
from aiohttp import web
import jwt
from jwt import exceptions
import json

# Placeholder for webhook handling logic
async def handle_webhook(request):
    # Example: Process incoming webhook data
    data = await request.json()
    print(f"Received webhook data: {data}")
    
    # Example: JWT verification (if applicable)
    # token = request.headers.get('Authorization', '').split(' ')[1]
    # try:
    #     decoded = jwt.decode(token, 'your_secret_key', algorithms=['HS256'])
    #     print(f"Decoded JWT: {decoded}")
    # except exceptions.InvalidTokenError:
    #     return web.Response(status=401, text="Invalid token")

    return web.Response(status=200, text="Webhook received successfully")

# Example of setting up the web server (for context, not a complete runnable example)
# app = web.Application()
# app.router.add_post('/webhook', handle_webhook)
# if __name__ == '__main__':
#     web.run_app(app, port=8080)

```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-YuL

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Get All Child Consents (cURL)

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-razresheniyami

Example cURL request to retrieve all child consents for a given consent ID.

```curl
curl -g --request GET 'https://enter.tochka.com/uapi/v1.0/consents/705ba15f-a109-4156-bb7f-50c21413c158/child' \
--header 'Authorization: Bearer <token>'
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-rabota-s-B2B-QR-kodami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### cURL Example: Get Customers List

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-klientami

This cURL command demonstrates how to request a list of customers from the Tochka API. Ensure you replace '<token>' with a valid authorization token.

```curl
curl -g --request GET 'https://enter.tochka.com/uapi/open-banking/v1.0/customers' \
--header 'Authorization: Bearer <token>'
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-TSP

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Get Access Token (client_credentials)

Source: https://enter.tochka.com/doc/v2/redoc/section/Algoritm-raboty-po-OAuth-2

This example demonstrates how to obtain an access token using the `client_credentials` grant type. It shows the POST request to the token endpoint with `client_id`, `client_secret`, `grant_type`, and `scope` parameters.

```curl
curl --request POST 'https://enter.tochka.com/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=test_app' \
--data-urlencode 'client_secret=test_secret' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'scope=accounts balances customers statements sbp payments'
```

```json
{
    "token_type": "bearer",
    "access_token": "p6awaKAleytQh6mKc61vXd22YniDerme",
    "expires_in": 86400
}
```

--------------------------------

### cURL Example: Get Customer Info

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-klientami

This cURL command shows how to retrieve detailed information for a specific customer using their customer code. Replace '<token>' with your authorization token and '300000092' with the actual customer code.

```curl
curl -g --request GET 'https://enter.tochka.com/uapi/open-banking/v1.0/customers/300000092' \
--header 'Authorization: Bearer <token>'
```

--------------------------------

### Sandbox Environment Introduction

Source: https://enter.tochka.com/doc/v2/redoc/section/Obnovleniya-API

A sandbox environment has been introduced, providing access to core methods for testing and development purposes.

```APIDOC
APIDOC:
  environment: Sandbox
  description: Introduction of a sandbox environment with access to core API methods.
```

--------------------------------

### Open API Terms of Service

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-QR-kodami

References the terms and conditions for using the Open API, which users must agree to before integration.

```APIDOC
Terms of Service:
  Agreement Required: Yes
  Link: https://tochka.com/links/offer-open-api
```

--------------------------------

### Get Balance Info and Get Balances List Bug Fix

Source: https://enter.tochka.com/doc/v2/redoc/section/Obnovleniya-API

Fixed an issue in Get Balance Info and Get Balances List methods where accountId was returned without a BIC value. This has been corrected.

```APIDOC
APIDOC:
  tag: Rabota-s-balansami-schetov
  operationId: get_balance_info_open_banking
  path: /__apiVersion__/accounts/{accountId}/balances
  method: GET
  description: Retrieves balance information for a specific account. (Fixed: accountId now includes BIC)

APIDOC:
  tag: Rabota-s-balansami-schetov
  operationId: get_balances_list_open_banking
  path: /__apiVersion__/balances
  method: GET
  description: Retrieves a list of balances for all accounts. (Fixed: accountId now includes BIC)
```

--------------------------------

### Get Retailers Information Enrichment

Source: https://enter.tochka.com/doc/v2/redoc/section/Obnovleniya-API

The Get Retailers method now provides information on payment methods and online cash registers.

```APIDOC
GET /retailers
  Description: Retrieves information about retailers.
  Returns:
    paymentMethods: Available payment methods.
    hasOnlineCashRegister: Indicates availability of online cash registers.
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-klientami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Start Refund SBP Bug Fix

Source: https://enter.tochka.com/doc/v2/redoc/section/Obnovleniya-API

Corrected a bug in the Start Refund method for SBP that allowed refunds for other users' QR codes. This has been fixed to prevent unauthorized refunds.

```APIDOC
APIDOC:
  tag: Servis-SBP:-Rabota-s-vozvratami
  operationId: start_refund_sbp
  path: /__apiVersion__/refund
  method: POST
  description: Initiates a refund for an SBP payment. (Fixed: Prevents refunds for unauthorized QR codes)
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-razresheniyami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Get Payment Operation Info API Endpoint

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

Allows retrieval of information for a specific payment operation using its unique 'operationId'. The 'operationId' can be obtained from the 'acquiringInternetPayment' webhook event or the Get Payment Operation List method.

```APIDOC
GET /acquiring/{apiVersion}/payments/{operationId}

Retrieves information for a specific payment operation.

Parameters:
  operationId: string - Уникальный идентификатор операции.

Returns:
  Detailed information about the specified payment operation.
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/section/Authentication

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### acquiringInternetPayment Webhook - Card Payment Example

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

This example demonstrates the structure of the webhook payload for an 'acquiringInternetPayment' event when a payment is made using a card. It includes details such as amount, payment type, operation ID, customer code, merchant ID, consumer ID, purpose, and payment status.

```JSON
{
  "customerCode": "300123123",
  "amount": "0.33",
  "paymentType": "card",
  "operationId": "beeac8a4-6047-3f38-8922-a664e6b5c43b",
  "purpose": "\u041f\u043b\u0430\u0442\u0435\u0436 \u0437\u0430 \u0442\u043e\u0432\u0430\u0440\u044b \u0438 \u0443\u0441\u043b\u0443\u0433\u00201 \u043c\u0430\u044f 01.01.2021. \u0412\u0441\u0435\u0433\u043e \u0434\u043e\u0441\u0442\u0430\u0432\u043a\u0430",
  "webhookType": "acquiringInternetPayment",
  "merchantId": "200000000001234",
  "consumerId": "917ed389-a120-4291-8e73-38c6ef7d6770",
  "status": "APPROVED"
}
```

--------------------------------

### Sandbox SBP Methods

Source: https://enter.tochka.com/doc/v2/redoc/section/Obnovleniya-API

All SBP methods are now available in the sandbox environment, allowing for QR code debugging without needing to register QR codes on the production layer.

```APIDOC
APIDOC:
  environment: Sandbox
  feature: SBP Methods
  description: All SBP methods are available in the sandbox for debugging QR code functionality.
```

--------------------------------

### Get Retailers API Endpoint

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

The Get Retailers method retrieves information about connected retail points for internet acquiring. It returns details such as status, activity status, MCC code, commission rate, name, URL, merchant ID, terminal ID, payment modes, and cashbox information.

```APIDOC
GET /acquiring/{apiVersion}/retailers/get

Returns information about connected retail points.

Parameters:
  status: string - Статус регистрации (REG required).
  isActive: boolean - Статус готовности к работе (true required).
  mcc: string - MCC-код.
  rate: number - Сумма комиссии при платеже на карту.
  name: string - Наименование торговой точки.
  url: string - Адрес сайта регистрации.
  merchantId: string - Идентификатор торговой точки.
  terminalId: string - Идентификатор интернет-эквайринга.
  paymentModes: array - Доступные способы оплаты.
  cashbox: object - Информация о подключённой онлайн-кассе.
```

--------------------------------

### acquiringInternetPayment Webhook - SBP Payment Example

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

This example illustrates the webhook payload for an 'acquiringInternetPayment' event when a payment is made via the Faster Payments System (SBP). It includes fields like amount, payment type, transaction ID, purpose, QR code ID, merchant ID, operation ID, customer code, payer name, and payment status.

```JSON
{
  "qrcId": "AS10006DPQRTFEF9H9QSEDSVRHJ3L",
  "amount": "0.33",
  "purpose": "\u041f\u043b\u0430\u0442\u0435\u0436 \u0437\u0430 \u0442\u043e\u0432\u0430\u0440\u044b \u0438 \u0443\u0441\u043b\u0443\u0433\u0020\u0432 \u0441\u0431\u043f",
  "webhookType": "acquiringInternetPayment",
  "customerCode": "300123123"
}
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-balansami-schetov

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-vystavleniem-schetov

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-so-schetami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Create New Consent Request Payload

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-razresheniyami

Example JSON payload for creating a new consent.

```json
{
  "Data": {
    "status": "AwaitingAuthorisation",
    "creationDateTime": "2019-01-01T06:06:06.364+00:00",
    "statusUpdateDateTime": "2019-01-01T06:06:06.364+00:00",
    "permissions": [
      "ReadAccountsBasic"
    ],
    "expirationDateTime": "2019-01-01T06:06:06.364+00:00"
  },
  "Risks": {}
}
```

--------------------------------

### Subscription Options

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

Defines parameters for managing subscription payments, including the number of installments and the billing period.

```APIDOC
Options:
  trancheCount: количество списаний по подписке. По умолчанию установлено 12 списаний.
  period: периодичность списания. По умолчанию устанавливается месяц (Month).
  daysInPeriod: длина периодичности списания в днях. Работает только с периодом Day.
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-podpiskami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Tochka API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

Provides an overview of the Tochka API, including links to specific sections like Pro-API, Terminology, and OAuth 2.0 algorithm.

```APIDOC
Pro-API: https://enter.tochka.com/doc/v2/redoc/section/Pro-API
Terminology: https://enter.tochka.com/doc/v2/redoc/section/Terminologiya
OAuth 2.0 Algorithm: https://enter.tochka.com/doc/v2/redoc/section/Algoritm-raboty-po-OAuth-2.0
```

--------------------------------

### Get Payment For Sign List

Source: https://enter.tochka.com/doc/v2/redoc/section/Obnovleniya-API

Method to view all payments in the 'For Signature' section of the online bank.

```APIDOC
GET /payments/for-sign
  Description: Retrieves a list of payments awaiting signature.
  Returns: A list of payment objects.
```

--------------------------------

### SBP Refund Management

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

Endpoints for managing refunds, including retrieving payment history, initiating refunds, and getting refund data.

```APIDOC
GET /get_sbp_payments/{apiVersion}
  Description: Retrieves a list of SBP payments.
  Parameters:
    - apiVersion: API version

POST /refund_sbp/{apiVersion}
  Description: Initiates a refund process.
  Parameters:
    - apiVersion: API version

GET /refund_sbp/{apiVersion}/refund/{requestId}
  Description: Retrieves data for a specific refund request.
  Parameters:
    - apiVersion: API version
    - requestId: The ID of the refund request
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-vebhukami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Subscription Management API

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-vystavleniem-schetov

APIs for managing user subscriptions, including getting subscription status and creating subscriptions with receipts.

```APIDOC
GET /acquiring/{apiVersion}/subscriptions/status
  Description: Get Subscription Status
  Parameters:
    - apiVersion: string (path parameter)

POST /acquiring/{apiVersion}/subscriptions/with-receipt
  Description: Create Subscription With Receipt
  Parameters:
    - apiVersion: string (path parameter)
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-vypiskami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-platyozhnymi-ssylkami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Permissions API

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-vebhukami

Endpoints for managing consents, including retrieving lists, creating new consents, and getting consent information.

```APIDOC
GET /consents
  Description: Get All Consents List

POST /consents
  Description: Create New Consent

GET /consents/{consentId}/child
  Description: Get All Child Consents

GET /{consentId}
  Description: Get Consent Info
```

--------------------------------

### Open API Terms of Service

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-rabota-s-B2B-QR-kodami

References the terms and conditions for using the Open API, which users must agree to before integration.

```APIDOC
Terms of Service:
  Agreement Required: Yes
  Link: https://tochka.com/links/offer-open-api
```

--------------------------------

### Closing Document API

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-platezhami

Provides an endpoint to get closing documents, specifically invoices, for a given customer and document ID.

```APIDOC
GET /closing_documents/customerCode/documentId/file
  - Retrieves a closing document (invoice).
  - Parameters:
    - apiVersion: The API version.
    - customerCode: The code of the customer.
    - documentId: The ID of the document.
```

--------------------------------

### Get Subscription Status

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-podpiskami

Retrieves the status of a subscription for a given operation ID and API version. Requires appropriate authorization.

```APIDOC
GET /acquiring/{apiVersion}/subscriptions/{operationId}/status

Path Parameters:
- apiVersion: required, string (ApiVersion) - The API version, e.g., "v1.0"
- operationId: required, string (Operationid) - The subscription operation ID, e.g., "48232c9a-ce82-1593-3cb6-5c85a1ffef8f"

Responses:
- 200: Successful response with subscription status.
- 400: Bad request.
- 401: Unauthorized.
- 403: Forbidden.
- 404: Not Found.
- 500: Internal Server Error.

Response Schema (200):
{
  "Data": {
    "status": "Active"
  },
  "Links": {
    "self": "https://enter.tochka.com/uapi"
  },
  "Meta": {
    "totalPages": 1
  }
}
```

```curl
curl --location --globoff 'https://enter.tochka.com/uapi/acquiring/v1.0/subscriptions/48232c9a-ce82-1593-3cb6-5c85a1ffef8f/status' \
--header 'Authorization: Bearer <token>'
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-platezhami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Tochka Pro API Documentation Overview

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-zakryvayushimi-dokumentami

This section provides an overview of the Tochka Pro API, including links to specific documentation sections such as authentication, terminology, and method descriptions.

```APIDOC
Pro-API: Overview of the Tochka Pro API.
Terminologiya: Glossary of terms used in the API.
Algoritm-raboty-po-OAuth-2.0: Detailed explanation of the OAuth 2.0 authorization flow, including obtaining tokens and setting permissions.
Kollekciya-zaprosov: Information on using Postman collections for API requests, including setup and execution.
Opisanie-metodov: Descriptions of various API methods for managing financial operations like account balance, payments, invoices, and subscriptions.
Pesochnica: Information about the sandbox environment for testing.
Obnovleniya-API: A changelog of API updates and version history.
```

--------------------------------

### Create Payment Operation with Merchant ID

Source: https://enter.tochka.com/doc/v2/redoc/section/Obnovleniya-API

The Create Payment Operation method now accepts an optional merchantId for multi-merchant setups.

```APIDOC
POST /payments
  Description: Creates a payment operation.
  Parameters:
    merchantId: Optional. Specifies the merchant for multi-merchant accounts.
```

--------------------------------

### Get Subscription Status API

Source: https://enter.tochka.com/doc/v2/redoc/tag/Rabota-s-podpiskami

API method to retrieve the current status of a subscription. This endpoint is part of the subscription management functionality.

```APIDOC
GET /acquiring/{apiVersion}/subscriptions/{operationId}/status

---

**Description:** Метод для получения актуального статуса подписки

**Authorizations:** [Необходимые разрешения](https://enter.tochka.com/doc/v2/redoc/section/Authentication#%D0%9D%D0%B5%D0%BE%D0%B1%D1%85%D0%BE%D0%B4%D0%B8%D0%BC%D1%8B%D0%B5%20%D1%80%D0%B0%D0%B7%D1%80%D0%B5%D1%88%D0%B5%D0%BD%D0%B8%D1%8F) (MakeAcquiringOperation)

**Path Parameters:**
* `apiVersion` (required, string (ApiVersion)): Версия API. Value: "v1.0"
* `operationId` (required, string (Operationid)): Идентификатор подписки. Example: "48232c9a-ce82-1593-3cb6-5c85a1ffef8f"

**Responses:**
* **200, 400, 401, 403, 404, 500:**
  * **Response Schema:** (Similar to Set Subscription Status response, but reflects current status)
    ```json
    {
      "Data": {
        "status": "Active" 
      },
      "Links": {
        "self": "https://enter.tochka.com/uapi"
      },
      "Meta": {
        "totalPages": 1
      }
    }
    ```
```

--------------------------------

### Tochka Pro API Documentation

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-kassovymi-QR-kodami

This section details the Tochka Pro API, covering authentication flows, available methods for various financial operations, and a changelog of API versions. It serves as a central reference for developers integrating with the Tochka platform.

```APIDOC
Pro-API:
  Description: Documentation for the Tochka Pro API.
  Sections:
    - Terminology
    - OAuth 2.0 Workflow
    - JWT Token Workflow
    - Request Collection
    - Method Descriptions
    - Sandbox
    - API Updates

OAuth 2.0 Workflow:
  Purpose: Guides users through obtaining and managing access tokens for API interaction.
  Steps:
    1. Register Application
    2. Obtain Token for Permissions
    3. Set Permissions
    4. Request Signature for Permissions List and User Confirmation
    5. Exchange Code for Access Token
    6. Exchange Refresh Token for New Access/Refresh Token Pair
    7. Verify Access Token (Hybrid)

JWT Token Workflow:
  Description: Details the process of working with JWT tokens for API authentication.

Request Collection:
  Purpose: Provides a collection of API requests for easier integration.
  Usage:
    - How to use the collection
    - How to set up the environment
    - How to execute requests

Method Descriptions:
  Purpose: Outlines the available API methods for various financial operations.
  Methods:
    - Account Balance
    - Webhooks
    - Clients
    - Accounts
    - Payment Links
    - Subscriptions (Recurring Payments)
    - Invoicing and Creating Closing Documents
    - Statements
    - Payments
    - SBP - Faster Payments System

Sandbox:
  Description: Information about the sandbox environment for testing API integrations.

API Updates:
  Purpose: Tracks changes and new versions of the Tochka Pro API.
  Versions:
    - 1.77.3
    - 1.65.1
    - 1.63.1
    - 1.59.1
    - 1.58.0
    - 1.56.0
    - 1.55.0
    - 1.46.0
    - 1.45.0
    - 1.44.6
    - 1.44.1
    - 1.43.3
    - 1.42.5
    - 1.38.5
    - 1.38.3
    - 1.37.10
    - 1.37.9
    - 1.37.0
    - 1.36.4
```

--------------------------------

### SBP Refund Operations

Source: https://enter.tochka.com/doc/v2/redoc/section/Algoritm-raboty-po-OAuth-2

APIs for managing payment refunds, including retrieving payment history and initiating or getting refund data.

```APIDOC
GET /sbp/get_sbp_payments
  Retrieves a list of SBP payments.

POST /sbp/refund
  Initiates a refund process.

GET /sbp/refund/{requestId}
  Retrieves refund data using a request ID.
```

--------------------------------

### Tochka API: Statement Operations

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-QR-kodami

Facilitates the retrieval and initialization of account statements. Supports fetching specific statements, listing all statements, and initiating new statement generation.

```APIDOC
GET Get Statement
  Path: /open-banking/{apiVersion}/accounts/{accountId}/statements/{statementId}
  Description: Retrieves a specific account statement.
  Parameters:
    - apiVersion (string): The API version.
    - accountId (string): The ID of the account.
    - statementId (string): The ID of the statement to retrieve.
  Returns: The requested account statement.

POST Init Statement
  Path: /open-banking/{apiVersion}/statements
  Description: Initiates the generation of a new account statement.
  Parameters:
    - apiVersion (string): The API version.
  Returns: Information about the initiated statement generation.

GET Get Statements List
  Path: /open-banking/{apiVersion}/statements
  Description: Retrieves a list of available account statements.
  Parameters:
    - apiVersion (string): The API version.
  Returns: List of account statements.
```

--------------------------------

### SBP Refund Management API

Source: https://enter.tochka.com/doc/v2/redoc/section/Algoritm-raboty-s-JWT-tokenom

Endpoints for handling refunds, including retrieving payment information, initiating refunds, and getting refund status.

```APIDOC
GET /sbp/api/v1/get_sbp_payments
  Retrieves a list of payments.

POST /sbp/api/v1/refund
  Initiates a refund process.

GET /sbp/api/v1/refund/{requestId}
  Retrieves the status and data for a specific refund request.
```

--------------------------------

### Open API Terms of Service

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-YuL

References the terms and conditions for using the Open API, which users must agree to before integration.

```APIDOC
Terms of Service:
  Agreement Required: Yes
  Link: https://tochka.com/links/offer-open-api
```

--------------------------------

### Open API Terms of Service

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-kassovymi-QR-kodami

References the terms and conditions for using the Open API, which users must agree to before integration.

```APIDOC
Terms of Service:
  Agreement Required: Yes
  Link: https://tochka.com/links/offer-open-api
```

--------------------------------

### Подключение и проверка статуса интернет-эквайринга

Source: https://enter.tochka.com/doc/v2/redoc/section/Opisanie-metodov

Процесс подключения интернет-эквайринга и проверки статуса подключения с помощью метода Get Retailers.

```APIDOC
Get Retailers: Метод для проверки статуса подключения интернет-эквайринга.
Статус REG и isActive: 'true' означают завершение настройки.
```

--------------------------------

### Tochka API: Statement Operations

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-rabota-s-B2B-QR-kodami

Facilitates the retrieval and initialization of account statements. Supports fetching specific statements, listing all statements, and initiating new statement generation.

```APIDOC
GET Get Statement
  Path: /open-banking/{apiVersion}/accounts/{accountId}/statements/{statementId}
  Description: Retrieves a specific account statement.
  Parameters:
    - apiVersion (string): The API version.
    - accountId (string): The ID of the account.
    - statementId (string): The ID of the statement to retrieve.
  Returns: The requested account statement.

POST Init Statement
  Path: /open-banking/{apiVersion}/statements
  Description: Initiates the generation of a new account statement.
  Parameters:
    - apiVersion (string): The API version.
  Returns: Information about the initiated statement generation.

GET Get Statements List
  Path: /open-banking/{apiVersion}/statements
  Description: Retrieves a list of available account statements.
  Parameters:
    - apiVersion (string): The API version.
  Returns: List of account statements.
```

--------------------------------

### Open API Terms of Service

Source: https://enter.tochka.com/doc/v2/redoc/tag/Servis-SBP%3A-Rabota-s-TSP

References the terms and conditions for using the Open API, which users must agree to before integration.

```APIDOC
Terms of Service:
  Agreement Required: Yes
  Link: https://tochka.com/links/offer-open-api
```
Tokens:
Raw