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

Для Поставщиков услуг, бизнес процесс которых предполагает работу с картой пользователя в приложении/системе, 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.paymo.uz/partner/bind-card/dial

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

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

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

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

Метод partner/list-cards

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

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

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

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

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

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

Метод partner/remove-card

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

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

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

#	Поле	Описание
1	id	Id карты в системе PAYMO
2	token	Токен карты

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

#	Поле	Описание
1	data	Объект с ответными данными
1.1	card_id	Id карты в системе PAYMO
1.2	pan	null
1.3	expiry	null
1.4	card_holder	null
1.5	balance	null
1.6	phone	null
1.7	card_token	null