LogoLogo
ENG
  • A dokumentáció megújult
  • Általános információk
    • Dokumentáció ismertető
    • Hitelesítés és kapcsolódás
      • Hitelesítési adatok előkészítése
      • Kapcsolódás a tesztrendszerhez
      • Kapcsolódás az éles rendszerhez
      • Titkosítás és IP címek
  • Egyszeri fizetések (One-time payment)
    • Általános ismertető
    • Bankkártya és mobiltárca
      • Azonnali terhelés
        • Fizetési folyamat
        • Tranzakció inicializálása (Init)
        • Erős ügyfél-hitelesítés (PSD2/SCA)
          • Vásárlói adatok
            • Általános vásárlói adatok
            • Bolt specifikus adatok
            • Böngésző adatok
          • Rendelési adatok
            • Általános rendelési adatok
            • Számlázási adatok
            • Szállítási adatok
            • Termékadatok
        • Visszairányítási módok
        • Tranzakció indítása (Start)
        • URL Értesítés
        • Tranzakció eredményének lekérdezése (Result)
        • Tranzakció részletes adatainak lekérdezése (Details)
        • Tranzakció összegének visszatérítése (Refund)
      • Későbbi terhelés (kétlépcsős fizetés)
        • Fizetési folyamat
        • Kétlépcsős tranzakció inicializálása (Init)
        • Erős ügyfél-hitelesítés (PSD2/SCA)
          • Vásárlói adatok
            • Általános vásárlói adatok
            • Bolt specifikus adatok
            • Böngésző adatok
          • Rendelési adatok
            • Általános rendelési adatok
            • Számlázási adatok
            • Szállítási adatok
            • Termékadatok
        • Visszairányítási módok
        • Tranzakció indítása (Start)
        • URL Értesítés
        • Tranzakció eredményének lekérdezése (Result)
        • Tranzakció részletes adatainak lekérdezése (Details)
        • Kétlépcsős tranzakció lezárása (Close)
        • Tranzakció összegének visszatérítése (Refund)
    • SZÉP Kártya
      • Fizetési folyamat
      • Tranzakció inicializálása (Init)
        • K&H specifikus paraméterek
          • K&H Extra paraméterek
        • MBH specifikus paraméterek
        • OTP specifikus paraméterek
      • Visszairányítási módok
      • Tranzakció indítása (Start)
      • URL Értesítés
      • Tranzakció eredményének lekérdezése (Result)
      • Tranzakció részletes adatainak lekérdezése (Details)
      • Tranzakció összegének visszatérítése (PayRefund)
        • Visszatérítési igény beküldése (Refund)
          • MBH SZÉP Kártya sztornó
        • Visszatérítési igény lekérdezése (SettlementRefund)
          • Köteg (Batches) és tétel (Items) adatok visszatérítéseknél
    • Online áruhitel
      • Fizetési folyamat
      • Tranzakció inicializálása (Init)
        • MBH Online Áruhitel specifikus paraméterek
        • OTP Áruhitel specifikus paraméterek
      • Tranzakció indítása (Start)
      • URL Értesítés
      • Tranzakció eredményének lekérdezése (Result)
      • Tranzakció részletes adatainak lekérdezése (Details)
    • Átutalás
      • Fizetési folyamat
      • Tranzakció inicializálása (Init)
        • Worldline - Saferpay specifikus paraméterek
      • Visszairányítási módok
      • Tranzakció indítása (Start)
      • URL Értesítés
      • Tranzakció eredményének lekérdezése (Result)
      • Tranzakció részletes adatainak lekérdezése (Details)
      • Tranzakció összegének visszatérítése (Refund)
      • Tranzakció érvénytelenítése (Cancel)
  • egykattintásos fizetés (one-click payment)
    • Általános CIT ismertető
    • Bankkártya és mobiltárca
      • Azonnali terhelés
        • Fizetés fizetőeszköz-regisztrációval
          • Fizetési folyamat (fizetőeszköz-regisztrációhoz)
          • Tranzakció inicializálása (Init) (fizetőeszköz-regisztrációhoz)
          • Erős ügyfél-hitelesítés (PSD2/SCA)
            • Vásárlói adatok
              • Általános vásárlói adatok
              • Bolt specifikus adatok
              • Böngésző adatok
            • Rendelési adatok
              • Általános rendelési adatok
              • Számlázási adatok
              • Szállítási adatok
              • Termékadatok
          • Visszairányítási módok
          • Tranzakció indítása fizetőeszköz-regisztráció befejezéséhez (Start)
          • URL Értesítés
          • Tranzakció eredményének lekérdezése (Result)
          • Tranzakció részletes adatainak lekérdezése (Details)
          • Tranzakció összegének visszatérítése (Refund)
        • Rákövetkező fizetés regisztrált fizetőeszközzel
          • Fizetési folyamat (rákövetkező fizetés)
          • Tranzakció inicializálása (Init) (regisztrált fizetőeszközzel)
          • Erős ügyfél-hitelesítés (PSD2/SCA)
            • Vásárlói adatok
              • Általános vásárlói adatok
              • Bolt specifikus adatok
              • Böngésző adatok
            • Rendelési adatok
              • Általános rendelési adatok
              • Számlázási adatok
              • Szállítási adatok
              • Termékadatok
          • Visszairányítási módok
          • Tranzakció indítása regisztrált fizetőeszközzel (Start)
          • URL Értesítés
          • Tranzakció eredményének lekérdezése (Result)
          • Tranzakció részletes adatainak lekérdezése (Details)
          • Tranzakció összegének visszatérítése (Refund)
      • Későbbi terhelés (kétlépcsős fizetés)
        • Fizetés fizetőeszköz-regisztrációval
          • Fizetési folyamat (fizetőeszköz-regisztrációhoz)
          • Tranzakció inicializálása (Init) (fizetőeszköz-regisztrációhoz)
          • Erős ügyfél-hitelesítés (PSD2/SCA)
            • Vásárlói adatok
              • Általános vásárlói adatok
              • Bolt specifikus adatok
              • Böngésző adatok
            • Rendelési adatok
              • Általános rendelési adatok
              • Számlázási adatok
              • Szállítási adatok
              • Termékadatok
          • Visszairányítási módok
          • Tranzakció indítása fizetőeszköz-regisztráció befejezéséhez (Start)
          • URL Értesítés
          • Tranzakció eredményének lekérdezése (Result)
          • Tranzakció részletes adatainak lekérdezése (Details)
          • Kétlépcsős tranzakció lezárása (Close)
          • Tranzakció összegének visszatérítése (Refund)
        • Rákövetkező fizetés regisztrált fizetőeszközzel
          • Fizetési folyamat (rákövetkező fizetés)
          • Tranzakció inicializálása (Init) (regisztrált fizetőeszközzel)
          • Erős ügyfél-hitelesítés (PSD2/SCA)
            • Vásárlói adatok
              • Általános vásárlói adatok
              • Bolt specifikus adatok
              • Böngésző adatok
            • Rendelési adatok
              • Általános rendelési adatok
              • Számlázási adatok
              • Szállítási adatok
              • Termékadatok
          • Visszairányítási módok
          • Tranzakció indítása regisztrált fizetőeszközzel (Start)
          • URL Értesítés
          • Tranzakció eredményének lekérdezése (Result)
          • Tranzakció részletes adatainak lekérdezése (Details)
          • Kétlépcsős tranzakció lezárása (Close)
          • Tranzakció összegének visszatérítése (Refund)
    • SZÉP Kártya
      • Fizetés fizetőeszköz-regisztrációval
        • Fizetési folyamat (fizetőeszköz-regisztrációhoz)
        • Tranzakció inicializálása (Init) (fizetőeszköz-regisztrációhoz)
        • Visszairányítási módok
        • Tranzakció indítása fizetőeszköz-regisztráció befejezéséhez (Start)
        • URL Értesítés
        • Tranzakció eredményének lekérdezése (Result)
        • Tranzakció részletes adatainak lekérdezése (Details)
        • Tranzakció összegének visszatérítése (PayRefund)
          • Visszatérítési igény beküldése (Refund)
            • MBH SZÉP Kártya sztornó
          • Visszatérítési igény lekérdezése (SettlementRefund)
            • Köteg (Batches) és tétel (Items) adatok visszatérítéseknél
      • Rákövetkező fizetés regisztrált fizetőeszközzel
        • Fizetési folyamat (rákövetkező fizetés)
        • Tranzakció inicializálása (Init) (regisztrált fizetőeszközzel)
        • Visszairányítási módok
        • Tranzakció indítása regisztrált fizetőeszközzel (Start)
        • URL Értesítés
        • Tranzakció eredményének lekérdezése (Result)
        • Tranzakció részletes adatainak lekérdezése (Details)
        • Tranzakció összegének visszatérítése (PayRefund)
          • Visszatérítési igény beküldése (Refund)
            • MBH SZÉP Kártya sztornó
          • Visszatérítési igény lekérdezése (SettlementRefund)
            • Köteg (Batches) és tétel (Items) adatok visszatérítéseknél
    • Átutalás (tájékoztató)
    • Regisztrált fizetőeszköz kezelése
      • Fizetőeszköz-regisztráció lekérdezése
      • Fizetőeszköz-regisztráció érvénytelenítése
      • Az összes fizetőeszköz-regisztráció érvénytelenítése
  • ismétlődő fizetés (recurring payment)
    • Általános MIT ismertető
      • MIT fizetéstípusok
    • Bankkártya és mobiltárca
      • Azonnali terhelés
        • Fizetés fizetőeszköz-regisztrációval
          • Fizetési folyamat (fizetőeszköz-regisztrációhoz)
          • Tranzakció inicializálása (Init) (fizetőeszköz-regisztrációhoz)
          • Erős ügyfél-hitelesítés (PSD2/SCA)
            • Vásárlói adatok
              • Általános vásárlói adatok
              • Bolt specifikus adatok
              • Böngésző adatok
            • Rendelési adatok
              • Általános rendelési adatok
              • Számlázási adatok
              • Szállítási adatok
              • Termékadatok
              • MIT fizetéstípus adatok
          • Visszairányítási módok
          • Tranzakció indítása fizetőeszköz-regisztráció befejezéséhez (Start)
          • URL Értesítés
          • Tranzakció eredményének lekérdezése (Result)
          • Tranzakció részletes adatainak lekérdezése (Details)
          • Tranzakció összegének visszatérítése (Refund)
        • Rákövetkező fizetés regisztrált fizetőeszközzel
          • Fizetési folyamat (rákövetkező fizetés)
          • Tranzakció inicializálása (InitRP) (regisztrált fizetőeszközzel)
          • Erős ügyfél-hitelesítés (PSD2/SCA)
            • Vásárlói adatok
              • Általános vásárlói adatok
              • Bolt specifikus adatok
              • Böngésző adatok
            • Rendelési adatok
              • Általános rendelési adatok
              • Számlázási adatok
              • Szállítási adatok
              • Termékadatok
          • Tranzakció indítása regisztrált fizetőeszközzel (StartRP)
          • URL Értesítés
          • Tranzakció eredményének lekérdezése (Result)
          • Tranzakció részletes adatainak lekérdezése (Details)
          • Tranzakció összegének visszatérítése (Refund)
      • Későbbi terhelés (kétlépcsős fizetés)
        • Fizetés fizetőeszköz-regisztrációval
          • Fizetési folyamat (fizetőeszköz-regisztrációhoz)
          • Tranzakció inicializálása (Init) (fizetőeszköz-regisztrációhoz)
          • Erős ügyfél-hitelesítés (PSD2/SCA)
            • Vásárlói adatok
              • Általános vásárlói adatok
              • Bolt specifikus adatok
              • Böngésző adatok
            • Rendelési adatok
              • Általános rendelési adatok
              • Számlázási adatok
              • Szállítási adatok
              • Termékadatok
              • MIT fizetéstípus adatok
          • Visszairányítási módok
          • Tranzakció indítása fizetőeszköz-regisztráció befejezéséhez (Start)
          • URL Értesítés
          • Tranzakció eredményének lekérdezése (Result)
          • Tranzakció részletes adatainak lekérdezése (Details)
          • Kétlépcsős tranzakció lezárása (Close)
          • Tranzakció összegének visszatérítése (Refund)
        • Rákövetkező fizetés regisztrált fizetőeszközzel
          • Fizetési folyamat (rákövetkező fizetés)
          • Tranzakció inicializálása (InitRP) (regisztrált fizetőeszközzel)
          • Erős ügyfél-hitelesítés (PSD2/SCA)
            • Vásárlói adatok
              • Általános vásárlói adatok
              • Bolt specifikus adatok
              • Böngésző adatok
            • Rendelési adatok
              • Általános rendelési adatok
              • Számlázási adatok
              • Szállítási adatok
              • Termékadatok
          • Tranzakció indítása regisztrált fizetőeszközzel (StartRP)
          • URL Értesítés
          • Tranzakció eredményének lekérdezése (Result)
          • Tranzakció részletes adatainak lekérdezése (Details)
          • Kétlépcsős tranzakció lezárása (Close)
          • Tranzakció összegének visszatérítése (Refund)
    • Átutalás (tájékoztató)
    • Regisztrált fizetőeszköz kezelése
      • Fizetőeszköz-regisztráció lekérdezése
      • Fizetőeszköz-regisztráció érvénytelenítése
      • Az összes fizetőeszköz-regisztráció érvénytelenítése
  • fizetőeszköz-verifikáció
    • Általános ismertető
    • Bankkártya és mobiltárca
      • Verifikációs folyamat (fizetőeszköz-regisztrációhoz)
      • Verifikáció inicializálása (Init)
      • Erős ügyfél-hitelesítés (PSD2/SCA)
        • Vásárlói adatok
          • Általános vásárlói adatok
          • Bolt specifikus adatok
          • Böngésző adatok
        • Rendelési adatok
          • Általános rendelési adatok
          • Számlázási adatok
          • Szállítási adatok
          • Termékadatok
          • MIT fizetéstípus adatok
      • Visszairányítási módok
      • Tranzakció indítása verifikáció befejezéséhez (Start)
      • URL Értesítés
      • Verifikáció eredményének lekérdezése (Result)
      • Verifikáció részletes adatainak lekérdezése (Details)
    • Regisztrált fizetőeszköz kezelése
      • Fizetőeszköz-regisztráció lekérdezése
      • Fizetőeszköz-regisztráció érvénytelenítése
      • Az összes fizetőeszköz-regisztráció érvénytelenítése
  • Kiegészítő szolgáltatások
    • Általános ismertető
    • Fizetési rendszerhiba riasztás (PayAlert)
      • Kritikus hiba a terminálon
      • Nincs sikeres tranzakció
      • Magas a “megválaszolhatatlan” állapotú tranzakciók aránya
      • Magas a nem sikeres státuszú tranzakciók aránya egy adott fizetési szolgáltatónál
    • Elektronikus számlázás (PayBill)
    • Könyvelés támogatás és tranzakciók pénzügyi elszámolása (PayBook)
      • Köteg (Batches) és tétel (Items) adatok
    • Fizetési hivatkozás (PayLink)
      • Fizetési hivatkozás létrehozása
      • Fizetési hivatkozás részletes adatainak lekérdezése
      • Fizetési hivatkozás érvénytelenítése
    • Kifizetés (PayOut)
    • SZÉP Kártya visszatérítések (PayRefund)
      • Visszatérítési igény beküldése (Refund)
        • MBH SZÉP Kártya sztornó
      • Visszatérítési igény lekérdezése (SettlementRefund)
        • Köteg (Batches) és tétel (Items) adatok visszatérítéseknél
  • Segédlet
    • Általános ismertető
    • Tranzakció státuszok
    • Tranzakció állapotok
    • Erős ügyfél-hitelesítés (PSD2/SCA)
      • Vásárlói adatok
        • Általános vásárlói adatok
        • Bolt specifikus adatok
        • Böngésző adatok
      • Rendelési adatok
        • Általános rendelési adatok
        • Számlázási adatok
        • Szállítási adatok
        • Termékadatok
        • MIT fizetéstípus adatok
    • Visszairányítási módok
    • Extra paraméter szabályok
    • Fizetési szolgáltató specifikus adatok
      • Barion Smart Gateway
        • Extra paraméterek
      • CIB Bank
      • Global Payments
        • Extra paraméterek
      • K&H Bank
        • Extra paraméterek
        • Bankkártya regisztráció visszavonása
      • K&H SZÉP Kártya
        • Extra paraméterek
      • MBH Online Áruhitel
        • Extra paraméterek
      • MBH SZÉP Kártya
        • Extra paraméterek
      • OTP Bank Áruhitel
        • Extra paraméterek
      • OTP SZÉP Kártya
        • Extra paraméterek
      • PayPal REST
        • Extra paraméterek
      • Paysafecard
      • Paysafecash
      • PayU Classic
      • PayU REST
        • Egyedi fizetési felület
        • Extra paraméterek
      • RaiffeisenPay
        • Extra paraméterek
      • SimplePay
        • Bankkártya regisztráció
        • Deeplink létrehozása qvik azonnali átutaláshoz (EAM)
        • Extra paraméterek
      • SimplePay Instant Transfer
      • Stripe
        • Extra paraméterek
      • Teya RPG
        • Egyedi fizetési felület
        • Tranzakciók pénzügyi beazonosítása könyveléshez
      • Teya SecurePay
      • UniCredit Bank
      • Viva Wallet
        • Extra paraméterek
      • Worldline - Saferpay
        • Extra paraméterek
    • Fizetés integrációja mobilalkalmazásba
      • Tranzakció indítás hagyományos módon
      • Tranzakció indítása módosított visszairányítással
    • Változásnapló
