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
      • SimplePay RTP
        • Extra paraméterek
      • 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
  • A StoreName és ApiKey páros előkészítése
  • A UserAgent adatok előkészítése
  • Mintakódok és válaszok

Was this helpful?

  1. Általános információk
  2. Hitelesítés és kapcsolódás

Hitelesítési adatok előkészítése

Rendszerünk minden API hívást hitelesít a végrehajtás előtt. A kereskedő beazonosítására HTTP alapszintű hitelesítést használunk (HTTP Basic). A sikeres hitelesítéshez készítse elő a következő adatokat:

  • StoreName és ApiKey páros

  • UserAgent adatok

A StoreName és ApiKey páros előkészítése

  1. Kettősponttal kapcsolja össze a StoreName és ApiKey párost,

  2. kódolja az így keletkezett párost Base64 kódolás segítségével,

  3. helyezze el a kódot a HTTP kérés fejlécében (HTTP request header).

Példa StoreName és ApiKey párosra

Művelet
Eredmény

StoreName érték

sdk_test

ApiKey érték

86af3-80e4f-f8228-9498f-910ad

Kettősponttal összekapcsolt páros

sdk_test:86af3-80e4f-f8228-9498f-910ad

Az összekapcsolt páros Base64 kódolás után

c2RrX3Rlc3Q6ODZhZjMtODBlNGYtZjgyMjgtOTQ5OGYtOTEwYWQ=

Az így keletkezett HTTP kérés fejléce

authorization: Basic c2RrX3Rlc3Q6ODZhZjMtODBlNGYtZjgyMjgtOTQ5OGYtOTEwYWQ=

A UserAgent adatok előkészítése

Minden API hívás esetén adja át UserAgent adatait, amit a következő elemekből állíthat össze:

  • Hívott metódus neve

  • Indított API kérés domain neve vagy IP címe

  • Programozási nyelv neve

  • Programozási nyelv verziószáma

Példa UserAgent adatokra

Providers | merchant-store.com | PHP | 7.3.0

Mintakódok és válaszok

Mintakódok a hitelesítéshez

curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --header 'authorization: Basic c2RrX3Rlc3Q6ODZhZjMtODBlNGYtZjgyMjgtOTQ5OGYtOTEwYWQ=' \
  --user-agent 'Providers | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=Providers' \
  --data 'json=
    {
      "StoreName":"sdk_test"
    }'

vagy

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

A fenti kérésekre adott válasz

{
    "Data": [
        {
            "provider_name": "CIB",
            "provider_long_name": "CIB Bank"
        },
        {
            "provider_name": "OTP",
            "provider_long_name": "OTP Bank"
        },
        ...
    ],
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "ResponseId": "3202109280600047702"
}
PreviousHitelesítés és kapcsolódásNextKapcsolódás a tesztrendszerhez

Last updated 1 year ago

Was this helpful?