Adatok Oneclick fizetéshez - khpos/Payment-gateway_HU GitHub Wiki

A OneClick bővítmény a payment/status vagy oneclick/echo válaszon túl a OneClick Fizetési Sablonhoz kapcsolódó információt is megküldi a kereskedőnek. Amennyiben sikeresen megtörténik a OneClick Fizetési Sablon beállítását eredményező fizetési tranzakció hitelesítése, ez a bővítmény a részben maszkolt kártyaszámot és a lejárati dátumot is megküldi.

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

A bővítmény paraméter az in payment/status and oneclick/echo 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 maskClnRP bővítmény csak akkor kerül megküldésre a payment/status vagy oneclick/echo kérésre válaszként, amennyiben sikeresen megtörtént a OneClick Fizetési Sablon beállítását eredményező 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 maskClnRP.
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 a 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 maskClnRP bővítmény esetén

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

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

{
  "origPayId":"0e92dd54b133@HA",
  "dttm":"20220125131601",
  "resultCode": 0,
  "resultMessage":"OK",
  "signature":"base64-encoded-response-signature",
  "extensions": [
    {
      "extension": "maskClnRP",
      "dttm": "20220125131601",
      "maskedCln": "****0209",
      "expiration": "11/16",
      "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).

maskClnRP|20220125131601|****0209|11/16|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ó.**