On This Page

Credit a PIN Debit EBT Purchase with SNAP Account

This section describes how to credit a PIN debit EBT purchase with a SNAP account.

Fields Specific to This Use Case

These API request fields and values are specific to this use case:
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/credits/
Test:
POST
https://apitest.visaacceptance.com
/pts/v2/credits/

Required Fields to Credit a PIN Debit EBT Purchase with SNAP Account

clientReferenceInformation.code
clientReferenceInformation.partner.thirdPartyCertificationNumber
Visa Acceptance Solutions
 provides the value for this field.
merchantInformation.categoryCode
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
paymentInformation.card.sourceAccountType
Set this field to
UA
.
paymentInformation.card.type
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.commerceIndicator
Set this field to
retail
.
processingInformation.electronicBenefitsTransfer.category
Set this field to
FOOD
.
processingInformation.purchaseOptions.isElectronicBenefitsTransfer
Set this field to
true
.

REST Example: Credit a PIN Debit EBT Purchase with SNAP Account

Request 
{
  "clientReferenceInformation": {
    "code": "ABC1234", 
    "partner": {
      "thirdPartyCertificationNumber": "PTP1234"
    }
  },
  "processingInformation": {
    "commerceIndicator": "retail",
    "networkRoutingOrder": "K",
    "purchaseOptions": {
      "isElectronicBenefitsTransfer": true
    },
    "electronicBenefitsTransfer": {
      "category": "FOOD"
    }
  },
  "paymentInformation": {
    "card": {
      "type": "001"
    },
    "paymentType": {
      "name": "CARD",
      "subTypeName": "DEBIT"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "204.00",
      "currency": "USD"
    },
    "card": {
      "useAs": "",
      "sourceAccountType": "UA"
    }
  },
  "merchantInformation": {
    "categoryCode": "5411"
  },
  "pointOfSaleInformation": {
    "entryMode": "swiped",
    "terminalCapability": 4,
    "trackData": "%B4111111111111111^JONES/JONES ^3312101976110000868000000?;4111111111111111=33121019761186800000?",
    "pinBlockEncodingFormat": 1,
    "encryptedPin": "52F20658C04DB351",
    "encryptedKeySerialNumber": "FFFF1B1D140000000005"
  }
}
Response to a Successful Request
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/credits/6898900347906058304951/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/credits/6898900347906058304951"
    }
  },
  "clientReferenceInformation": {
    "code": "Merchandise Return / Credit Voucher from SNAP"
  },
  "creditAmountDetails": {
    "currency": "usd",
    "creditAmount": "204.00"
  },
  "id": "6898900347906058304951",
  "orderInformation": {
    "amountDetails": {
      "currency": "usd"
    }
  },
  "processingInformation": {
    "reconciliationId": "6898900347906058304951"
  },
  "processorInformation": {
    "systemTraceAuditNumber": "188586",
    "routing": {
      "network": "0029"
    },
    "approvalCode": "831000",
    "retrievalReferenceNumber": "123456188586",
    "transactionId": "000000000000000",
    "responseCode": "00"
  },
  "reconciliationId": "6898900347906058304951",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2023-07-20T21:53:55Z"
}