Powered by GitBook
On this page
  • Működés
  • API kérés paraméterek
  • Terhelés
  • Részterhelés
  • Feloldás
  • API válasz paraméterek

Was this helpful?

  1. egykattintásos fizetés (one-click payment)
  2. Bankkártya és mobiltárca
  3. Későbbi terhelés (kétlépcsős fizetés)
  4. Rákövetkező fizetés regisztrált fizetőeszközzel

Kétlépcsős tranzakció lezárása (Close)

PreviousTranzakció részletes adatainak lekérdezése (Details)NextTranzakció összegének visszatérítése (Refund)

Last updated 9 days ago

Was this helpful?

Működés

Használja a Close hívást egy kétlépcsős tranzakció lezárásához. A Close segítségével jelezheti a fizetési szolgáltató számára, hogy a vásárló számláján korábban befoglalt összeget teljes egészében megterhelje, részben terhelje meg vagy szabadítsa fel.

API kérés paraméterek

Az API kérés általános információi

Művelet
HTTP kérés
Adatok

Close

POST

method=Close json={JSON encode-olt paraméterek}

Terhelés

Teljes összeg terhelésére a Close hívás során két lehetőség van (elég csupán az egyiket alkalmazni):

  • a hívás során ne adja át az ApprovedAmount paramétert

  • amennyiben mégis átadja az ApprovedAmount paramétert, annak értéke legyen 0

