SkyWin external payment execution
Description
SkyWin® cannot handle payments towards banks or any other provider, but from version 20.2.0 SkyWin® offers the possibility to call an external program (also run in Windows environment) with parameters for both paying, and refunding a tandem jump.
The parameters with which an external program is called, are in a fixed format from SkyWin®, described further down the page.
Usage
Once the settings have been updated as stated below, a new button will appear in both the Passenger list view, and in the details view of a Passenger.
The button will either have the text Pay or Refund, depending on the Payment checked-flag which is set on the Passenger.
If more than one Passenger is selected in the list, the button will only be clickable if all selected Passengers have the same Payment checked-flag.
Once the button is clicked, and possibly confirmed, the external program will be called and the Passenger(s) will be updated after a period of time, which is depending of the external program.
Settings
Parameters that SkyWin will send
SkyWin® will call the external program, followed by space-delimited parameters, one for each Passenger.
Each Passenger-parameter can consist of up to three values, and they are separated with a forward-slash "/".
The Passenger-parameter will only have one value if it's considered a Payment, and two to three values if it's considered a Refund.
Examples
Payment for 1 Passenger: <programname> <passengerId> — passengerId is the only value sent, for one Passenger
Refund for 1 Passenger: <programname> <passengerId>/<amount> — passengerId and total payed amount are sent, for one Passenger
Refund for 1 Passenger who has payed with Swish (SE only): <programname> <passengerId>/<amount>/<swishTxNo> — passengerId, total payed amount and transaction number for swish are sent, for one Passenger
Payment for several Passengers: <programname> <passengerId> <passengerId> <passengerId> — passengerId is the only value sent, for three Passengers in this example
Refund for several Passengers: <programname> <passengerId>/<amount> <passengerId>/<amount> <passengerId>/<amount> — passengerId and total payed amount are sent, for three Passengers in this example
Refund for several Passengers who have payed with Swish (SE only): <programname> <passengerId>/<amount>/<swishTxNo> <passengerId>/<amount>/<swishTxNo> — passengerId, total payed amount and transaction number for swish are sent, for two Passengers in this example
