On This Page

Credits with Level II Data

This topic shows you how to process a

credit

with Level II data. These required fields and example are specific to Visa Platform Connect.

Endpoint

Production:

POST https://api.visaacceptance.com/pts/v2/credits/

Test:

POST https://apitest.visaacceptance.com/pts/v2/credits/

Required Fields for Processing a Credit with Level II Data

Use these required fields to process a credit that includes Level II data.

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.

orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
orderInformation.billTo.address1
orderInformation.billTo.administrativeArea
orderInformation.billTo.country
orderInformation.billTo.email
orderInformation.billTo.firstName
orderInformation.billTo.lastName
orderInformation.billTo.locality
orderInformation.billTo.postalCode
orderInformation.invoiceDetails.purchaseOrderNumber: Required for purchase/procurement cards only.
orderInformation.invoiceDetails.taxable: Required if the sum of all
orderInformation.lineItems[].taxAmount
values >
0
.
orderInformation.lineItems[].taxAmount
paymentInformation.card.expirationMonth
paymentInformation.card.expirationYear
paymentInformation.card.number

Optional Fields for Processing a Credit with Level II Data

You can use these optional fields to include additional information when processing a credit request with Level II data.

order.vatTaxAmountSign
orderInformation.shipTo.postalCode

REST Example: Processing a Credit with Level II Data

Request

{
  "paymentInformation": {
    "card": {
      "number": "4111111111111111",
      "expirationMonth": "03",
      "expirationYear": "2031"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "7.77",
      "currency": "USD",
      "invoiceDetails": {
        "purchaseOrderNumber": "L2PurchaseOrderNo",
        "purchaseOrderDate": "2024-11-15",
        "taxable": true
      }
    },
    "lineItems": [
      {
        "unitPrice": "7.00",
        "taxAmount": ".77"
      }
    ]
  },
  "billTo": {
    "firstName": "John",
    "lastName": "Deo",
    "address1": "900 Metro Center Blvd",
    "locality": "Foster City",
    "administrativeArea": "CA",
    "postalCode": "48104-2201",
    "country": "US",
    "email": "",
    "phoneNumber": "9321499232"
  }
}

Response to a Successful Request

{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/credits/7320289208766957204951/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/credits/7320289208766957204951"
    }
  },
  "clientReferenceInformation": {
    "code": "1732028921016"
  },
  "creditAmountDetails": {
    "currency": "USD",
    "creditAmount": "200.00"
  },
  "id": "7320289208766957204951",
  "orderInformation": {
    "amountDetails": {
      "currency": "USD"
    }
  },
  "paymentAccountInformation": {
    "card": {
      "type": "001"
    }
  },
  "paymentInformation": {
    "tokenizedCard": {
      "type": "001"
    },
    "card": {
      "type": "001"
    }
  },
  "processorInformation": {
    "approvalCode": "888888",
    "responseCode": "100"
  },
  "reconciliationId": "69002042N33YJ7AN",
  "status": "PENDING",
  "submitTimeUtc": "2024-11-19T15:08:41Z"
}