Сохранение карт
Добавление карты
Базовая механика сохранения карт. Далее сохраненные карты можно использовать как для оплат, так и для выплат.
Для использования данного запроса Вам следует обратиться к своему менеджеру.
Для использования данного запроса Вам следует обратиться к своему менеджеру.
Поля запроса
URL запроса
| Название | Описание | Тип |
|---|---|---|
| pg_merchant_id required | Идентификатор мерчанта в системе Paybox | integer |
| pg_user_id required | ID пользователя в системе мерчанта. Пример: 1234 | integer |
| pg_order_id | ID заказа в системе мерчанта, уникальное значение. Пример: 12345 | string |
| pg_card_name required | Имя и фамилия держатели карточки. Буквы (латиница), тире (-) и пробел. Пример: TEST TESTOV | string |
| pg_card_pan required if no pg_card_token | Номер карты. Пример: 4405645000006150 | string |
| pg_card_token required if no pg_card_pan | Токен карты, по которому требуется обогатить данные. Если ранее карта была сохранена со статусом is_sender=0 | string |
| pg_card_cvc required | Трёхзначный код проверки подлинности карты.Пример: 653 | integer |
| pg_card_year required | Срок действия карты (год) yy. Пример: 25 | integer |
| pg_card_month required | Срок действия карты (месяц) mm. Пример: 09 | integer |
| pg_salt required | Случайная строка, состоящая из произвольных цифр и латинских букв. Пример: some random string | string |
| pg_sig required | Подпись запроса | string |
Параметры ответа
| Название | Описание | Тип |
|---|---|---|
| pg_payment_id | Уникальный идентификатор платежной транзакции в Paybox. Служит ключом для всей дальнейшей работы с транзакцией | integer |
| pg_order_id | Идентификатор заказа в системе мерчанта | string |
| pg_card_token | Токен сохраненной карты | string |
| pg_user_id | ID пользователя в системе мерчанта | string |
| pg_status | Статус платежа | string |
| pg_3ds | Флаг обозначающий необходимость запроса 3DS. 1 – 3DS установлен, 0 - нет | number |
| pg_3d_acsurl | URL Банка эмитента карты для проверки 3DS | string |
| pg_salt | Случайная строка, состоящая из произвольных цифр и латинских букв. Пример: some random string | string |
| pg_sig | Подпись запроса | string |
Примечание. В случае, если на карте установлен 3ds, необходимо сделать запрос в ACS сервер банка эмитента карты.
На этой странице клиент вводит свой 3ds пароль.
URL сервера можно получить из параметра pg_3d_acsurl.
Параметры запроса в ACS сервер банка эмитента:
На этой странице клиент вводит свой 3ds пароль.
URL сервера можно получить из параметра pg_3d_acsurl.
Параметры запроса в ACS сервер банка эмитента:
| Название | Описание |
|---|---|
| TermUrl | URL на который придет ответ в случае успеха |
URL запроса
Добавление карты с 3DSecure
Поля запроса
| Название | Описание | Тип |
|---|---|---|
| pg_merchant_id required | ID магазина. Цифры | integer |
| pg_payment_id required | ID транзакции. Цифры | integer |
| pg_md required | Параметр из ответа. ACS сервера эмитента карты. Цифры и латинские буквы | string |
| pg_pares required | Параметр из ответа. ACS сервера эмитента карты. Буквы, цифры, тире (-) | string |
| pg_salt required | Случайная строка, состоящая из произвольных цифр и латинских букв. Пример: some random string | string |
| pg_sig required | Подпись запроса | string |
Параметры ответа
| Название | Описание | Тип |
|---|---|---|
| pg_payment_id | ID транзакции | integer |
| pg_status | Статус запроса | string |
| pg_order_id | Идентификатор заказа в системе мерчанта | string |
| pg_card_token | Токен сохраненной карты | string |
| pg_reference | RRN операции | string |
| pg_salt | Случайная строка | string |
| pg_sig | Цифровая подпись запроса | string |
В случае ошибок, будут дополнительные параметры ответа:
| Название | Описание | Тип |
|---|---|---|
| pg_error_code | ID кода ошибки | string |
| pg_error_description | Текстовое описание ошибки | string |
| Название | Описание | Тип |
|---|---|---|
| pg_merchant_id required | Идентификатор мерчанта в системе Paybox | integer |
| pg_user_id required | ID пользователя в системе мерчанта. Пример: 1234 | integer |
| pg_card_token required | Токен карты. Пример: ef741cfc-f85e-41a0-84e6-2ba964912182 | string |
| pg_salt required | Случайная строка, состоящая из произвольных цифр и латинских букв. Пример: some random string | string |
| pg_sig required | Подпись запроса | string |
Параметры ответа
| Название | Описание | Тип |
|---|---|---|
| pg_status | Показывает результат выполнения запроса | string |
| deleted_at | Дата удаления карты | datetime |
| pg_salt | Случайная строка | string |
| pg_sig | Подпись запроса | string |
В случае ошибок, будут дополнительные параметры ответа:
| Название | Описание | Тип |
|---|---|---|
| pg_error_code | ID кода ошибки | string |
| pg_error_description | Текстовое описание ошибки | string |
| Название | Описание | Тип |
|---|---|---|
| pg_merchant_id required | Идентификатор мерчанта в системе Paybox | integer |
| pg_user_id required | ID пользователя в системе мерчанта. Пример: 1234 | integer |
| pg_salt required | Случайная строка, состоящая из произвольных цифр и латинских букв. Пример: some random string | string |
| pg_sig required | Подпись запроса | string |
Параметры ответа
| Название | Название параметра | Описание | Тип |
|---|---|---|---|
| card | pg_status | Показывает статус карты | string |
| - | pg_card_token | Токен карты | string |
| - | pg_is_filled | Признак, что карту можно использовать для списания | integer |
| - | pg_card_hash | Маскированный PAN | string |
| - | created_at | Дата добавления карты | datetime |
| pg_salt | - | Cлучайная строка | string |
| pg_sig | - | Подпись запроса | string |
В случае ошибок, будут дополнительные параметры ответа:
| Название | Описание | Тип |
|---|---|---|
| pg_error_code | ID кода ошибки | string |
| pg_error_description | Текстовое описание ошибки | string |
Справочник статусов карт
| Статус | Описание |
|---|---|
| verified | Карта может использовать для отправки перевода и получения перевода |
| unverified | Карта может использоваться для получения перевода. Карта может использоваться для отправки перевода если переданы pg_card_cvc, pg_card_year и pg_card_month |
| deleted | Карта удалена и не может использоваться |
| expired | Карта просрочена |
| blocked | Карта заблокирована |