Ugrás a fő tartalomhoz

Első API hívás (Éles)

Éles Tranzakciók - Valós Pénzmozgás!

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

Most, hogy minden setup lépés kész, indítsd el az első éles API hívást - óvatosan!

Technikai előfeltételek​

  • RPP regisztráció kész (éles portál)
  • API felhasználó létrehozva
  • Jogosultságok beállítva
  • Hitelesítés konfigurálva (CSR/JWT vagy HMAC)
  • Credential-ök kinyerve és biztonságosan tárolva
  • Tesztelés sikeres volt
Payment API felhasználóknak

Ne felejtsd el, hogy Payment API esetén még szükséges a Consent létrehozása és jóváhagyása (éles)!

Éles környezet URL-ek​

API base URL (éles):

https://premium-api.raiffeisen.hu

Pay Portal (éles):

https://payportal.raiffeisen.hu
Különbség sandbox-tól
  • URL-ben NINCS -pc végződés
  • 24/7 elérhetőség (nem 7-20)
  • Valós tranzakciók

HTTP headerek beállítása​

CSR/JWT alapú hitelesítés (Payment API, EAM, fizetési kérelem)​

Szükséges headerek:

HeaderÉrtékLeírás
x-api-keyRPP portálrólA technikai felhasználóhoz (TECHUSER) kötött API kulcs. Egy cégnek több TECHUSER-e és így több x-api-key értéke is lehet.
x-jws-signatureDetached JWTA request body-ra számított aláírás. Formátum: header.signature (payload kihagyva). Részletek: JWS aláírás generálás
x-correlation-idUUID v4Kérés azonosító a logokban való kereséshez. Minden híváshoz egyedi érték.
x-request-idUUID v4Technikai azonosító a logokban való kereséshez. Minden híváshoz egyedi érték.
user-agentTetszőleges stringKötelező header, tartalma bármi lehet (pl. MyApp/1.0.0).
Content-Typeapplication/jsonA request body formátuma.

JWS aláírás generálás:

Minden API híváshoz a request body-ból készül egy Detached JWS aláírás. Ez nem OAuth2 bearer token - nincs lejárat, minden híváshoz új aláírás kell.

Részletes útmutató: JWS Aláírás Generálás

HMAC alapú hitelesítés (Online Fizető Oldal)​

Részletes útmutató: HMAC Hitelesítés (éles)

Első éles hívások termékek szerint​

Balance API​

Részletes dokumentáció: Balance API →

Payment API​

Részletes dokumentáció: Payment API →

Statement API (kivonat letöltés)​

Részletes dokumentáció: Statement API →

qvik EAM​

Részletes dokumentáció: qvik EAM →

Fizetési kérelem​

Részletes dokumentáció: Fizetési kérelem →

Online Fizető Oldal​

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

Gyakori hibák​

Megjegyzés

A consentList tömbnek mindig 2 elemet kell tartalmaznia. Egyes aláírás esetén ugyanaz az azonosító kétszer is megadható (pl. [1, 1]).

401 Unauthorized​

Lehetséges okok:

  • Hibás JWT token vagy API key
  • Lejárt tanúsítvány (CSR/JWT)
  • Rossz KID a JWT header-ben
  • Rossz HMAC signature

Megoldás:

  • Ellenőrizd a KID helyes-e
  • Ellenőrizd a privát kulccsal aláírtad-e a JWT-t
  • Ellenőrizd az API key-t
  • Ellenőrizd a tanúsítvány lejáratát (openssl x509 -in cert.pem -noout -dates)

403 Forbidden​

Lehetséges okok:

  • Nincs megfelelő jogosultság
  • Lejárt Consent (Payment API)
  • Timestamp túl régi (> 5 perc) (HMAC)
  • Inaktivált API felhasználó

Megoldás:

  • Ellenőrizd az RPP portálon a jogosultságokat
  • Ellenőrizd a Consent lejáratát (Payment API)
  • Szinkronizáld az órát (NTP)
  • Ellenőrizd az API felhasználó státuszát RPP-n

400 Bad Request​

Lehetséges okok:

  • Hibás payload formátum
  • Hiányzó kötelező mező
  • Invalid összeg (negatív, túl nagy)
  • Invalid számlaszám formátum

Megoldás:

  • Validáld a payload-ot JSON schema-val
  • Ellenőrizd a termék dokumentációban a kötelező mezőket
  • Ellenőrizd az összeg formátumot (integer, fillérben)

500 Internal Server Error​

Lehetséges okok:

  • Banki backend probléma
  • Hibás konfiguráció
  • Network timeout

Megoldás:

  • Ellenőrizd az éles környezet elérhetőségét (24/7 de lehet maintenance)
  • Retry exponential backoff-fal
  • Vedd fel a kapcsolatot a 24/7 support-tal: premiumapi_support@raiffeisen.hu vagy +36 80 488 588