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

requestPIN (PinPad Only)

This query string instructs the device to prompt for a PIN.

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

Parameter

Description

operation

Operation to request from MagneFlex. Use:

requestPIN

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. Use:

true – close device

false – do not close the device

readerArgument

Data to send for the device to be passed to MagneFlex. Arguments:

timeLimit:, fieldseparator:, pinOption:, maxpinlength:, minpinlength:, tone:,

pinmode:, endSession:

Argument details:

timeLimit - Seconds to wait before the operation times out. Value is in hexadecimal format.

(1 - 255)

fieldseparator - Delimiter to separate the output data.

pinOption - PIN verification and format:

0 = ISO0 Format, No verify PIN

1 = ISO3 Format, No verify PIN

2 = ISO0 Format, Verify PIN

3 = ISO3 Format, Verify PIN

maxpinlength – Max PIN length in hexadecimal format. (<= 0C)

minpinlength – Min PIN length in hexadecimal format. (>= 04)

tone – Beep behavior of prompt:

0 = None

1 = Single beep

2 = Double beep

pinmode - Message to display as a user prompt:

0 = PINMsgEnterPIN

1 = PINMsgEnterPINAmt

2 = PINMsgReenterPINAmt

3 = PINMsgReenterPIN

4 = PINMsgVerifyPIN

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.

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=requestPIN
&httpMethod=GET 
&closeDeviceAfter=true 
    &readerArgument=
    timeLimit:3C, 
    fieldseparator:|, 
    pinOption:00, 
    maxpinlength:0C, 
    minpinlength:04, 
    pinmode:00, 
    endSession:true
&destinationURL=https://192.168.10.100/magneflexdemo/cardpostback.asp 
&requestLocation=false
&passInData=testData

Return Value:

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

Parameter

Description

errorCode

Error status. 0 is Success. Non-Zero is an error.

errorMessage

Description of the errorCode.

opType

The type of operation. For this command the value is:

PIN_RESULT

operationStatus

Status of the operation.

pinEPB

Encrypted PIN block.

pinKSN

PIN KSN.

passInData

Optional data to send to MagneFlex. This data will be passed back to the web app.

Example

Last updated