IPN (Egyszerű kifizetési értesítés)
💵 Bizonylatok kifizetettségének visszajelzése
Lehetőség van arra, hogy bizonylatok (számla, díjbekérő) kifizetettségéről értesítést - IPN (Instant Payment Notification) - kapjon a webáruház (vagy egyéb üzleti alkalmazás).
Ezt az üzenetet a Számlázz.hu küldi egy meghatározott webcímre HTTP POST kérésként. Az URL megadható a számlázási fiókban a Fiók beállítások / Számlázás alapadatok oldal alján lévő beviteli mezőben.
⏰ Mikor küldi a rendszer az IPN üzenetet?
Az IPN üzenet akkor jön létre, amikor:
- Egy számla kifizetett összege megváltozik (például részleges vagy teljes kifizetés történik)
- A változás a számla kiállítója (kibocsátó) oldaláról történik
- A cég rendelkezik beállított IPN URL-lel
📋 IPN üzenet paraméterei
Az IPN üzenet a következő paramétereket tartalmazza:
| Paraméter | Leírás | Példa |
|---|---|---|
szlahu_szamlaszam | A kiegyenlített számla száma | E-2020-123 |
szlahu_dijbekero_szama | A szülő díjbekérő száma (ha van) | DB-2020-456 |
szlahu_rendelesszam | Rendelésszám (ha szerepelt a számlán) | RND1234 |
szlahu_bruttovegosszeg | A számla bruttó végösszege | 10000 |
szlahu_kifizetettbrutto | A kifizetett összeg | 10000 |
szlahu_fizetesmod | A kifizetés módja | kp, bankkártya, átutalás |
szlahu_kifizdat | A kifizetés dátuma (ÉÉÉÉ-HH-NN) | 2025-05-14 |
A szlahu_kifizdat IPN üzenet küldése alapértelmezetten nem elérhető. Amennyiben szeretnéd használni ezt a funkciót, ügyfélszolgálatunk készséggel segít annak aktiválásában. Kérjük, lépj kapcsolatba ügyfélszolgálatunkkal, és kérj hozzáférést!
💻 Technikai implementáció
IPN üzenet formátuma
FONTOS: Az IPN üzenet adatai a HTTP POST kérés body-jában kerülnek átküldésre. Az üzenet application/x-www-form-urlencoded content type-tal érkezik.
Válasz követelménye
A fogadó rendszernek HTTP 200 OK választ kell küldenie, hogy jelezze a sikeres feldolgozást. A válasz törzsének tartalma nem releváns, csak a HTTP státuszkód számít.
⚠️ Fontos megjegyzések
Újrapróbálási mechanizmus
Ha az IPN küldése sikertelen (nem 200 OK válasz érkezik, vagy timeout történik), a rendszer automatikusan újrapróbálja a küldést. Az újrapróbálási mechanizmus a következőképpen működik:
- Az IPN üzenetek nem azonnal kerülnek elküldésre
- 3 percenként próbáljuk elküldeni a kifizetettségi információkat
- Maximum 10 próbálkozás történik
- Ha nem kapunk HTTP 200 OK választ, az IPN-t eldobjuk
IPN üzenetek felhalmozódása
A küldő rendszerben (Számlázz.hu) feltorlódhatnak az IPN kérések, különösen nagy forgalom esetén. Ezek az üzenetek idővel automatikusan kiküldésre kerülnek a fogadó rendszer felé.
Duplikált üzenetek kezelése
A rendszer biztosítja, hogy ugyanahhoz a számlához csak egy aktív IPN üzenet legyen egyszerre. Ha egy számlához több IPN rekord tartozik, csak a legfrissebb kerül elküldésre, a többi automatikusan törlődik.
🌐 IP címek és hálózati beállítások
Az IPN üzenetek a következő IP címekről érkeznek:
3.73.214.98
3.76.149.232
18.153.156.51
Ha IP-alapú szűrést használsz, ezeket a címeket add hozzá a whitelist-hez.
A korábbi IP címek (18.153.1.171, 3.73.114.72, 52.59.28.5) 2025. augusztus 1-től már nem használatosak.
Részletes információ: Technológiai változások 2025