Sales with Level II Data
This section shows you how to process a sale transaction with Level II data. These
required fields and example are specific to
Visa Platform Connect
. For required
fields, optional fields, and examples specific to your processor see the Level II and Level III Processing developer
guides.
A sale transaction combines and authorization and a capture into a single
transaction.
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/paymentsTest:
POST
https://apitest.cybersource.com
/pts/v2/paymentsRequired Fields for Processing a Sale with Level II Data
Use these required fields to process a sale 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.
- Required if the sum of allorderInformation.lineItems[].taxDetails[].amountvalues =0.
- Required for purchase/procurement cards only.
- Required if the sum of allorderInformation.lineItems.taxAmountvalues =0.
- Required only forVisa Platform Connect.
- Set field totrue.
Related Information
Optional Fields for Processing a Sale with Level II Data
You can use these optional fields to include additional information when processing a
sale with Level II data.
Related Information
REST Example: Processing a Sale with Level II Data
Request
{ "processingInformation": { "capture": true }, "orderInformation" : { "billTo" : { "country" : "US", "lastName" : "VDP", "address1" : "201 S. Division St.", "postalCode" : "48104-2201", "locality" : "Ann Arbor", "administrativeArea" : "MI", "firstName" : "RTS", "email" : "test@cybs.com" }, "amountDetails" : { "totalAmount" : "100.00", "currency" : "usd" } }, "paymentInformation" : { "card" : { "expirationYear" : "2031", "number" : "4111111111111111", "expirationMonth" : "12", "type" : "001", "securityCode": "999" } } }
Response to a Successful Request
{ "_links": { "void": { "method": "POST", "href": "/pts/v2/payments/6807047010706872703954/voids" }, "self": { "method": "GET", "href": "/pts/v2/payments/6807047010706872703954" } }, "clientReferenceInformation": { "code": "1680704701200" }, "id": "6807047010706872703954", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "authorizedAmount": "100.00", "currency": "usd" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "processorInformation": { "systemTraceAuditNumber": "101247", "approvalCode": "831000", "cardVerification": { "resultCodeRaw": "M", "resultCode": "M" }, "merchantAdvice": { "code": "01", "codeRaw": "M001" }, "responseDetails": "ABC", "networkTransactionId": "016153570198200", "retrievalReferenceNumber": "309514101247", "consumerAuthenticationResponse": { "code": "2", "codeRaw": "2" }, "transactionId": "016153570198200", "responseCode": "00", "avs": { "code": "Y", "codeRaw": "Y" } }, "reconciliationId": "6807047010706872703954", "status": "AUTHORIZED", "submitTimeUtc": "2023-04-05T14:25:01Z" }