Befizetés rögzítése

Ha a vevő nem a számla kiállításakor fizet, hanem később, átutalással, részletekben vagy készpénzben, a befizetést utólag rögzítheted a számlán. A Számlázz.hu a befizetésekből számolja a számla hátralékát. A kasszában az invoices.registerPayment() rögzít befizetést, az invoices.clearPayments() pedig törli a számla összes befizetését.

A másik irányt az IPN kezeli: ha a Számlázz.hu-ban megváltozik egy számla kifizetett összege, értesítést küld a webhook végpontodra, amelyet a kassza/ipn modullal dolgozol fel.

const befizetes = await kassza.invoices.registerPayment({
  invoiceNumber: 'WEB-2026-128',
  amount: 19_470,
  method: 'bankkártya',
})

console.log(befizetes.outstanding)

Kérés

Egy vagy több befizetés, hozzáadás vagy felülírás, törlés és újrapróbálás.

Válasz

A RegisteredPayment mezői és a befizetésnél előforduló hibák.

Minta

Számla, részletfizetés és törlés a sandboxban, az elküldött XML-lel.

IPN fizetési értesítés

Webhook a Számlázz.hu kifizetési értesítéséhez, IP-ellenőrzéssel.

Befizetés pontosan egyszer#

Ha ugyanazt a befizetést több helyről is rögzítheted (banki értesítés, webhook, kézi egyeztetés), vagy egy hívás időtúllépéssel végződött, használd a registerPaymentOnce() metódust egy stabil kulccsal, például a banki tranzakció azonosítójával:

const eredmeny = await kassza.invoices.registerPaymentOnce({
  invoiceNumber: 'WEB-2026-128',
  key: 'BANK-20261008-4411',
  amount: 19_470,
  method: 'átutalás',
})

console.log(eredmeny.created)

A kassza a befizetés leírásába egy rövid jelölőt tesz ([kassza:BANK-20261008-4411]), és rögzítés előtt megnézi, van-e már ilyen jelölésű befizetés a számlán. Ha van, nem rögzít újra (created: false). Időtúllépés után ugyanígy visszakeres. A kulcs legfeljebb 48 karakter lehet, betűkből, számokból és _ . : - jelekből.