| Parameter | Description |
| operation | Operation to request from MagneFlex. Use: requestStartEMVTransaction |
| httpMethod | HTTP method to be used for the HTTP postback from MagneFlex. Use: GET - returns the response data in the form of a query string. POST – recommended for EVM related transactions to accommodate limits on query string lengths. |
| closeDeviceAfter | Flag to close the device after the request. For requestStartEMVTransaction use: false – do not close the device |
| readerArgument | Comma delimited list of arguments to be passed to MagneFlex. Arguments: timeLimit:, cardType:, option:, amount:, transactionType:, cashBack:, currencyCode:, endSession:, quickChipMode:, reserved: Argument details: timeLimit - Seconds to wait before the operation times out. Value is in hexadecimal format. (00 - FF)
transactionType - Type of transaction to be used in hexadecimal: 00 = Purchase (listed as “Payment” on ICS) 01 = Cash Advance (not supported for this reader) 02 or 09 = Cash back (09 not supported, contactless) 04 = Goods (Purchase) 08 = Services (Purchase) 10 = International Goods (Purchase) 20 = Refund 40 = International Cash Advance or Cash Back 80 = Domestic Cash Advance or Cash Back
cardType - Card type that can be used for the transaction: 1 = Magnetic stripe 2 = Contact smart card 3 = Magnetic stripe or contact smart card
amount - The amount to be used and authorized, EMV Tag 9F02. Format in decimal.
cashBack - Amount of cash back to be used, EMV Tag 9F02. Format in decimal.
currencyCode - Transaction Currency Code (EMV Tag 5F2A, format n4 string) Sample valid values: 0840 = US Dollar 0978 = Euro 0826 = UK Pound
endSession - Flag to end the session for the device. Default value is true. |
“true” = End the session after the request is processed. “false” = Do not end the session after the request is processed.
quickChipMode - Flag to start the transaction to accommodate qwick Chip mode. “true” = Accommodate qwick chip mode. “false” = Do not accommodate qwick chip mode.
reserved - These are the reserved bytes beginning at index 20 of the 0xA2 command. Reference device manual D99875585 for more details. Example: 0000000000000000000000000840000100 – QuickDip Mode 0000000000000000000000000840000003 – PIN Verify 0000000000000000000000000840000004 – PIN Set | |
| destinationURL | MagneFlex will send the postback to this URL. |
| requestLocation | Flag to send GPS location of the device from which Magneflex (iOS only) is hosted. Use: true – send location false – do not send location |
| passInData | Optional data to send to MagneFlex. This data will be passed back to the web app. |
https://192.168.10.100/magneflexdemo/default.aspx?
operation=requestStartEMVTransaction
&httpMethod=GET
&closeDeviceAfter=true
&readerArgument=
timeLimit:3C,
cardType:02,
option:00,
amount:9.99,
transactionType:00,
cashBack:0.0,
currencyCode:0840,
endSession:true,
quickChipMode:false,
reserved:00000000000000000000000008400001
&destinationURL=https:/192.68.10.100/magneflexdemo/cardpostback.aspx
&requestLocation=false
&passInData=testData
| Parameter | Description |
| errorCode | Error status. This parameter is only available when the status is not successful. |
| errorMessage | Description of the errorCode. This parameter is only available when the status is not successful. |
| opType | The type of operation. For this command the value is: EMV_ARQC_RESULT |
| arqcData | ARQC data from the device. |
| passInData | Optional data to send to MagneFlex. This data will be passed back to the web app. |