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

requestManualCard (PinPad Only)

This query string instructions the device to prompt for a manual card entry.

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

Parameter

Description

operation

Operation to request from MagneFlex. Use:

requestManualCard

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:, option:, tone:, endSession:

Argument details:

timeLimit - Seconds the device will wait for the user to complete the operation in hexadecimal:

(1 - 255)

option - This is an ORed combination of flags that changes the device’s data entry request behavior. Value is decimal equivalent of the binary value.

Bits 0 and 1

0 = Acct,Date,CVC

1 = Acct,Date

2 = Acct,CVC

3 = Acct

Bit 2

1=Use Qwick Codes entry

Bit 3

1=Use PAN in PIN block creation

Bit 4

0=Use PAN min 9, max 19

1=Use PAN min 14, max 21

tone – Beep behavior of prompt:

0 = None

1 = Single beep

2 = Double beep

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=requestManualCard
&httpMethod=GET 
&closeDeviceAfter=true
&readerArgument=
    timeLimit:3C, 
    option:8, 
    tone:00, 
    endSession:true
&destinationURL=https://192.168.10.100/magneflexdemo/cardpostback.aspx 
&requestLocation=false
&passInData=

Return Value:

The CardSwipe output in TVL format.

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:

CARD_MANUAL_SWIPE

cardDataIn

Manual card entry data in TLV format.

passInData

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

Example:

Last updated