Genesis

Quick Start

1. Sign up at genesis.com and obtain API credentials
2. Create a terminal in the Admin Console with the parameters below
3. Start processing — the adapter is pre-built and ready to use

Go to Genesis →

Overview

Genesis payment integration

Provider ID	genesis
Category	Card Processors
Website	genesis.com

---

Configuration

Required Parameters

Parameter	Description
merchant	merchant identifier
api_key	API key for HMAC-SHA signatures
currency	currency code (by default: RUB)
callback_url	URL for callback notifications from provider

Example Configuration

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

---

Payment Flow

Payments via SBP (one-phase):

1. process_operation - payment creation via POST /payment:

   • payment_method = "sbp" (fixed value)
   • amount, currency, customer_ip, merchant, order_id
   • callback_url, website_url
   • HMAC-SHA signature all parameters (alphabetical order!)
   • Retrieval transaction_id, url for redirect, method

2. Redirect for QR-code:

   • URL from response for display QR
   • method from response (usually GET)
   • redirect_url_for_provider - used instead of website_url for callback

Refund:

• POST /refund with merchant, order_id, amount, timestamp
• HMAC-SHA signature parameters
• Statuses: 1 → refunding, 2 → refunded

Status check:

• POST /payment/status
• Parameters: merchant, order_id, timestamp
• HMAC-SHA signature
• Refund status_code

---

Status Mapping

Provider Status	4pay Status	Description
1	charging
2	charged
6	rejected
-6	failed

---

Resources

• Official Documentation