Verifikáció inicializálása (Init)

Működés

Használja az inicializálás (Init) funkciót egy új bankkártya-verifikáció kezdeményezésére. Az inicializálás során a kereskedő oldala átadja a tranzakció és 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.

Verifikáció inicializálása során figyeljen a következőkre:

  • Ne adjon meg összeget az Init kérés indítása során.

  • Adja meg a kereskedő rendszerében tárolt, egyedi UserId paramétert (megadása fizetőeszköz-verifikációnál kötelező). Az egyes vásárlók az inicializálás során átadott UserId paraméter segítségével azonosíthatók be (egy vásárló akár több fizetőeszközt is regisztrálhat).

  • 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: Erős ügyfél-hitelesítés (PSD2/SCA)

  • 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.

Próbálja ki ezt a funkciót!

Az inicializációban a fizetési szolgáltatók nem vesznek részt, ez a folyamat kizárólag a kereskedő oldala és a BIG FISH Payment Gateway rendszere között zajlik.

Mobilalkalmazás fejlesztésnél biztosítsa, hogy az inicializációra a szerver oldalon kerüljön sor. Biztonsági okokból az inicializáció nem történhet meg a mobilalkalmazásban.

API kérés paraméterek

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

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

Kötelező paraméterek

Opcionális paraméterek

Mintakód

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

curl --url 'https://system-test.paymentgateway.hu/api/payment/' \
  --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":"GP",
        "ResponseUrl":"https://demo.paymentgateway.hu/response.php",
        "Currency":"HUF",
        "OrderId":"BF-TEST-CARD-VERIFICATION",
        "UserId":"BF-TEST-CARD-VERIFICATION",
        "PaymentRegistration":true,
        "PaymentRegistrationType":"CIT"
    }'

API válasz paraméterek

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

Mintakód

Sikeres verifikáció inicializálásra adott válasz:

{
    "TransactionId": "992c8e75435e6d4dfdf6415f0714cae8",
    "ResultCode": "SUCCESSFUL",
    "ResultMessage": null,
    "ResponseId": "3202109280600047723"
}

Last updated