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

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

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

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

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

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

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

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

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

Запрос

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

Для получения карточного уведомления с файлом дизайна карты, отправьте параметр 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": "2026",
        "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/Mastercard.

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

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

Пример карточного уведомления

{
  "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": 2026,
  "image": "https://some-url-for-image.com/image.png"
}

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

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

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

Торговцу следует кэшировать полученное изображение для дальнейшего использования, вместо того, чтобы запрашивать его при каждой транзакции.
Цифровые изображения карты, предоставляемые Visa/Mastercard, не включают имя держателя карты, PAN или дату истечения срока действия ни в общей форме, ни с использованием фактических значений.
Последние четыре цифры номера карты или цифрового номера счета и имя держателя карты должны быть размещены в левом нижнем углу цифрового изображения карты (если оно используется).
Никакие изображения или текст, кроме последних четырех цифр номера карты или цифрового номера счета и/или имени держателя карты, не могут быть размещены поверх рисунка карты.

Visa card art

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