Wise Reconcile

Fizetési addon

Ha az ügyfelek banki átutalással fizetnek egy Wise-számlára, a befizetést valakinek kézzel kell rögzítenie a WHMCS-ben: megkeresni a közleményben szereplő díjbekérőt, felvinni az összeget és a Wise utalási számát. A Wise Reconcile addon ezt a lépést automatizálja: a beérkező utalást a közlemény alapján a megfelelő díjbekérőhöz rendeli, és a befizetést ugyanúgy rögzíti, ahogyan kézzel tennéd.

Az addon a WHMCS saját API-ján rögzíti a befizetést a beállított fizetési mód alatt, és a WHMCS cron minden futása után is lefut. Azoknak a WHMCS-t használó szolgáltatóknak szól, akiknek az ügyfelei díjbekérő alapján, Wise üzleti számlára utalnak.

Hogyan működik

Két, egymást erősítő forrás. A Wise minden beérkező utalásról értesítő e-mailt küld, amelyből kiderül a befizető, az összeg, a közlemény és a Wise utalási száma. Mivel e-mailt bárki hamisíthat, csak érvényes, wise.com tartományú DKIM-aláírással fogadja el. A pénz tényleges beérkezését a Wise webhookja igazolja, amelyet az addon a Wise RSA-aláírásával ellenőriz. A webhook nem tartalmaz utalásazonosítót, ezért a kettőt pénznem, összeg és időpont alapján párosítja; ha a párosítás nem egyértelmű, a tételek ellenőrzésre kerülnek.

Párosítás a díjbekérő-számmal. A közleményből az addon szigorú szabállyal olvassa ki a díjbekérő számát: csak az önállóan álló szám számít, nem egy szó része, nem kezdődik nullával, és nem kapcsolódik másik számhoz, például dátumhoz. A befizetés automatikusan akkor kerül rögzítésre, ha pontosan egy díjbekérő szerepel, az kifizetetlen, azonos pénznemű, az összeg megegyezik a fizetendővel, és a Wise utalási száma még nincs a WHMCS-ben. Egy utalás több díjbekérőt is fedezhet, ha mindegyik ugyanahhoz az ügyfélhez tartozik, és az egyenlegük összege pontosan egyezik a kapott összeggel.

Kétféle beérkezési út. Az e-mail kétféleképpen juthat el az addonhoz. Exim levelezőszerveren egy cím közvetlenül az addon szkriptjébe továbbíthatja (pipe); ha az adatbázis átmenetileg nem érhető el, az Exim később újrapróbálja. Cloudflare Email Routing esetén egy Cloudflare Email Worker HTTPS-en, HMAC-aláírással küldi tovább a levelet változatlanul. Mindkét út ugyanazt az ellenőrzést és párosítást használja. A Wise a fiók bejelentkezési címére küldi az e-mailt, ezt egy levelezőszűrővel kell továbbítani a fogadó címre; a változatlan továbbítás megőrzi a DKIM-aláírást.

Nem egyező tételek. Minden, ami nem felel meg a szabályoknak, az addon oldalán az ellenőrzésre váró tételek közé kerül, az okkal együtt. Innen a tétel kézzel rögzíthető egy választott díjbekérőre (szükség esetén részfizetésként), párosítható egy adott webhookkal, újrapróbálható vagy figyelmen kívül hagyható. A dupla befizetést és a túlfizetést az addon soha nem rögzíti, adminisztrátori kérésre sem, mert a WHMCS a többletet ügyfélegyenlegként könyvelné. Ezeknél egy gomb a Wise visszatérítési oldalát nyitja meg az adott utalásra; magát a visszatérítést a Wise felületén kell jóváhagyni.

Fő funkciók

  • A Wise értesítő e-mailjének és webhookjának együttes ellenőrzése, DKIM- és RSA-aláírással.
  • Párosítás a közleményben szereplő díjbekérő-számmal, egy utalással több díjbekérőre is.
  • A befizetés rögzítése a Wise utalási számával; ugyanaz az utalás kétszer nem kerül rögzítésre, a kézzel felvitt befizetések sem.
  • Ellenőrzési sor az addon oldalán, a dupla befizetések és túlfizetések kiemelésével.
  • Kifizetések, például a Stripe utalásai, és megadott befizetők vagy közlemények automatikus figyelmen kívül hagyása.
  • Beállítható adatmegőrzés: a lezárt tételek nyers e-mail- és webhook-tartalma adott idő után törölhető, a párosítási nyilvántartás megmarad.

Amit nem tartalmaz

  • A visszatérítést nem tudja automatikusan elvégezni, mert a Wise API erre nem ad lehetőséget.
  • Jelenleg a magyar nyelvű Wise-értesítő mezőit ismeri fel; más nyelvű e-mailek feldolgozása még nincs megvalósítva.
  • Az ellenőrzésre váró tételekről nem küld e-mail-értesítést.
  • Bankszámlakivonat feltöltésével történő párosítás nincs benne.