Использование API
Точка входа: https://paytiz.com/api/userapi/v1/ + метод API
Для авторизации, необходимо отправлять в заголовках (headers) запросов к API информацию, полученную ранее в разделе "API":
API-LOGIN — API-логин
API-KEY — API-ключ
API-LANG — принудительное использования указанного языка (необязательный). Пример: ru_RU, en_US.
Параметры запроса отправляются методом POST, ответ возвращается в формате json.
Пример ответа на запрос:
Array
(
[error] => 0 //код ошибки
[error_text] => //текст ошибки
[data] => Array
(
//данные
)
)
Точка входа: https://paytiz.com/api/userapi/v1/ + метод API
Методы работы с API:
test
Tестовый метод для проверки работы API.
Параметры запроса:
—
Ответ:
ip — ваш ip-адрес
user_id — id пользовател (если обращается система, id = 0)
locale — язык сайта
partner_id — id партнера
get_direction_currencies
Получение списка валют, доступных для обмена
Параметры запроса:
currency_id_give — id валюты отдаю (фильтр, необязательный параметр)
currency_id_get — id валюты получаю (фильтр, необязательный параметр)
Ответ:
В ответе 2 списка:
give — список валют отдаю
get — список валют получаю
В каждом списке содержатся следующие данные:
id — id валюты в обменнике
title — название валюты в обменнике
logo — ссылка на логотип валюты
get_directions
Получение списка направлений обменов, доступных для обмена
Параметры запроса:
currency_id_give — id валюты отдаю (фильтр, необязательный параметр)
currency_id_get — id валюты получаю (фильтр, необязательный параметр)
Ответ:
В ответе список направлений обмена, в нем:
direction_id — id направления обмена в обменнике
currency_give_id — id валюты отдаю в обменнике
currency_give_title — название валюты отдаю в обменнике
currency_give_logo — логотип валюты отдаю в обменнике
currency_get_id — id валюты получаю в обменнике
currency_get_title — название валюты получаю в обменнике
currency_get_logo — логотип валюты получаю в обменнике
get_direction
Получение информации о направлении обмена
Параметры запроса:
direction_id — id направления обмена
Ответ:
id — id направления обмена в обменнике
url — ссылка на страницу обмена
currency_code_give — код валюты отдаю
currency_code_get — код валюты получаю
reserve — резерв
course_give — курс отдаю
course_get — курс получаю
sum_give — сумма отдаю
sum_give_com — сумма отдаю с комиссией
sum_get — сумма получаю
sum_get_com — сумма получаю с комиссией
com_give — текст комиссии отдаю
com_get — текст комиссии получаю
min_give — минимальная сумма отдаю, no — не установлена
max_give — максимальная сумма отдаю, no — не установлена
min_get — макс сумма отдаю, no — не установлена
max_get — макс сумма отдаю, no — не установлена
info
timeline_text — описание обмена
frozen_text — текст замороженного статуса
before_button_text — текст до кнопки оплатить
give_fields — список полей, относящихся к валюте отдаю
get_fields — список полей, относящихся к валюте получаю
dir_fields — список полей направления обмена
Описание поля:
name — название для передачи
type — тип поля
label — описание поля
req — 0 — необязательно передавать, 1 — обязательно передавать
tooltip — текст подсказки
options — возможные опции, если поле имеет тип sеlect
cd — указатель дополнительных параметров
get_calc
Калькулятор сумм для направления обмена
Параметры запроса:
direction_id — id направления обмена
calc_amount — сумма
calc_action — принадлежность суммы: 1 — сумма отдаю, 2 — сумма получаю, 3 — сумма отдаю с комиссией, 4 — сумма получаю с комиссией
cd — поля из направления обмена, с пометкой cd=1, в одном поле. Поле обработано URL encode.
Ответ:
currency_code_give — код валюты отдаю
currency_code_get — код валюты получаю
reserve — резерв
course_give — курс отдаю
course_get — курс получаю
sum_give — сумма отдаю
sum_give_com — сумма отдаю с комиссией
sum_get — сумма получаю
sum_get_com — сумма получаю с комиссией
com_give — текст комиссии отдаю
com_get — текст комиссии получаю
min_give — минимальная сумма отдаю, no — не установлена
max_give — максимальная сумма отдаю, no — не установлена
min_get — макс сумма отдаю, no — не установлена
max_get — макс сумма отдаю, no — не установлена
changed — флаг изменения вводимой суммы: 0 — не нужно изменять, 1 — нужно изменить
get_exchanges
Вывод заявок, созданных данным ключом
Параметры запроса:
start_time — unix-время с которого выводить заявки (фильтр, необязательный параметр)
end_time — unix-время до которого выводить заявки (фильтр, необязательный параметр)
ip — ip-адрес (фильтр, необязательный параметр)
id — id заявки (фильтр, необязательный параметр)
api_id — id, переданное в API (фильтр, необязательный параметр)
status_history — выводить ли историю статусов: 0 — нет, 1 — да (фильтр, необязательный параметр)
limit — количество выводимых заявок (фильтр, необязательный параметр)
offset — сколько заявок пропустить (фильтр, необязательный параметр)
Ответ:
items — список заявок
id — id заявки
api_id — id, переданное в API
time — время изменения статуса
date — дата изменения статуса
psys_give — ПС отдаю
psys_get — ПС получаю
currency_code_give — код валюты отдаю
currency_code_get — код валюты получаю
course_give — курс отдаю
course_get — курс получаю
amount_give — сумма отдаю
amount_get — сумма получаю
exchange_success — 0 — заявка выполнена, 1 — заявка не выполнена
user_hash — хэш пользователя
user_ip — ip пользователя
status — статус заявки
statuses — список изменения статусов
time — время изменения статуса
date — дата изменения статуса
status — статус заявки
create_bid
Cоздание заявки
Параметры запроса:
direction_id — id направления обмена
partner_id — id партнера (необязательный параметр)
api_id — id заявки в вашей системе (необязательный параметр)
calc_amount — сумма обмена
calc_action — принадлежность суммы: 1 — сумма отдаю, 2 — сумма получаю, 3 — сумма отдаю с комиссией, 4 — сумма получаю с комиссией
callback_url — URL ответа при изменении статуса заявки (приходит методом POST)
bid_id — id заявки
status — статус заявки (необязательный параметр)
account1 — cо счета
cfgive8 — имя владельца карты
account2 — на счет
cf1-99 — кастомные поля
Примеры полей:
cf3 — Фамилия
cf1 — Имя
cf2 — Отчество
cf4 — Телефон
cf6 — E-mail
cf5 — Skype
cf8 — Номер паспорта
cf10 — Регион
cf11 — Telegram
Ответ:
url — ссылка на страницу обмена
id — id заявки
hash — hash заявки
status — статус заявки
status_title — название статуса заявки
psys_give — ПС отдаю
psys_get — ПС получаю
currency_code_give — код валюты "Отдаю"
currency_code_get — код валюты "Получаю"
amount_give — сумма отдаю
amount_get — сумма получаю
api_actions — опции
type — тип оплаты
cancel — способ отмены заявки
api — методом API
disabled — отключено
ссылка на отмену
pay — способ оплаты
api — методом API
disabled — отключено
ссылка на отмену
instruction — инструкция по оплате
pay_amount — сумма к оплате
cancel_bid
Отмена заявки
Параметры запроса:
hash — хэш заявки
Ответ:
статус заявки
pay_bid
Отметка заявки оплаченной
Параметры запроса:
hash — хэш заявки
Ответ:
статус заявки
get_partner_info
Информация о партнере
Параметры запроса:
—
Ответ:
partner_id — id партнера
balance — баланс
min_payout — мин. сумма выплаты
items — список валют, для заказа выплаты
id — id валюты
title — название валюты
comission — комиссия
amount — баланс в этой валюте
get_partner_links
Информация о партнерских переходах
Параметры запроса:
start_time — unix-время с которого выводить (фильтр, необязательный параметр)
end_time — unix-время до которого выводить (фильтр, необязательный параметр)
ip — ip-адрес (фильтр, необязательный параметр)
limit — количество выводимых (фильтр, необязательный параметр)
Ответ:
items — список партнерских переходов
time — время перехода
date — дата перехода
browser — браузер
ip — адрес перещедшего пользователя
referrer — страница, с которой был совершен переход
user_hash — хэш пользователя
query_string — строка запроса
get_partner_exchanges
Информация о партнерских обменах
Параметры запроса:
start_time — unix-время, с которого выводить заявки (фильтр, необязательный параметр)
end_time — unix-время, до которого выводить заявки (фильтр, необязательный параметр)
ip — ip-адрес (фильтр, необязательный параметр)
id — id заявки (фильтр, необязательный параметр)
status_history — выводить ли историю статусов: 0 — нет, 1 — да (фильтр, необязательный параметр)
limit — количество выводимых заявок (фильтр, необязательный параметр)
Ответ:
items — список заявок
id — id заявки
time — время изменения статуса
date — дата изменения статуса
psys_give — ПС отдаю
psys_get — ПС получаю
currency_code_give — код валюты отдаю
currency_code_get — код валюты получаю
course_give — курс отдаю
course_get — курс получаю
amount_give — сумма отдаю
amount_get — сумма получаю
exchange_success — 0 — заявка выполнена, 1 — заявка не выполнена
accrued — 0 — не начислено вознаграждение, 1 — начислено
partner_reward — партнерская сумма
user_hash — хэш пользователя
user_ip — ip пользователя
status — статус заявки
statuses — список изменения статусов
time — время изменения статуса
date — дата изменения статуса
status — статус заявки
get_partner_payouts
Список запросов от пользователей на вывод денежных средств
Параметры запроса:
start_time — unix-время с которого выводить (фильтр, необязательный параметр)
end_time — unix-время до которого выводить (фильтр, необязательный параметр)
limit — количество выводимых (фильтр, необязательный параметр)
id — id заявки (фильтр, необязательный параметр)
Ответ:
items — список
id — id заявки
time — время выплаты
date — дата выплаты
method_id — валюта выплаты
account — счет выплаты
pay_amount — сумма выплаты
pay_currency_code — код валюты выплаты
original_amount — оригинальная сумма выплаты
original_currency_code — оригинальный код валюты выплаты
status — статус заявки. 0 в ожидании, 1 — выплачено, 2 — отменено
add_partner_payout
Создание запроса на выплату
параметры запроса:
method_id — id валюты выплаты
account — номер счета для выплаты
ответ:
payout_id — id выплаты
