On This Page

PIN Debit EBT Purchase with SNAP Account Swiped Track Data and Balance Inquiry

This section describes how to process a PIN debit EBT purchase with SNAP account swiped track data and balance inquiry.

Fields Specific to This Use Case

These API request fields and values are specific to this use case:
processingInformation.authorizationOptions.balanceInquiry
Set this field to
true
.
processingInformation.electronicBenefitsTransfer.category
Set this field to
FOOD
.
processingInformation.purchaseOptions.isElectronicBenefitsTransfer
Set this field to
true
.

Endpoint

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

Required Fields for a PIN Debit EBT Purchase with SNAP Account Swiped Track Data and Balance Inquiry

clientReferenceInformation.code
clientReferenceInformation.partner.thirdPartyCertificationNumber
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
Set this field to
0.00
.
paymentInformation.card.sourceAccountType
Set this field to
UA
.
paymentInformation.card.useAs
Leave this field blank.
paymentInformation.paymentType.name
Set this field to
CARD
.
paymentInformation.paymentType.subTypeName
Set this field to
DEBIT
.
pointOfSaleInformation.encryptedKeySerialNumber
pointOfSaleInformation.encryptedPin
pointOfSaleInformation.entryMode
Set this field to
swiped
.
pointOfSaleInformation.pinBlockEncodingFormat
Set this field to
1
.
pointOfSaleInformation.terminalCapability
pointOfSaleInformation.trackData
processingInformation.authorizationOptions.balanceInquiry
Set this field to
true
.
processingInformation.commerceIndicator
Set this field to
retail
.
processingInformation.electronicBenefitsTransfer.category
Set this field to
FOOD
.
processingInformation.purchaseOptions.isElectronicBenefitsTransfer
Set this field to
true
.

REST Example: PIN Debit EBT Purchase with SNAP Account Swiped Track Data and Balance Inquiry

Request 
{
  "clientReferenceInformation": {
    "code": "ABC123",
    "partner": {
      "thirdPartyCertificationNumber": "PTP1234"
    }
  },
  "processingInformation": {
    "commerceIndicator": "retail",
    "purchaseOptions": {
      "isElectronicBenefitsTransfer": true
    },
    "electronicBenefitsTransfer": {
      "category": "FOOD"
    },
    "networkRoutingOrder": "K"
    },
    "authorizationOptions": {
      "balanceInquiry": "true"
  },
  "paymentInformation": {
    "paymentType": {
      "name": "CARD",
      "subTypeName": "DEBIT"
    },
    "card": {
      "useAs": "",
      "sourceAccountType": "UA"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "60.00",
      "currency": "USD"
    }
  },
  "pointOfSaleInformation": {
    "entryMode": "swiped",
    "terminalCapability": 4,
    "trackData": "%B4111111111111111^JONES/JONES ^3112101976110000868000000?;4111111111111111=33121019761186800000?",
    "pinBlockEncodingFormat": 1,
    "encryptedPin": "52F20658C04DB351",
    "encryptedKeySerialNumber": "FFFF1B1D140000000005"
  }
}
Response to a Successful Request 
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/payments/6899394241866346704953/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/payments/6899394241866346704953"
    }
  },
  "clientReferenceInformation": {
    "code": "ABC123" 
  },
  "id": "6899394241866346704953",
  "orderInformation": {
    "amountDetails": {
      "authorizedAmount": "60.00",
      "currency": "usd"
    }
   },
  "paymentInformation": {
    "tokenizedCard": {
      "requestorId": "41111111111",
      "assuranceLevel": "AB"
    },
    "accountFeatures": {
      "accountStatus": "R",
      "balances": [
        {
          "amountType": "03",
          "amount": "+30.00",
          "accountType": "98",
          "currency": "usd"
        },
        {
          "amountType": "03",
          "amount": "+50.00",
          "accountType": "98",
          "currency": "usd"
        }
      ]
    },

    "card": {
      "suffix": "1234"
    }
  },
  "processingInformation": {
    "reconciliationId": "6899394241866346704953"
  },
  "processorInformation": {
    "systemTraceAuditNumber": "108522",
    "routing": {
      "network": "0002"
    },
    "approvalCode": "831000",
    "retrievalReferenceNumber": "123456108522",
    "transactionId": "016153570198200",
    "responseCode": "00"
  },
  "reconciliationId": "6899394241866346704953",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2023-07-21T12:00:59Z"
}