Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
ChatGPT

requestStartEMVTransaction (EMV Only)

This query string begins an EMV transaction.

?operation= 
&httpMethod= 
&closeDeviceAfter= 
&readerArgument= 
&destinationURL= 
&requestLocation= 
&passInData=

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.

Each input parameter supplied in the request is delimited by an ampersand character ‘&’, and the value for a parameter begins after an equal character ‘=’. Where ever a parameter contains multiple values, each are delimited by a comma character

Example query:

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

Return Value:

The EMV ARQC response output in Hex string format of device raw response for this command.

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.

Example

Last updated