Data o kartě pro OneClick platbu - csob/platebnibrana GitHub Wiki

Toto rozšíření (extension) předává v operaci payment/status nebo v operaci oneclick/echo údaje o prvotní transakci u OneClick platby (u tzv. šablony pro OneClick platbu). Pokud je prvotní platba autorizována, předává se obchodníkovi maskované číslo použité platební karty a její expirace.

Obchodník musí mít tuto funkcionalitu na platební bráně aktivovanou. Pro aktivaci, prosím, kontaktujte [email protected].

Rozšíření parametrů odpovědi u operací payment/status a oneclick/echo

Nově přidaný parametr je extensions, obsahuje seznam všech předávaných rozšíření pro danou operaci. Rozšíření maskClnRP bude vyplněno v odpovědi operace payment/status nebo v odpovědi operace oneclick/echo pouze v případě, že prvotní platba je úspěšně autorizována.

Popis parametrů rozšíření maskClnRP

Tučně uvedené parametry budou vždy vráceny (jsou povinné)

Položka	Typ	Popis
extension	String	ID rozšíření (přidělené na základě konfigurace platební bránou). Pro maskované číslo karty a expiraci u prvotní platby bude vždy nastaveno na konstantu maskClnRP.
dttm	String	Datum a čas odpovědi ve formátu YYYYMMDDHHMMSS.
maskedCln	String	Maskované číslo platební karty ve formátu ****XXXX, kde XXXX jsou poslední 4 číslice z čísla platební karty.
expiration	String	Expirace platební karty ve formátu MM/YY.
longMaskedCln	String	Plné maskované číslo platební karty ve formátu PPPPPP****XXXX, kde PPPPPP je prvních 6 číslic, XXXX jsou poslední 4 číslice z čísla platební karty.
signature	String	Podpis rozšíření, kódováno v BASE64.

Příklad doplněného response pro payment/status o rozšíření maskClnRP

{
  "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říklad doplněného response pro oneclick/echo o rozšíření maskClnRP

{
  "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"
    }
  ]
 }

Řetězec pro výpočet nebo pro ověření podpisu je pro toto rozšíření seskládaný v pořadí, v jakém jsou položky uvedeny ve specifikaci (viz výše).

maskClnRP|20220125131601|****0209|11/16|415461****0209

Poznámka: Podpis původních parametrů je nezměněn, položka extensions obsahující seznam jednotlivých posílaných rozšíření nijak nezasahuje do výpočtu původního podpisu zprávy, každé rozšíření má svůj vlastní podpis.

Pro podepisování / ověření podpisu rozšíření je použit stejný algoritmus (SHA1withRSA pro eAPI 1.7 a nižší, nově pak SHA256withRSA pro eAPI 1.8 a vyšší).