Overenie exspirácie zaregistrovanej karty
Overenie exspirácie je možné volať iba v prípade, že klient má kartu už zaregistrovanú, t. j. vykonal úspešnú platbu so zaregistrovaním karty na opakované platby.
Podmienkou je vytvorenie HTTPS požiadavky metódou POST. Údaje vo formáte application/x-www-form-urlencoded je potrebné odoslať na endpoint:
https://admin.24-pay.eu/pay_gate/cardExpirationZoznam povinných parametrov:
| 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 |
| ClientId | ✓ | Alpha-numeric | 3..10 | Identifikátor zákazníka v systéme obchodníka (case sensitive) | 12345 |
| CardNumber | ✓ | Alpha-numeric | 11 | Číslo registrovanej karty z notifikačnej správy | 448424,2004 |
| Timestamp | ✓ | yyyy-MM-dd HH:mm:ss | 19 | Časová pečiatka tvorby platobnej žiadosti. Oddeľovačom dátumovej a časovej položky je znak medzera. | 2014-12-01 13:00:00 |
| Sign | ✓ | Alpha-numeric | 32 | Kontrolný súčet zasielaných parametrov. | 21f22ef2af21d3819cd0cff06ef55943 |
Ukážka volania pomocou curl:
curl -L -X POST 'https://admin.24-pay.eu/pay_gate/cardExpiration'
-H 'Content-Type: application/x-www-form-urlencoded'
--data-urlencode 'Mid=ABcd5678'
--data-urlencode 'EshopId=254'
--data-urlencode 'ClientId=client0047'
--data-urlencode 'CardNumber=448424,2004'
--data-urlencode 'Timestamp=2021-10-01 07:24:00'
--data-urlencode 'Sign=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'Odpoveď v JSON formáte:
{
"success": true,
"eshopId": 3,
"clientId": "1104310",
"cardNumber": "459598,1033",
"expiration": "11/25"
}Vyššie uvedená odpoveď potvrdzuje, že daná karta existuje v systéme 24-pay a čas exspirácie je November (11), 2025 (25).
Parameter success v odpovedi:
- true – karta nájdená
- false – kombinácia karty a clientId v eshope neexistuje. Hodnota ExpirationDate bude prázdna.
Výpočet podpisu (Sign)
Algoritmus na výpočet podpisu je rovnaký ako pri vytváraní žiadosti o platbu. Predmetom zreťazenia sú:
MESSAGE = Mid
EshopId
ClientId
CardNumber
Timestamp