Adatok egyszerű fizetéshez - khpos/Payment-gateway_HU GitHub Wiki

Ez a bővítmény az engedélyezett (authorizált) fizetési tranzakciókhoz kapcsolódóan a payment/status az eredményen kívül további információkat is küld a kereskedőnek. A fizetési tranzakció sikeres engedélyezése után a bővítmény megküldi a részben kitakart kártyaszámot és a lejárati dátumot.

Ez a bővítmény része az alapcsomagnak.

A bővítmény paraméter az in payment/status válaszban

Az extensions újonnan hozzáadott paraméter, amely tartalmazza az adott művelethez aktivált bővítmények teljes listáját. A maskCln bővítmény csak akkor kerül megküldésre a payment/status kérésre válaszként, amennyiben sikeresen megtörtént a fizetési tranzakció hitelesítése.

A maskCln bővítmény paramétereinek leírása

A félkövér betűkkel írt paramétereket a rendszer mindig megküldi.

Adat	Típus	Leírás
extension	String	Bővítmény ID (fizetőoldal rendeli hozzá). Ennél a bővítménynél mindig maskCln.
dttm	String	Válasz dátuma és időpontja (YYYYMMDDHHMMSS formátumban).
maskedCln	String	Részben kitakart rövid kártyaszám ****XXXX, ahol XXXX kártyaszám négy utolsó számjegye.
expiration	String	Kártya lejárati dátuma (MM/YY).
longMaskedCln	String	Részben kitakart hosszú kártyaszám PPPPPP****XXXX, ahol PPPPPP a kártyaszám első hat számjegye XXXX pedig az utolsó négy számjegye.
signature	String	Bővítmény aláírása, BASE64 kódolással.

Példa arra, hogy a payment/status kérésre milyen választ küld a rendszer a maskCln bővítmény esetén

{
  "dttm": "20220125131601",
  "payId": "ff41e84b7e33@HA",
  "resultCode": 0,
  "resultMessage": "OK",
  "paymentStatus": 7,
  "authCode": "453708",
  "signature": "base64-encoded-response-signature",
  "extensions": [
    {
     "extension": "maskCln",
      "dttm": "20220125131601",
      "maskedCln": "****0209",
      "expiration": "11/23",
      "longMaskedCln": "415461****0209",
      "signature": "base64-encoded-extension-signature"
    }
  ]
}

A titkosított aláírás kódolása azon a paraméterláncon alapul, amelyben a paraméterek pontosan a specifikációban szereplő sorrendben követik egymást (lásd fenn).

maskCln|20220125131601|****0209|11/23|415461****0209

Megjegyzés: Az alapvető paramétereknél az aláírást tekintve nincs változás. Az extensions elem nem befolyásolja a payment/status válasz kódolását. Minden bővítményhez külön aláírás tartozik.

** A bővítmény aláírásához és annak validálásához egyaránt az SHA256withRSA algoritmus használandó.**