PosnetServer może wykonywać wydruki niefiskalne na drukarce fiskalnej. Dzięki temu możliwe jest drukowanie nie tylko paragonów, ale również na przykład potwierdzeń płatności z terminala płatniczego. W tym tutorialu opiszemy jak wykorzystać drukarkę fiskalną do wydruku potwierdzeń z eService.
Cały proces prezentujący włąsciwe przeprowadzenie płatności na terminalu eService dostępny jest w formie skryptów bash w katalogu docs produktu IngenicoServer. Znajdujący się tam skrypt transaction_script.sh wykonuje płatność, następnie sprawdza jej status i na końcu, wykorzystując funkcję build_recipe generuje plik PNG z potwierdzeniem transakcji.
ASPEKTY PRAWNE
Potwierdzenie płatności z terminala musi zawierać kilka ważnych elementów, takich jak:
- Informację o właścicielu terminala, jego identyfikator oraz identyfikator terminala płatniczego
- Numer transakcji, datę transakcji, jej wartość oraz rezultat. W przypadku poprawnie obciążonego konta, numer autoryzacji.
- Zgodę na obciążenie konta, lub uznanie w przypadku zwrotów na kartę,
- W przypadku płatności kartą zbliżeniowo, należy zaznaczyć ten fakt w formie tagu “CONTACTLESS”, a w przypadku płatności klasycznej zamaskowany numer karty i datę jej ważności jeśli jest dostępna.
- W przypadku transakcji walutowych (DCC) wymagane jest podanie kursu przeliczenia, waluty oraz dodatkowych informacji przekazanych przez terminal,
Przykładowe potwierdzenia drukowane przez terminal dla płatności kartą, BLIK’iem oraz dla zwrotu mogą wyglądać następująco:
Naszym celem jest uzyskanie wydruku na drukarce fiskalnej, który będzie zawierał wszystkie informacje z powyższych przykładów. Informacji do zamieszczenia jest sporo, stąd zachęcamy do przeanalizowania zawartości skryptu skrypt transaction_script.sh i następnie przepisane znajdującej się tam logiki do własnej aplikacji generującej potwierdzenia wydruków.
WYDRUK POTWIERDZENIA NA DRUKARCE FISKALNEJ
Przykładowy request drukujący potwierdzenie transakcji na 19zł wykonanej zbliżeniowo i zakończonej sukcesem. Wartości w formatce należy zamienić odpowiednimi wartościami otrzymanymi z metod /eservice/v1/ingenico_transaction_end oraz /eservice/v1/ingenico_general_info produktu IngenicoServer.
Przykładowa odpowiedź z IngenicoServer może wyglądać następująco:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 |
{ "ok":true, "error":"", "terminal":{ "returnCode":0, "transactionType":1, "transactionResultCode":0, "transactionResultCodeText":"accepted", "transactionNumber":45, "transactionDetails":{ "authorizationCode":"111784", "serverMessage":"", "merchantID":"454500000000000", "maskedCardNumber":"4056", "date":"2024.03.20", "time":"09:38:24", "cardsetName":"DEBIT MASTERCARD", "readerUsed":"B", "readerUsedText":"contactless", "terminalIdentifier":"00007110", "authorizationMessage":"000045", "authorizationType":"1", "authorizationTypeText":"online", "transactionAmount":"1900", "cardholderAuthorizationMethod":"?", "cardholderAuthorizationMethodText":"no_authorization", "atc":"0011", "ac":"BDB7B6AEC8C169C5", "aid":"A0000000041010", "tvr":"0020008001", "tsi":"0000", "title":"", "printingIndicator":"0", "transactionCurrency":"PLN", "terminalCurrency":"", "transactionAmountDCC":"", "exchangeRate":"", "dcc1":"", "dcc2":"", "cashAmount":"", "spendingAmount":"", "dcc_currencyExp":"", "additionalInformation":"DF040180DF1E0A4D415354455243415244DF0B0400000100", "additionalInformationObject":{ "emv":"arqc", "transactionFlagsObject":[ "noCVM" ] } } } } |
Po przeprasowaniu JSON’a, wartości poszczególnych pól można wysłać do PosnetServer w następujący sposób:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 |
curl -X 'POST' \ 'http://localhost:3050/raporty/custom?fulldebug=false' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "formtype": "super_formatka", "header": 52, "lines": [ { "type": 711, "params": ["--------------------------------------"] }, { "type": 711, "params": ["Moja Firma S.A."] }, { "type": 711, "params": ["UL. JANA OLBRACHTA 94"] }, { "type": 711, "params": ["01-102 WARSZAWA"] }, { "type": 711, "params": ["--------------------------------------"] }, { "type": 711, "params": ["MID: 454500000000000"] }, { "type": 711, "params": ["TID: 00007110"] }, { "type": 711, "params": ["Rachunek numer: 45"] }, { "type": 711, "params": [" "] }, { "type": 711, "params": ["DEBIT MASTERCARD"] }, { "type": 711, "params": ["xxxx-xxxx-xxxx-4056"] }, { "type": 711, "params": ["Ważna do: /"] }, { "type": 711, "params": [" "] }, { "type": 711, "params": ["SPRZEDAŻ: 19,00 PLN"] }, { "type": 711, "params": [" "] }, { "type": 711, "params": ["Proszę obciążyć moje konto"] }, { "type": 711, "params": ["--------------------------------------"] }, { "type": 711, "params": [" ZGODA"] }, { "type": 711, "params": ["--------------------------------------"] }, { "type": 711, "params": [" "] }, { "type": 711, "params": ["Kod autoryzacji: 111784"] }, { "type": 711, "params": ["AID: A0000000041010"] }, { "type": 711, "params": ["--------------------------------------"] }, { "type": 711, "params": [" CONTACTLESS"] }, { "type": 711, "params": ["--------------------------------------"] }, { "type": 711, "params": [" "] }, { "type": 711, "params": ["Data: 2024.03.20"] }, { "type": 711, "params": ["Godzina: 09:38:24"] }, { "type": 711, "params": [" "] }, { "type": 711, "params": ["--------------------------------------"] }, { "type": 711, "params": ["DF040180DF1E0A4D415354455243415244DF0"] }, { "type": 711, "params": ["B0400000100"] }, { "type": 711, "params": ["--------------------------------------"] } ] }' |
Ten sam request od wersji PosnetServer 5.2 może zostać wysłany w prostszej formie:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 |
curl -X 'POST' \ 'http://localhost:3050/raporty/textlines?fulldebug=false' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "header": 52, "lines": [ "--------------------------------------", "Moja Firma S.A.", "UL. JANA OLBRACHTA 94", "01-102 WARSZAWA", "--------------------------------------", "MID: 454500000000000", "TID: 00007110", "Rachunek numer: 45", " ", "DEBIT MASTERCARD", "xxxx-xxxx-xxxx-4056", "Ważna do: /", " ", "SPRZEDAŻ: 19,00 PLN", " ", "Proszę obciążyć moje konto", "--------------------------------------", " ZGODA", "--------------------------------------", " ", "Kod autoryzacji: 111784", "AID: A0000000041010", "--------------------------------------", " CONTACTLESS", "--------------------------------------", " ", "Data: 2024.03.20", "Godzina: 09:38:24", " ", "--------------------------------------", "DF040180DF1E0A4D415354455243415244DF0", "B0400000100", "--------------------------------------" ] }' |
Pobierz wersję 5.x
Przejdź do artykułu: “Instalacja PosnetServer“.