Get Card

GetCard prompts the terminal to read card data and returns the card track information. All the responses have GeneralResponse section that informs about successful result or error. See Error Codes and Messages.

Request Body

application/json

Prompt*string

Prompt message displayed to the customer while the terminal waits to read the card.

Timeout?integer

Time (in seconds) to wait for the card to be read before timing out. If null, the terminal's default timeout is used.

Formatint32

Tpn?string

Terminal profile number. Can be used to identify the terminal in SPIn Proxy environment. Required if no RegisterId.

Length10 <= length <= 12

RegisterId?string

Terminal identifier for register. [Obsolete] Can be used to identify the terminal instead of Tpn in SPIn Proxy environment. Required if no Tpn.

Length2 <= length <= 50

Authkey?string

Merchant's authorization password. Required if no SPInToken.

Length10 <= length <= 10

SPInProxyTimeout?|

Timeout for processing transaction with SPIn proxy. If null, the default timeout will be used.

Formatint32

Range1 <= value <= 720

CustomFields?

A collection of custom fields in key-value format. Numeric fields must contain a decimal point. For example: "CustomFee": 1.0 or "CustomFee": 1.00 or "CustomFee": "1.00"

Response Body

`application/json`

curl -X POST "https://example.com/v2/Payment/GetCard" \  -H "Content-Type: application/json" \  -d '{    "Prompt": "",    "Timeout": null,    "Tpn": "",    "RegisterId": "",    "Authkey": "",    "SPInProxyTimeout": null,    "CustomFields": {}  }'

{
  "Track1": "",
  "Track2": "",
  "Account": "",
  "EntryType": "",
  "GeneralResponse": {
    "ResultCode": "0",
    "StatusCode": "0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}

{
  "GeneralResponse": {
    "ResultCode": "0",
    "StatusCode": "0000",
    "Message": "",
    "DetailedMessage": "",
    "DelayBeforeNextRequest": null
  }
}

Request Body

Response Body

200application/json

400application/json

`application/json`

`application/json`