Mindkét eljárás jelzi a fizetési szolgáltató számára, hogy a korábban befoglalt teljes összeggel terhelje meg a vásárló számláját.

Részterhelés

Részösszeg terheléséhez, a Close hívás során adja át a terhelni kívánt részösszeget az ApprovedAmount paraméterben. Ilyen esetben kizárólag az ApprovedAmount-ban megadott részösszeg kerül terhelésre. Az eredetileg befoglalt összeg és a részösszeg közötti különbözet automatikusan feloldásra kerül a vásárló számláján (többszörös, egymást követő részösszeg terhelésre ezért nincs lehetőség).

Részösszeg terhelését csak bizonyos fizetési szolgáltatók támogatják. Ez a funkció jelenleg a következő szolgáltatóknál érhető el:

  • Barion Smart Gateway

  • Global Payments

  • K&H Bank

  • PayPal REST

  • SimplePay

  • UniCredit

  • Wordline - Saferpay

Feloldás

Foglalás feloldásához, a Close hívás során adja át az Approved paramétert, melynek értéke legyen "false". Ennek hatására a fizetési szolgáltató feloldja a teljes korábban befoglalt összeget a vásárló számláján (ezért részösszeg feloldására nincs lehetőség).

API kérés paraméterek

A Close kérés paraméterei közül a TransactionId átadása kötelező:

