Detailní datum a čas zpracování a vypořádání transakce - csob/platebnibrana GitHub Wiki

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 [email protected].

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šší).