PIN Debit Balance Inquiry with Swiped Track Data

This section describes how to process a PIN debit balance inquiry with swiped track data.

Fields Specific to This Use Case

This API request field and value is specific to this use case:
processingInformation.authorizationOptions.balanceInquiry
Set this field to
true
.
These API response fields are returned in this use case:
paymentInformation.accountFeatures.accountType
paymentInformation.accountFeatures.balanceAmount
paymentInformation.accountFeatures.balanceAmountType
paymentInformation.accountFeatures.balanceSign
paymentInformation.accountFeatures.currency

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments

Required Fields for a PIN Debit Balance Inquiry with Swiped Track Data

Set this field to
0.00
.
Set this field to
UA
.
Leave this field blank.
Set this field to
CARD
.
Set this field to
DEBIT
.
Set this field to
swiped
.
Set this field to
1
.
Set this field to
true
.
Set this field to
retail
.
IMPORTANT
When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see Relaxed Requirements for Address Data and Expiration Date in Payment Transactions.
PIN Debit Balance Inquiry with Swiped Track Data

REST Example: PIN Debit Balance Inquiry with Swiped Track Data

Request 
{
  "clientReferenceInformation": {
    "code": "ABC123",
    "partner": {
      "thirdPartyCertificationNumber": "PTP1234"
    }
  },
  "processingInformation": {
    "commerceIndicator": "retail",
    "authorizationOptions": {
      "balanceInquiry": "true"
    }
  },
  "merchantInformation": {
    "transactionLocalDateTime": "20200323103021"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "0.00",
      "currency": "USD"
    }
  },
  "paymentInformation": {
    "paymentType": {
      "name": "CARD",
      "subTypeName": "DEBIT"
    },
    "card": {
      "useAs": "",
      "sourceAccountType": "UA"
    }
  },
  "pointOfSaleInformation": {
    "entryMode": "swiped",
    "terminalCapability": 4,
    "pinBlockEncodingFormat": 1,
    "encryptedPin": "52F20658C04DB351",
    "encryptedKeySerialNumber": "FFFF1B1D140000000005",
    "trackData": "%B4111111111111111^JONES/JONES ^3112101976110000868000000?;4111111111111111=33121019761186800000?"
  }
}
Response to a Successful Request
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/payments/6879489725216492803092/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/payments/6879489725216492803092"
    }
  },
  "clientReferenceInformation": {
    "code": "987654321" 
  },
  "id": "6879489725216492803092",
  "orderInformation": {
    "amountDetails": {
      "authorizedAmount": "0.00",
      "currency": "usd"
    }
  },
  "paymentInformation": {
    "accountFeatures": {
      "balances": [
        {
          "amountType": "02",
          "amount": "+20.00",
          "accountType": "00",
          "currency": "usd"
        }
      ]
    }
  }
},
  "processingInformation": {
    "reconciliationId": "6879489725216492803092"
  },
  "processorInformation": {
    "systemTraceAuditNumber": "837760",
    "routing": {
      "network": "0000"
    },
    "approvalCode": "831000",
    "retrievalReferenceNumber": "123456837760",
    "transactionId": "016153570198200",
    "responseCode": "00"
  },
  "reconciliationId": "6879489725216492803092",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2023-06-28T10:42:52Z"
}
PIN Debit Balance Inquiry with Swiped Track Data