Привязка карт

Для Поставщиков услуг, бизнес процесс которых предполагает работу с картой пользователя в приложении/системе, PAYMO предлагает привязать её и дальше вести работу с картой через методы снятия, холдирования и рекуррентных платежей.

Процесс осуществления холдирования:
  1. Система Поставщика услуг передает реквизиты карты пользователя partner/bind-card/create.
  2. Владельцу карты отправляется SMS с кодом подтверждения.
  3. Система Поставщика услуг подтверждает привязку карты partner/bind-card/apply.
  4. В случае если SMS не доходит до пользователя, можно использовать метод дозвона и продиктовки кода partner/bind-card/dial.

Механизм авторизации для вызова методов API указан в разделе Авторизация в API.

В запросах ко всем методам имеется поле lang, в котором необходимо передать язык ответного сообщения. Во всех ответах передается объект result с полями code – код и description – описание результата запроса. Далее в документации поля lang и result будут опущены для упрощения описания методов.

Метод partner/bind-card/create

Метод создает заявку на привязку карты пользователя к Поставщику услуг

Адрес: POST https://api.paymo.uz/partner/bind-card/create

Входящее сообщение:

Поле Описание
card_number Номер карты
expiry Дата истечения карты (формат yyMM)

Ответное сообщение:

# Поле Описание
1 transaction_id Идентификатор транзакции

Метод partner/bind-card/apply

Метод подтверждает созданную заявку на привязку

Адрес: POST https://api.paymo.uz/partner/bind-card/apply

Входящее сообщение:

# Поле Описание
1 transaction_id Идентификатор транзакции, полученный в методе bind-card/create
2 otp Код подтверждения, высланный в SMS

Ответное сообщение:

# Поле Описание
1 data Данные о карте
1.1
  • card_token
Токен карты в системе PAYMO, который дальше будет использован при вызове других методов
1.2
  • pan
Маска карты
1.3
  • card_holder
Эмбоссированное имя (владельца) на карте
1.4
  • balance
Баланс карты (только по спец. доступу)

Метод partner/bind-card/dial

Метод звонит на номер СМС-информирования, привязанный к карте и диктует высланный при /bind-card/create одноразовый код.

Адрес: PUT https://api.pays.uz/partner/bind-card/dial

Входящее сообщение:

# Поле Описание
1 transaction_id Идентификатор транзакции

Ответное сообщение:

# Поле Описание
1 code «OK» - успешно
2 description Описание ответа

Метод partner/bind-card/list-cards

Получение списка привязанных карт Поставщику услуг.

Адрес: POST https://api.pays.uz/partner/bind-card/list-cards

Входящее сообщение:

# Поле Описание
1 page Номер страницы (по умолчанию 1)
2 page_size Кол-во записей на страницу (по умолчанию 25)

Ответное сообщение:

# Поле Описание
1 card_list Массив карт
1.1
  • card_token
Токен карты в системе PAYMO
1.1
  • pan
Маска карты