The getSwipe method allows you to use the terminal much like an MSR reader. This can be used if you need to swipe an admin card to log in a user or for your own gift card platform where you just need to the gift card number.
The prompt parameter is what is displayed on the terminal to prompt the user to swipe. While the command accepts any amount of characters, the display on the terminal is limited to 3 lines and it will break on spaces.
If a user manually enters a card number, then only the track1 field will return data. Be sure to test both swiping and manually entering as some cards will return data on track2 only and not track1.
We cannot prevent users from swiping real credit cards when using this method. Use of the method should only be done with care since we will return a live credit card number if the user swipes a live credit card. This will open you up to PCI regulations.
HTTP Request
|
1
|
https://velox360.com/services/api.asmx/getSwipe?key={Key}&password={Pwd}&terminalId={Id}&prompt=Swipe%20Now |
JSON Response (standard transaction response fields)
|
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
|
{ "TerminalID": 1372, "ResultFinal": true, "AuthCode": null, "TransType": "getswipe", "Amount": 0, "AmountString": null, "CardType": null, "Last4": null, "Name": null, "CashBack": 0, "CashBackString": null, "RefID": null, "receiptTerminal": null, "CardToken": null, "GiftCardBalance": 0, "GiftCardBalanceString": null, "ProcessorExtraData1": null, "ProcessorExtraData2": null, "ProcessorExtraData3": null, "SignatureData": null, "Track1": "%B4XXXXXXXXXXXX2-BS6DLR-QD55?", "Track2": ";1582300193255026?", "EMV_TC": null, "EMV_TVR": null, "EMV_AID": null, "EMV_TSI": null, "EMV_ATC": null, "EMV_App_Label": null, "EMV_App_Name": null, "EMV_ARC": null, "EMV_CVM": -1, "CardBin": null, "EntryMethod": null, "PaymentMethod": null, "TransactionDate": "2017-05-19T14:12:06-05:00", "TransactionDateUtc": "2017-05-19T19:12:06Z", "InvoiceNumber": null, "ExpDate": null, "GiftPAN": null, "ResultCode": "Success", "Message": null} |