Tranzakció indítása regisztrált fizetőeszközzel (StartRP)

Működés

A rákövetkező tranzakció befejezéséhez a sikeres inicializáció után egy sikeres tranzakció indítás szükséges. Ebben az esetben használja a StartRP hívást a tranzakció indításához.

Rákövetkező fizetések esetén a tranzakció eredményét a StartRP hívás adja vissza, ezért itt nincs szükség Result hívás indítására.

Amennyiben a StartRP hívásra visszaadott válaszban a tranzakció státusza még PENDING, abban az esetben a kereskedő rendszerét a megadott ResponseUrl és NotificationUrl címeken értesítjük, amint rendszerünk megkapta a fizetési szolgáltatótól a tranzakció végstátuszát. Ebben az esetben szükséges a Result hívás indítása a kereskedő rendszeréből.

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

API kérés paraméterek

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

Művelet	HTTP kérés	Adatok
StartRP	POST	method=StartRP json={JSON encode-olt paraméterek}

Az API kérés paramétere

Paraméter	Típus	Érték	Leírás
TransactionId	string	32 karakter hosszú md5 hash	A tranzakció azonosítója, melyet az InitRP hívás során generál a BIG FISH Payment Gateway rendszere.

Mintakód

Rákövetkező tranzakció indítása referencia tranzakció segítségével, StartRP 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 'StartRP | merchant-store.com | PHP | 7.3.0' \
  --request 'POST' \
  --data 'method=StartRP' \
  --data 'json=
    {
        "TransactionId":"90866b50774d8341be49c1aea1ede5a6"
    }'

API válasz paraméterek

A StartRP 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
StoreName	string	egyedi értékek	Rendszerünkben tárolt egyedi boltazonosító.
ProviderName	string	egyedi értékek	A tranzakcióhoz kiválasztott fizetési szolgáltató.
TransactionId	string	32 karakter hosszú md5 hash	A tranzakció azonosítója a BIG FISH Payment Gateway rendszerében.
ResultCode	string	A tranzakció státusza lehet: SUCCESSFUL PENDING ERROR TIMEOUT Hiba esetén a következő eredménykódok jelölik a hiba okát: InactiveStore InactiveProvider MissingParameter MissingRemoteAddress UnauthorizedAccess UnauthorizedRemoteAddress UnknownReferenceTransaction UnknownStore UnknownTransaction WrongApikey WrongReferenceTransactionStatus WrongTransactionStatus	Jelzi a tranzakció eredményét. A tranzakció státuszokról a következő oldalon olvashat további információkat: Tranzakció státuszok Sikertelen inicializálás esetén jelzi a hiba okát.
ResultMessage	string	leírás	Az egyes ResultCode értékek szöveges magyarázata.
Anum	string	egyedi értékek	A tranzakció engedélyszáma a fizetési szolgáltató rendszerében. (Csak bizonyos szolgáltatók esetén.)
Amount	number	egyedi értékek	A tranzakció bruttó végösszege. (Az összeg amit a vásárló kifizetett.)
Currency	string (3 karakter)	HUF EUR USD ...	A tranzakció devizaneme. (Értékei fizetési szolgáltatónként és szerződésenként eltérőek lehetnek.)
OrderId	string	egyedi értékek	A megrendelés azonosítója a kereskedő áruházában. (Az inicializáció során átadott OrderId.)
UserId	string	szabadon választható (kivéve e-mail címek és személyes adatok)	A vásárló azonosítója a kereskedő áruházában. (Az inicializáció során átadott UserId.)
Language	string (2 karakter)	HU (alapért.) EN DE ...	A fizetési felület nyelve.
ProviderTransactionId	string	egyedi értékek	A tranzakció azonosítója a fizetési szolgáltató rendszerében.
AutoCommit	string	“true” “false”	Jelzi, hogy a bank azonnal vagy később hajtja végre a tranzakciót. (Az inicializáció során beállított AutoCommit értéke.)
CommitState	string	PENDING APPROVED DECLINED	Kétlépcsős tranzakció esetén jelzi a tranzakciós összeg állapotát. • PENDING: az összeg zárolásra került, de még terhelésre vár (tranzakció lezárással) • APPROVED: a végleges összeg beterhelése megtörtént • DECLINED: a zárolt összeg feloldásra került (nem történt terhelés)
PaywallPaymentName	string (36 karakter)	null UUID	A tranzakció PayWall azonosítója (kizárólag a PayWall segítségével indított fizetések esetén).
PaywallRecurringPaymentEnabled	string	"true" "false"	Jelzi a vásárló hozzájárulását, hogy a kereskedő a jövőben az adott tranzakcióra hivatkozva újabb, ismétlődő tranzakciókat indíthasson (kizárólag a PayWall segítségével indított fizetések esetén).
PaymentRegistrationType	string	MIT	Jelzi a fizetőeszköz regisztráció típusát.
SzepPocket	string	null	A paraméter ismétlődő fizetések esetén nincs használatban.
ProviderResultCode	string	egyedi értékek, melyek csak az alábbi fizetési szolgáltatóktól származhatnak (szolgáltató és hozzá tartozó kód párosként felsorolva): Barion2 (ErrorCode) Borgun2 (ActionCode) GP (PRCODE) KHB (paymentStatus) OTPSimple (resultCode / errorCodes) PayURest (cardResponseCode) Saferpay (ErrorName)	A fizetési szolgáltató rendszeréből származó elsődleges eredmény- vagy hibakód.
ProviderResultCode2	string	egyedi értékek, melyek csak az alábbi fizetési szolgáltatóktól származhatnak (szolgáltató és hozzá tartozó kód párosként felsorolva): GP (SRCODE) Saferpay (ProcessorResult)	A fizetési szolgáltató rendszeréből származó másodlagos eredmény- vagy hibakód.
Created	string	dátum	A tranzakció létrehozásának dátuma.
ResponseId	integer	egyedi értékek	A válaszüzenet egyedi azonosítója a BIG FISH Payment Gateway rendszerében.

Mintakód

Sikeres rákövetkező tranzakció indítására adott válasz:

{
    "StoreName": "sdk_test",
    "ProviderName": "OTPSimple",
    "TransactionId":"90866b50774d8341be49c1aea1ede5a6",
    "ResultCode":"SUCCESSFUL",
    "ResultMessage":"Sikeres tranzakció",
    "Anum":"",
    "Amount": "200",
    "Currency": "HUF",
    "OrderId":"BF-TEST-ORDER-REG",
    "UserId":"BF-TEST-USER-REG",
    "Language": "HU",
    "ProviderTransactionId":"99104804",
    "AutoCommit":"true",
    "CommitState":"APPROVED",
    "PaywallPaymentName": null,
    "PaywallRecurringPaymentEnabled": "false",
    "PaymentRegistrationType": "MIT",
    "SzepPocket": null,
    "ProviderResultCode": "000",
    "ProviderResultCode2": null,
    "Created": "2020-03-14 11:19:07",
    "ResponseId": "3202109280600047719"
}