Песочница

Песочница — это специальный режим работы API, созданный для разработки. В этом режиме все данные заменены на тестовые.

Как получить доступ к песочнице

https://enter.tochka.com/sandbox/v1/login/

Логин: sandbox

Пароль: sandbox

На странице с запросом кода из смс ввести код: 12345

На странице «Доступ к Точке» выберите нужные пункты и нажмите кнопку «Разрешить». В ответ вы получите <код авторизации>.

В запросе для получения access_token и обмена refresh_token на новую пару access_token используйте:

  • «client_id»: «sandbox»,
  • «client_secret»: «sandbox_secret»,

Обмен кода авторизации на access_token и refresh_token

Запрос:

POST /sandbox/v1/oauth2/token HTTP/1.1
Host: enter.tochka.com
Accept: application/json
Content-Type: application/json

 {
        "client_id": "sandbox",
        "client_secret": "sandbox_secret",
        "grant_type": "authorization_code",
        "code": "<Код авторизации>"
 }

Параметры:

  • client_id — sandbox.
  • client_secret — sandbox_secret.
  • code — код авторизации получен на шаге «Как получить доступ к песочнице».

Обмен refresh_token на новые access_token и refresh_token

Запрос:

POST /sandbox/v1/oauth2/token HTTP/1.1
Host: enter.tochka.com
Accept: application/json
Content-Type: application/json

{
    "client_id": "sandbox",
    "client_secret": "sandbox_secret",
    "grant_type": "refresh_token",
    "refresh_token": "<refresh_token>"

}

Параметры:

  • client_id — sandbox.
  • client_secret — sandbox_secret.
  • refresh_token — получен после авторизации по коду.

Работа с песочницей

Для работы с песочницей замените во всех запросах /api/v1 на /sandbox/v1.

С помощью метода получения списка счетов, можно получить тестовые счета для работы в песочнице:

Запрос:

GET /sandbox/v1/account/list HTTP/1.1
Host: enter.tochka.com
Accept: application/json
Authorization:Bearer <access_token>

Параметры:

  • access_token — после авторизации по коду.

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

[
        {
        "code": "40702810101270000000",
        "bank_code": "044525999"
        },
        {
        "code": "40702810910050000000",
        "bank_code": "044525797"
        }
]

Для работы с зарплатным проектом, используйте значение:

«customer_code»: «300000000»

Регистрация вашего приложения

https://enter.tochka.com/sandbox/v1/register

На странице «Регистрация вашего приложения», клиент вводит название своего приложения, ссылку для перенаправления и электронную почту. Для регистрации нажимает кнопку «Зарегистрироваться».

Регистрация вашего приложения

В следующем окне будут получены client_id и client_secret которые будут необходимы для дальнейшей работы с API.

получение client_id и client_secret

После нажатия кнопки «Авторизоваться» клиента перенаправит на страницу «Доступ к Точке», где можно выбрать разрешения для приложения. После выбора разрешений нужно нажать кнопку «Разрешить».

Разрешения

Запрос:

GET /api/v1/authorize?response_type=<response_type>&client_id=<client_id> HTTP/1.1
Host: enter.tochka.com
Accept: application/json

Параметры:

  • client_id — получен при регистрации приложения
  • response_type — code (string, required)

После нажатия на кнопку «Разрешить», клиент будет перенаправлен на redirect_uri?code=<код авторизации>

redirect_url