Токенизация карты получателя

Транзакция используется для токенизации банковской карты получателя средств и проведения 3-D Secure проверки.

Зачисления средств не происходит. Используйте полученный токен, чтобы провести выплату средств.

---

Запрос

Отправьте POST запрос на https://gateway.fortebank.com/transactions/recipient_tokenizations со следующими параметрами:

Note

Тело запроса должно быть обёрнуто в корневой объект request{}.

description string (255) Описание транзакции. tracking_id string (255) Ваш внутренний ID транзакции. Пожалуйста, используйте уникальное значение для того, чтобы при запросе статуса транзакции получить актуальную информацию. В противном случае вы получите массив данных по 10 последним транзакциям, найденным по указанному tracking_id. В параметре может быть отправлено несколько значений, разделенных символом ;. Например: "cbe59142-90af-4aea-b5a5-5bf3f66cf3da;f7883cb9-0e26-43a7-beb7-4027cb55d1a6;4a6a89d5-6950-400f". Если в запросе было передано более одного значения tracking_id, поиск транзакции в личном кабинете может быть осуществлен по любому из них. recipient_billing_address object Узнайте у службы поддержки, должны ли вы отправлять эти данные. first_name условно обязательный string (30) Имя владельца карты. last_name условно обязательный string (30) Фамилия владельца карты. country условно обязательный string Страна владельца карты в формате ISO 3166-1 alpha-2. city условно обязательный string (60) Город владельца карты. state условно обязательный string Двухбуквенная аббревиатура штата, если страна владельца карты IN, US или CA. zip условно обязательный string Почтовый индекс владельца карты. Для country=US, формат почтового индекса должен иметь вид NNNNN или NNNNN-NNNN. address условно обязательный string (255) Адрес владельца карты. phone условно обязательный string (100) Номер телефона владельца карты. recipient_credit_card object number обязательный string (19) Номер карты. holder условно обязательный string (35) Имя владельца карты. Максимальная длина: 35 символов. Параметр опционален в системе Forte E-commerce, но может требоваться банком-эквайером. exp_month string (2) Месяц окончания срока действия карты, представленный одной или двумя цифрами (например, 01). exp_year string (4) Год окончания срока действия карты, представленный четырьмя цифрами (например, 2027). recipient object Узнайте у службы поддержки, должны ли вы отправлять эти данные. ip string IP-адрес покупателя, запросившего транзакцию токенизации. email string email покупателя, запросившего транзакцию токенизации device_id string ID устройства покупателя, запросившего транзакцию токенизации. birth_date string Дата рождения покупателя в формате ISO 8601 YYYY-MM-DD. external_id string (255) Идентификатор покупателя в системе торговца.

Пример запроса

{
  "request": {
    "description": "Test transaction",
    "tracking_id": "your_uniq_number",
    "recipient_billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "country": "US",
      "city": "Denver",
      "state": "CO",
      "zip": "96002",
      "address": "1st Street"
    },
    "recipient_credit_card": {
      "number": "4200000000000000",
      "holder": "John Doe",
      "exp_month": "05",
      "exp_year": "2027"
    },
    "recipient": {
      "ip": "127.0.0.1",
      "email": "john@example.com"
    }
  }
}

Ответ

Ответ будет содержать те же параметры, что и запрос, а также дополнительные параметры:

transaction object uid обязательный string UID обработанной транзакции. status обязательный string Статус обработанной транзакции. type обязательный string Тип транзакции. payment_method_type обязательный string Способ оплаты, используется для завершения транзакции: credit_card tracking_id string Значение параметра tracking_id из запроса. message обязательный string Сообщение с результатом запроса. created_at обязательный string Дата создания транзакции. updated_at обязательный string Дата обновления транзакции. Например, обновление статуса. recipient_credit_card object holder string Имя владельца карты. stamp обязательный string Хэш карты. Постоянная величина, даже если дата окончания действия карты или владелец изменены. token обязательный string Токен карты. Позволяет сохранять данные покупателей и производить оплату, когда они делают покупку или вы возобновляете свои услуги. brand обязательный string Определенный бренд карты. last_4 обязательный string Последние 4 цифры карты. first_1 обязательный string Первая цифра карты. bin обязательный string (6) Шестизначный банковский идентификационный номер. Первые 6 цифр номера карты. bin_8 обязательный string (8) Восьмизначный банковский идентификационный номер. Первые 8 цифр номера карты. Значение возвращается для карт Visa, Mastercard, Maestro и соответствующих кобрендинговых карт. Для брендов других платежных карт значение параметра – null. issuer_country обязательный string (2) Страна банка, выпустившего карту в формате ISO 3166-1 alpha-2. issuer_name обязательный string Название банка, выпустившего карту. product обязательный string Код типа карточного продукта. exp_month обязательный integer Месяц окончания срока действия карты. exp_year обязательный integer Год окончания срока действия карты. token_provider обязательный string В данной транзакции не используется. Всегда null. id обязательный string UID обработанной транзакции. Пример ответа { "transaction": { "uid": "0775f4fe-c4ac-4b55-83c2-d89ef948d84a", "status": "successful", "description": "Test transaction", "type": "recipient_tokenization", "payment_method_type": "credit_card", "tracking_id": "your_uniq_number", "message": "Successfully processed", "created_at": "2024-04-02T15:52:51.606Z", "updated_at": "2024-04-02T15:52:51.687Z", "recipient": { "ip": "127.0.0.1", "email": "john@example.com", "device_id": null, "birth_date": null }, "recipient_credit_card": { "holder": "John Doe", "stamp": "b3839d334ba40e89168d60cd9f9d1390aee3fe67dd4d5c41adbf3998043eaef8", "brand": "visa", "last_4": "0000", "first_1": "4", "bin": "420000", "bin_8": "42000000", "issuer_country": "US", "issuer_name": "VISA Demo Bank", "product": "F", "exp_month": 5, "exp_year": 2027, "token_provider": null, "token": "39799863-240f-417e-9f12-5ca713118069" }, "recipient_billing_address": { "first_name": "John", "last_name": "Doe", "address": "1st Street", "country": "US", "city": "Denver", "zip": "96002", "state": "CO", "phone": null }, "status_code": null, "id": "0775f4fe-c4ac-4b55-83c2-d89ef948d84a" } }