Protokol platieb

Požiadavka na realizáciu platby od obchodníka

Pre zaslanie novej platobnej žiadosti je nutné na stránku webového sídla obchodu umiestniť príslušný formulár, ktorý presmeruje zákazníka na 24pay platobnú bránu.

URL 24pay platobná brána:

https://admin.24-pay.eu/pay_gate/paygt

Podmienkou je vytvorenie HTTPS požiadavky metódou POST. Údaje kódované vo forme application/x-www-form-urlencoded. Zoznam 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
Amount	✓	#0.00	1..10,2	Suma platby. Oddeľovačom desatinnej časti je bodka. Desatinná časť je vždy zastúpená dvoma číslicami. Pri dokončení predautorizácie musí byť hodnota rovnaká alebo nižšia ako suma predautorizácie. V prípade zrušenia musí byť hodnota rovnaká ako suma predautorizácie.	1.00
CurrAlphaCode	✓	AAA	3	Mena platby ISO 4217	EUR
ClientId	✓	Alpha-numeric	3..10	Identifikátor zákazníka v systéme obchodníka (case sensitive)	12345
FirstName	✓	Alphabetic	2..50	Zákazník – krstné meno	Jožko
FamilyName	✓	Alphabetic	2..50	Zákazník – priezvisko	Mrkvička
Email	✓	email	6..128	Zákazník – emailová adresa	jozko.mrkvicka@demo.com
NotifyClient		email	6..128	Emailová adresa zákazníka, kam sú zasielané dodatočné notifikácie o zmene stavu platby.	jozko.mrkvicka@demo.com
SaveTransactionEmail		email	6..128	Emailová adresa zákazníka, kam je v danom intervale poslaný mail s offline linkom na platbu v prípade platby bez odpovede alebo zamietnutej platby.	jozko.mrkvicka@demo.com
Country	✓	AAA	3	Zákazník – kód krajiny bydliska ISO 3166-1	SVK
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
Sign	✓	Alpha-numeric	32	Kontrolný súčet zasielaných parametrov.
LangCode		aa	2	Kód jayka ISO 639-1. sk, cs, en, de, hu, es, fr, it, pl. Štandardne sk.	sk
RURL		URL	256	URL adresa, kam je zákazník presmerovaný po zrealizovaní transakcie. V prípade prítomnosti prekryje konfigurovanú položku RURL.	http://mojobchod.sk/rurl
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
NotifyEmail		email	6..128	Emailová adresa, kam sú zasielané dodatočné notifikácie o zmene stavu platby.	platby@mojobchod.sk
RedirectSign		true/false	4/5	Možnosť pridania podpisu pri presmerovaní.	false
PreAuthProvided		true/false	4/5	Možnosť predautorizácie platby (iba pre platobné karty)	false
Phone		Alpha-numeric	8..25	Zákazník – telefónny kontakt	0901 000 001
Street		Alpha-numeric	3..50	Zákazník – ulica	Kvetná 123
City		Alphabetic	2..50	Zákazník – mesto bydliska	Bratislava
Zip		Alpha-numeric	1..10	Zákazník – poštové smerovacie číslo bydliska	821 08
Cart	✓	Base64 JSON		Povinné iba v prípade platobnej metódy Na Splátky. Obsah košíka rozdelený na jednotlivé produkty a dopravu.	ewogICJkZWxpdmVyeU5hbWUiOiAiRFBEIiwKICAiZGVsaXNzAsCiAgIml0ZW1zIjogWwogICAgewogICAgICAiaXRlbU5hbWUiOiAiUHJvZHVrdCAxIiwKICAgICAgIml0ZW1EZXNjcmlwdGlvbiI6ICJQb3BpcyBwcm9kdWt0dSAxIiwKICAgICAgInF1YW50aXR5IjogMiwKICAgICAgIml0ZW1QcmljZSI6IDEuNDAKICAgIH0sCiAgICB7CiAgICAgICJpdGVtTmFtZSI6ICJQcm9kdWt0IDIiLAogICAgICAiaXRlbURlc2NyaXB0aW9uIjogIlBvcGlzIHByb2R1a3R1IDIiLAogICAgICAicXVhbnRpdHkiOiAxLAogICAgICAiaXRlbVByaWNlIjogMjQzLjUwCiAgICB9CiAgXQp9

Formát parametra Cart

{
    deliveryName * Alpha-numeric
    deliveryPrice * #0.00
    items[ *
        itemName* Alpha-numeric
        itemDescription Alpha-numeric
        quantity * numeric
        itemPrice * #0.00
    ]
}

Príklad json:

{
    "deliveryName": "DPD",
    "deliveryPrice": 3.70,
    "items": [
        {
            "itemName": "Produkt 1",
            "itemDescription": "Popis produktu 1",
            "quantity": 2,
            "itemPrice": 1.40
        },
        {
            "itemName": "Produkt 2",
            "itemDescription": "Popis produktu 2",
            "quantity": 1,
            "itemPrice": 243.50
        }
    ]
}

BASE64:

ewogICJkZWxpdmVyeU5hbWUiOiAiRFBEIiwKICAiZGVsaXZlcnlQcmljZSI6IDMuNzAsCiAgIml0ZW1zIjogWwogICAgewogICAgICAiaXRlbU5hbWUiOiAiUHJvZHVrdCAxIiwKICAgICAgIml0ZW1EZXNjcmlwdGlvbiI6ICJQb3BpcyBwcm9kdWt0dSAxIiwKICAgICAgInF1YW50aXR5IjogMiwKICAgICAgIml0ZW1QcmljZSI6IDEuNDAKICAgIH0sCiAgICB7CiAgICAgICJpdGVtTmFtZSI6ICJQcm9kdWt0IDIiLAogICAgICAiaXRlbURlc2NyaXB0aW9uIjogIlBvcGlzIHByb2R1a3R1IDIiLAogICAgICAicXVhbnRpdHkiOiAxLAogICAgICAiaXRlbVByaWNlIjogMjQzLjUwCiAgICB9CiAgXQp9

Protokol platieb

Požiadavka na realizáciu platby od obchodníka

On this page