Paraméter
Típus
Érték
Leírás

TransactionId

string (32 karakter)

32 karakter hosszú md5 hash

A tranzakció azonosítója a Nevogate rendszerében.

Approved

string

  • “true” (alapért.)

  • “false”

Jelzi a befoglalt összeg terhelését vagy feloldását.

  • “true” esetén a fizetési szolgáltató ténylegesen megterheli a korábban befoglalt összeget (vagy részösszeget) a vásárló számláján

  • “false” esetén a fizetési szolgáltató feloldja a korábban befoglalt teljes összeget a vásárló számláján

ApprovedAmount

number

szabadon választható

(de legfeljebb az eredeti tranzakció összege)

Jelzi a terhelni kívánt részösszeg mértékét.

Ha ez a paraméter nem kerül átadásra, vagy az átadott értéke “0”, akkor a fizetési szolgáltató a teljes korábban befoglalt összeggel terheli meg a vásárló számláját.

(Amennyiben az Approved paraméter átadása ”false” értékkel történik, úgy az ApprovedAmount paraméterben átadott érték nem lesz figyelembe véve és a teljes összeg feloldásra kerül a vásárló számláján.)

Mintakód

Kétlépcsős tranzakció lezárása Close használatával:

curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --user 'sdk_test:86af3-80e4f-f8228-9498f-910ad' \
  --user-agent 'Close | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Close' \
  --data 'json=
    {
        "TransactionId":"a4d6f6f27f2116da21da62d705dbd7ef",
        "Approved":"true"
    }'

