Skip to content

Detailní datum a čas zpracování a vypořádání transakce

Ondřej Zaoral edited this page Jun 17, 2022 · 1 revision

Toto rozšíření (extension) předává v operaci payment/status údaje o datumu a času vytvoření transakce, její autorizaci a zúčtování.

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

Datum a čas vytvoření transakce

Datum a čas založení transakce na platební bráně v rámci operace payment/init. Formát YYYY-MM-DD'T'HH:MM:SS.SSS'Z' (přesnost na ms).

Datum a čas autorizace

Úplně přesně se jedná o okamžik začátku zpracování v autorizační části platební brány (po validaci parametrů, těsně před odesláním požadavku na autorizaci). Formát YYMMDDHHMMSS (přesnost na sekundy).

Datum zúčtování

Datum zúčtování určuje, ve kterém výpisu transakce skončí. Formát YYYYMMDD (přesnost na dny).

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í trxDates bude vyplněno pouze v odpovědi operace payment/status.

Popis parametrů rozšíření trxDates

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 toto rozšíření bude vždy nastaveno na konstantu trxDates.
dttm String Datum a čas odpovědi ve formátu YYYYMMDDHHMMSS.
createdDate String Datum a čas vytvoření transakce na platební bráně, formát YYYY-MM-DD'T'HH:MM:SS.SSS'Z'.
authDate String Datum a čas autorizace, formát YYMMDDHHMMSS, vyplněno pouze pokud je transakce autorizovaná.
settlementDate String Datum zúčtování transakce, formát YYYYMMDD, vyplněno pouze pokud je transakce zařazena do zúčtování nebo je již zúčtována.
signature String Podpis rozšíření, kódováno v BASE64.

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

{
  "dttm": "20220125131601",
  "payId": "1112dd54b133@HA",
  "resultCode": 0,
  "resultMessage": "OK",
  "paymentStatus": 7,
  "authCode": "453708",
  "signature": "base64-encoded-response-signature",
  "extensions": [
    {
      "extension": "trxDates",
      "dttm": "20220125131601",
      "createdDate": "2022-01-24T10:06:20.848Z",
      "authDate": "220124100635",
      "settlementDate": "20220124",
      "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).

trxDates|20220125131601|2022-01-24T10:06:20.848Z|220124100635|20220124

Poznámka: Podpis původních parametrů je nezměněn, položka entensions 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šší).

Clone this wiki locally