Tranzakció inicializálása (Init)

Használja az inicializálás (Init) funkciót egy új fizetési tranzakció kezdeményezésére. Az inicializálás során a kereskedő oldala átadja a vásárló adatait rendszerünknek. Ennek hatására rendszerünk létrehoz egy új tranzakciós rekordot a kereskedőtől kapott adatok felhasználásával. Sikeres inicializálás esetén az új rekord mellett rendszerünk létrehoz egy új tranzakció azonosítót is (TransactionId), majd visszaadja ezt az azonosítót a kereskedő oldalának.


Az inicializálás során figyeljen a következőkre:

  • Tárolja le az Init kérésre visszaadott tranzakció azonosítót, mivel később ennek segítségével hivatkozhat az adott tranzakcióra.

  • Használjon “erős ügyfél-hitelesítést” (PSD2-SCA) a vásárló adatainak átadásához. Erről a következő oldalon olvashat részletesebben:


API kérés paraméterek

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

Művelet

HTTP kérés

Adatok


Init


POST

method=Init

json={JSON encode-olt paraméterek}



Az API kérésekhez kapcsolódó paramétereket két táblázatba soroljuk fel a könnyebb átláthatóság kedvéért. Természetesen az egyes paraméterek megjelenhetnek ugyanabban az API kérésben.

Az API paraméterek felosztása a következő:

  • kötelező paraméterek

  • opcionális paraméterek

araméter

Típus

Érték

Leírás

StoreName

string

A BIG FISH Payment Gateway szerződésben kerül meghatározásra.

Rendszerünkben tárolt egyedi bolt azonosító.

ProviderName

string

- Barion2

- Borgun (SecurePay)

- Borgun2 * (RPG)

- CIB

- FHB

- GP * (Global Payments)

- IPG (Intelligent Payments)

- KHB (K&H Bank)

- OTPSimple (SimplePay)

- PayPal

- PayPalRest

- PayU2 (Classic)

- PayURest *

- PSC (Paysafecard)

- Saferpay * (SIX Payment)

- UniCredit

- Wirecard *

A tranzakcióhoz kiválasztott fizetési szolgáltató.

(Egyes szolgáltatók kiegészítő technikai követelményekkel rendelkeznek. Ezeket a szolgáltatókat *-al jelöljük a táblázatban. A hozzájuk kapcsolódó kiegészítő lépésekről a táblázat alján talál hivatkozásokat.)

ResponseUrl

string

(255 karakter)

szabadon választható

Visszatérési URL: tranzakciót követően, rendszerünk erre a címre irányítja vissza a vásárlót.

Amount

number

szabadon választható

Bruttó végösszeg amit a vásárló kifizet.

(Magyar forint (HUF) esetén értéke egész szám.)

Tranzakció inicializálása Init kérés használatával:


curl --url 'https://system-test.paymentgat...' \

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

--user-agent 'Init | merchant-store.com | PHP | 7.3.0' \

--request 'POST' \

--data 'method=Init' \

--data 'json=

{

"StoreName":"sdk_test",

"ProviderName":"Borgun2",

"ResponseUrl":"https://demo.paymentgateway.hu...",

"Amount":100,

"Currency":"HUF",

"OrderId":"BF-TEST-ORDER",

"UserId":"BF-TEST-USER"

}'