Dokončenie/zrušenie predautorizovanej platby
Dokončenie alebo zrušenie predautorizácie je možné volať iba pri platbách, ktoré sú založené ako predautorizované a sú v stave AUTHORIZED.
Podmienkou je vytvorenie HTTPS požiadavky metódou POST. Údaje kódované vo forme application/x-www-form-urlencoded.
https://admin.24-pay.eu/pay_gate/authZoznam parametrov obsahuje nasledujúca tabuľka:
| Parameter | Povinný | Formát | Dĺžka | Popis | Príklad |
|---|---|---|---|---|---|
| Mid | ✓ | Alpha-numeric | 8 | Identifikátor obchodníka (case sensitive) | 1a2B3c4D |
| EshopId | ✓ | Numeric | 1..10 | Identifikátor e-shopu | 135 |
| MsTxnId | ✓ | Alpha-numeric | 1..32 | Jednoznačný/jedinečný identifikátor platby poskytnutý obchodníkom (variabilný symbol) | 1234567890 |
| PspTxnId | ✓ | Alpha-numeric | 1..32 | Jednoznačný/jedinečný identifikátor platby generovaný 24-pay, posielaný v notifikačnej správe po predautorizácii | 0987654321 |
| Amount | ✓ | #0.00 | 1..10,2 | Suma platby. Oddeľovačom desatinnej časti je bodka. Desatinná časť je vždy zastúpená dvoma číslicami. | 1.00 |
| CurrAlphaCode | ✓ | AAA | 3 | Mena platby ISO 4217 | EUR |
| Timestamp | ✓ | yyyy-MM-ddHH:mm:ss | 19 | Časová pečiatka tvorby platobnej požiadavky. Oddeľovačom dátumovej a časovej položky je znak medzera. Timestamp a MsTxnId musia tvoriť unikátnu kombináciu. | 2014-12-0113:00:00 |
| Target | ✓ | OK/FAIL | 2/4 | OK - platba úspešná.FAIL – platba neúspešná. | OK |
| Sign | ✓ | Alpha-numeric | 32 | Kontrolný súčet zasielaných parametrov. | |
| NURL | URL | 256 | URL adresa obchodu, kam sú zasielané notifikácie o zmene stavu platby prostredníctvom HTTP/HTTPS POST. V prípade prítomnosti prekryje konfigurovanú položku NURL. | http://mojobchod.sk/nurl |
V odpovedi obdrží obchodník nasledujúce informácie vo formáte json:
{
"MsTxnId":"1234567890",
"PspTxnId":"0987654321"
"Amount":"1.00",
"CurrCode":"EUR",
"Target":"OK",
"Status":"OK"
}Táto odpoveď potvrdzuje prijatie na spracovanie. Potvrdenie o zmene stavu transakcie je zasielané notifikačnou správou na NURL to však iba v prípade, že je po zaslaní požiadavky Status OK alebo FAIL, v prípade ERROR notifikačná správa nie je zasielaná, nakoľko nedôjde k zmene stavu platby.: