Перейти к содержанию

Изображения платежных карт

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

В дальнейшем, изображение карты можно размещать на страницах сайта или приложения торговца, где предполагается отображение PAN карты, например:

  • при отображении привязанных карт в профиле пользователя.
  • при отображении доступных платежных карт на странице оплаты.

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

  • прислать notification_url в секции credit_card в случае прямой интеграции.
  • прислать card_notification_url в секции settings в запросе на создание токена в случае интеграции через платежный виджет.

Demo PSP пришлет карточное уведомление на указанный URL. Уведомление будет содержать параметр image с ссылкой на файл с изображением дизайна карты в формате PNG.

Условия использования:

  • На данный момент, возможность доступна только для карточек Visa.
  • Торговец должен быть участником Visa Tokenization Service (VTS). Регистрацию торговца в сервисе VTS осуществляет Demo PSP. Уточните у вашего аккаунт менеджера, подключен ли вам данный сервис.

Запрос

Прямая интеграция

Для получения карточного уведомления с файлом дизайна карты, отправьте параметр notification_url в объекте credit_card в одном из следующих запросов:

Параметр Тип Описание
credit_card object Секция параметров платежной карты.
notification_url
обязательный
string (255) URL, на который будут приходить карточные уведомления.
Пример запроса оплаты с credit_card.notification_url
{
  "request":{
      "amount":100,
      "currency":"USD",
      "description":"Test transaction",
      "tracking_id":"your_uniq_number",
      "language":"en",
      "test":true,
      "billing_address":{
        "first_name":"John",
        "last_name":"Doe",
        "country":"US",
        "city":"Denver",
        "state":"CO",
        "zip":"96002",
        "address":"1st Street"
      },
      "credit_card":{
        "number":"4200000000000000",
        "verification_value":"123",
        "holder":"John Doe",
        "exp_month": "05",
        "exp_year": "2020",
        "notification_url": "https://your-card-notification-url"
      },
      "customer":{
        "ip":"127.0.0.1",
        "email":"john@example.com"
      }
  }
}

Интеграция через платежный виджет

Укажите card_notification_url в секции settings в запросе на создание токена платежа.

Карточные уведомления

Ссылка на файл с дизайном платежной карты придет в карточном уведомлении на указанный URL.

Карточные уведомления высылаются в двух случаях:

  • Торговец отправляет запрос оплаты/токенизации/авторизации, указав credit_card.notification_url или запрос на создание токена платежа, указав settings.card_notification_url в случае интеграции через виджет.
  • Эмитент платежной карты меняет дизайн карты и уведомляет об этом Visa.

Проверка уведомлений

Карточные уведомления проверяются также, как и автоматические уведомления о транзакции.

Пример карточного уведомления
{
  "holder": "John Doe",
  "stamp": "399c17cbfc7d07fe3351f031a0952152240492c0d5793bb972b0ceba2da9842b",
  "brand": "visa",
  "last_4": "0000",
  "first_1": "4",
  "token": "6045e2bd-5b0c-4a8c-8357-24d1cdfbb9df",
  "product": null,
  "bin": "420000",
  "bin_8": "42000000",
  "issuer_country": null,
  "issuer_name": null,
  "exp_month": 11,
  "exp_year": 2025,
  "image": "https://some-url-for-image.com/image.png"
}

Обработка карточных уведомлений

Веб-сервер торговца должен вернуть HTTP статус 200, если уведомление было обработано успешно. В противном случае, через некоторое время, Demo PSP вышлет уведомление повторно.

Использование изображения карты на платежной странице

  • Торговцу следует кэшировать полученное изображение для дальнейшего использования, вместо того, чтобы запрашивать его при каждой транзакции.

  • Цифровые изображения карты, предоставляемые Visa, не включают имя держателя карты, PAN или дату истечения срока действия ни в общей форме, ни с использованием фактических значений.

  • Последние четыре цифры номера карты или цифрового номера счета и имя держателя карты должны быть размещены в левом нижнем углу цифрового изображения карты (если оно используется).

  • Никакие изображения или текст, кроме последних четырех цифр номера карты или цифрового номера счета и/или имени держателя карты, не могут быть размещены поверх рисунка карты.

Visa card art

  • Последним четырем цифрам номера карты Visa и номера цифрового счета всегда должна предшествовать надпись "Visa" (например, Visa 9876).