Data o kartě pro platbu na bráně

Toto rozšíření (extension) předává v operaci payment/status údaje o maskovaném čísle karty a expiraci. Údaje jsou vyplněny pouze v případě, že je platba autorizována.

Obchodník musí mít tuto funkcionalitu na platební bráně aktivovanou. Pro aktivaci, prosím, kontaktujte akceptacekaret@csob.cz.

Rozšíření parametrů odpovědi operace payment/status

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

Popis parametrů rozšíření maskCln

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 bude vždy nastaveno na konstantu maskCln.
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í maskCln

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

Ř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).

maskCln|20220125131601|****0209|11/23|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šší).