PIN Debit Purchase with Swiped Track Data and Merchant Descriptors {#pd-purch-swipe-merchdescr-task}
====================================================================================================

This section describes how to process a PIN debit purchase with swiped track data and merchant descriptors.

Fields Specific to This Use Case
--------------------------------

These optional API request fields are specific to this use case:

merchantInformation.merchantDescriptor.administrativeArea
:

merchantInformation.merchantDescriptor.alternateName
:

merchantInformation.merchantDescriptor.country
:

merchantInformation.merchantDescriptor.locality
:

merchantInformation.merchantDescriptor.name
:

Endpoint {#pd-purch-swipe-merchdescr-task_d7e16}
------------------------------------------------

**Production:** `POST ``https://api.visaacceptance.com``/pts/v2/payments`{#pd-purch-swipe-merchdescr-task_d7e25}  
**Test:** `POST ``https://apitest.visaacceptance.com``/pts/v2/payments`{#pd-purch-swipe-merchdescr-task_d7e35}

Required Fields for a PIN Debit Purchase with Swiped Track Data and Merchant Descriptors {#pd-purch-swipe-merchdescr-req-fields}
================================================================================================================================

clientReferenceInformation.code
:

clientReferenceInformation.partner.thirdPartyCertificationNumber
:
`Visa Acceptance Solutions` provides the value for this field.

orderInformation.amountDetails.currency
:

orderInformation.amountDetails.totalAmount
:

paymentInformation.card.sourceAccountType
:
Set the value to `UA`.

paymentInformation.card.useAs
:
Leave this field blank.

paymentInformation.paymentType.name
:
Set the value to `CARD`.

paymentInformation.paymentType.subTypeName
:
Set the value to `DEBIT`.

pointOfSaleInformation.encryptedKeySerialNumber
:

pointOfSaleInformation.encryptedPin
:

pointOfSaleInformation.entryMode
:
Set the value to `swiped`.

pointOfSaleInformation.pinBlockEncodingFormat
:
Set the value to `1`.

pointOfSaleInformation.terminalCapability
:

pointOfSaleInformation.trackData
:

processingInformation.commerceIndicator
:
Set the value to `retail`.

REST Example: PIN Debit Purchase with Swiped Track Data and Merchant Descriptors {#pd-purch-swipe-merchdescr-ex-rest}
=====================================================================================================================

Request

```
{
  "clientReferenceInformation": {
    "code": "ABC1234", 
    "partner": {
      "thirdPartyCertificationNumber": "PTP1234"
    }
  },
  "processingInformation": {
    "commerceIndicator": "retail",
    "networkRoutingOrder": "GUFV"
  },
  "paymentInformation": {
    "paymentType": {
      "name": "CARD",
      "subTypeName": "DEBIT"
    },
    "card": {
      "useAs": "",
      "sourceAccountType": "UA"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "202.00",
      "currency": "USD"
    }
  },
  "merchantInformation": {
    "merchantDescriptor": {
      "name": "John Smith",
      "alternateName": "ABC Limited",
      "locality": "Austin",
      "country": "United States",
      "administrativeArea": "AL"
    }
  },
  "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/payments/6883842752296552503995/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/payments/6883842752296552503995"
    }
  },
  "clientReferenceInformation": {
    "code": "ABC123" 
  },
  "id": "6883842752296552503995",
  "orderInformation": {
    "amountDetails": {
      "authorizedAmount": "24.00",
      "currency": "usd"
    }
  },
  "processingInformation": {
    "reconciliationId": "6883842752296552503995"
  },
  "processorInformation": {
    "systemTraceAuditNumber": "109328",
    "routing": {
      "network": "0000"
    },
    "approvalCode": "831000",
    "retrievalReferenceNumber": "123456109328",
    "transactionId": "000000000000000",
    "responseCode": "00"
  },
  "reconciliationId": "6883842752296552503995",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2023-07-03T11:37:55Z"
}
```