Ugrás a fő tartalomhoz

Hitelesítés - HMAC (Éles)

Éles Környezet

Ez az éles környezet HMAC setupja. Minden tranzakció valós pénzmozgást eredményez!

Online Fizető Oldal specifikus

Ez a hitelesítési módszer CSAK az Online Fizető Oldal termékhez használatos.

Payment API, Balance API, EAM és Fizetési kérelem CSR/JWT alapú hitelesítést használ → CSR/JWT hitelesítés (éles)

Mi az a HMAC?​

HMAC (Hash-based Message Authentication Code) egy üzenet hitelesítési kód, amely biztosítja, hogy a kérés valóban a partnertől származik és nem módosították útközben.

Az Online Fizető Oldal API hívásához szükséges:

  • API key - HTTP header-ben (x-api-key)
  • HMAC secret - Payload aláírásához
  • Technical User ID - Payload-ban (technicalUserId)

Credential kinyerése RPP portálról​

A szükséges credential-öket az éles Raiffeisen Pay Portálon az API felhasználó létrehozása és jogosultság beállítása után lehet kinyerni.

Lépések:

  1. Raiffeisen Pay Portal beállítás (éles) követése
  2. EAM és RTP jogosultságok beállítása
  3. Credential-ök megjelennek az RPP felületen

Kinyerhető adatok:

API key és HMAC a képernyőn
  • API key (x-api-key) - HTTP header-ben használandó
  • HMAC secret - HEX formátumú, payload aláírásához
  • Technikai felhasználó azonosító (Technical User ID) - payload mezőben
HMAC secret formátum

A HMAC secret HEX formátumban van. Egyes HMAC library-k alapból nem HEX formátumban várják ezt a paramétert, figyelj erre az implementációnál.

Credential biztonság

SOHA ne commitold az API key-t vagy HMAC secret-et git repo-ba! Használj secrets manager-t.

API hívás összeállítása​

HTTP Headers​

POST /v1/ofo/start
Host: premium-api.raiffeisen.hu
Content-Type: application/json
x-api-key: <API_KEY_FROM_RPP>
Signature: <GENERATED_HMAC_SIGNATURE>
x-correlation-id: <UUID>
x-request-id: <UUID>
Éles URL

Az éles környezet URL-je: https://premium-api.raiffeisen.hu (NINCS -pc végződés!)

Header magyarázat:

  • Content-Type - Mindig application/json
  • x-api-key - Az RPP portálról kinyert API key
  • Signature - A generált HMAC signature
  • x-correlation-id - UUID (kérés azonosító, logoláshoz)
  • x-request-id - UUID (technikai azonosító)

Request Body​

A request body a minified JSON payload.

{"idempotencyKey":"f4e5b92d-60ff-46bd-a26a-8342116cdec5","technicalUserId":"10234","language":"HU","url":"https://your-webshop.hu","transactionReference":"1Ffnhelta3b","paymentMethods":["EAM"],"transactionCurrency":"HUF","transactionAmount":250,"remittanceInfo":"Vásárlás","shopId":"shop0001","terminalReference":"terminal0001","timestamp":"2026-01-20T14:23:45Z"}
Figyelem

Soha ne töltsd fel nyilvános helyre az alábbi értékeket:

  • API key (x-api-key)
  • HMAC secret
  • HMAC signature (részlegesen sem)
  • Teljes request body (ha tartalmaz sensitive adatot)

Add meg helyette helyette: x-correlation-id, x-request-id, response status code, error message

Hibaelhárítás​

Gyakori hibák​

HibaOkMegoldás
401 UnauthorizedRossz API keyEllenőrizd API key-t RPP portálon
401 UnauthorizedRossz HMAC signatureEllenőrizd HMAC generálást és HEX decode-ot
403 ForbiddenTimestamp túl régi (>5 perc)Szinkronizáld az órát (NTP)
Invalid signatureRossz HMAC secretEllenőrizd hogy a helyes secret-et használod

Következő lépés​

Első API hívás

Most, hogy az HMAC hitelesítés be van állítva, indíthatod az első éles API hívást.

Első API hívás (éles) →

Online Fizető Oldal dokumentáció

Részletes Online Fizető Oldal dokumentáció: Online Fizető Oldal →