Genesis Card

Быстрый старт

1. Подписаться at genesis.com и получить API полномочия
2. Создать терминал в Консоль Admin с приведенными ниже параметрами
3. Начало обработки — адаптер предварительно построен и готов к использованию

Отправляйтесь в Genesis Card

Обзор

Интеграция платежных карт Genesis

поставщик ID	genesis_card
Категория	Карточные процессоры
Сайт	genesis.com

---

конфигурация

Необходимые параметры

Параметр	Описание
merchant	Торговый идентификатор
api_key	API ключ для HMAC-SHA подписи
currency	Код валюты (например: RUB)
callback_url	URL для обратного вызова уведомлений от провайдера

Пример конфигурации

{
  "env": "prod",
  "merchant": "merchant123",
  "api_key": "hmac_secret_key",
  "currency": "RUB",
  "callback_url": "https://api.merchant.com/callback"
}

---

Платежный поток

Платежи (однофазные и двухфазные):

Однофазный:

1. start_tx - создание платежа через POST /payment:
   • Отправка карт данных (pan, cvc2, exp_month, exp_year)
   • customer_ip, сумма, валюта, success_url, fail_url, callback_url
   • HMAC-SHA Подпись всех параметров (алфавитный порядок)
   • Retrieval transaction_id, status, дополнительные параметры 3DS (pareq, md, term_url)

Двухфазный:

• Проверка = one_phase (плата за инициацию)
• Обещание не выполнено (используется только для проверки)

Выплаты (одна фаза):

1. start_tx - создание выплат через POST /payout:
   • Отправка адресата_card, beneficiary_first_name, beneficiary_last_name (идентификаторы: destination_card)
   • Сумма, валюта, order_id
   • HMAC-SHA сигнатура полезной нагрузки
   • RSA подпись заголовка X-Signature (MD5 хеш-карты + сумма + валюта + order_id
   • Обратная связь_id и status (идентификаторы: transaction_id)

Проверка состояния:

• POST /payment/status or POST /payout/status
• Параметры: merchant, order_id, timetamp
• HMAC-SHA Параметры подписи
• Refund status_code и status_text

---

Картирование состояния

Статус поставщика	4pay Статус	Описание
1	charging
2	charged
6	rejected
-6	failed

---

Средства

• Официальная документация