API válasz paraméterek

A Close kérés eredményét JSON formában válaszoljuk meg. A válasz a következő paramétereket tartalmazza:

Paraméter
Típus
Érték
Leírás

TransactionId

string (32 karakter)

32 karakter hosszú md5 hash

A tranzakció azonosítója a Nevogate rendszerében.

ResultCode

string

Az eredménykód a következők egyike lehet:

  • SUCCESSFUL

Hiba esetén a következő eredménykódok jelölik a hiba okát a Nevogate rendszerében:

  • InactiveStore

  • InactiveProvider

  • MissingParameter

  • MissingRemoteAddress

  • UnauthorizedAccess

  • UnauthorizedRemoteAddress

  • UnknownStore

  • UnknownTransaction

  • WrongApike

  • WrongParameter

(Továbbá a szolgáltatókra vonatkozó specifikus eredménykódok is megjelenhetnek itt.)

Jelzi a végleges terhelés, vagy a befoglalt összeg feloldásának eredményét.

  • SUCCESSFUL: a befoglalt összeg végleges terhelése, részterhelése vagy feloldása sikeres.

ResultMessage

string

leírás

Az egyes ResultCode értékek szöveges magyarázata, hibaüzenet esetén.

Approved

boolean

  • true

  • false

Az Close hívás során megadott Approved paraméter értéke.

ApprovedAmount

number

értékét rendszerünk adja vissza

A terhelt összeg vagy részösszeg.

(Maximum értéke az előzetesen befoglalt összeg.)

ReservedAmount

number

vásárlás során kerül meghatározásra

A vásárlás során eredetileg befoglalt összeg.

ResponseId

integer

egyedi értékek

A válaszüzenet egyedi azonosítója a Nevogate rendszerében.

Mintakód

A fenti Close kérésre adott sikeres válasz:

{
    "TransactionId": "a4d6f6f27f2116da21da62d705dbd7ef",
    "ResultCode": "SUCCESSFUL",
    "Approved": true,
    "ApprovedAmount": 100,
    "ReservedAmount": 100,
    "ResultMessage": null,
    "ResponseId": "3202109280600047705"
}
Próbálja ki ezt a funkciót!