Recent Revisions to This Document

About This Guide

VISA Platform Connect: Specifications and Conditions for Resellers/Partners

Introduction to Card Present Connect | Retail
- Enabling the Card Present Connect Platform
  - Enabling Card Present Connect
- Card-Present Transactions
  - EMV Transactions
  - Magnetic Stripe Transactions
  - Hand-Keyed Transactions
- Card-Present Transaction Risk Control Requirements

Card-Present Payment Processing

Card-Present Authorizations
- Authorization with Contact EMV and Online PIN
  - Required Fields for Processing an Authorization with Contact EMV and Online PIN
    - Country-Specific Required Fields for Processing an Authorization with Contact EMV or Contactless PIN
  - REST Example: Processing an Authorization with Contact EMV and Online PIN
- Authorization with Contact EMV and Offline PIN
  - Required Fields for Processing an Authorization with Contact EMV and Offline PIN
    - Country-Specific Required Fields for Processing an Authorization with Contact EMV or Contactless PIN
  - REST Example: Processing an Authorization with Contact EMV and Offline PIN
- Authorization with Contactless EMV and Online PIN
  - Required Fields for Processing an Authorization with Contactless EMV and Online PIN
  - REST Example: Processing an Authorization with Contactless EMV and Online PIN
- Authorizations with Magnetic Stripe Swipes
  - Required Fields for Processing an Authorization with Swiped Track Data
  - REST Example: Processing an Authorization with Swiped Track Data
- Authorizations with Hand-Keyed Data
  - Required Fields for Processing an Authorization with Hand Keyed Data
  - REST Example: Processing an Authorization with Hand Keyed Data
- Authorization for a Cash Advance with a Credit Card
  - Required Fields for Processing an Authorization for a Cash Advance
  - Optional Fields for Processing an Authorization for a Cash Advance
  - REST Example: Processing an Authorization for a Cash Advance
  - Response Codes from an Authorization for a Cash Advance

Captures
- Required Fields for Capturing an Authorization
- REST Example: Capturing an Authorization

Capture for a Contact EMV Authorization
- Required Fields for Capturing a Contact EMV Authorization
- REST Example: Capturing a Contact EMV Authorization

Stand-Alone Credit
- Required Fields for Processing a Stand-Alone Credit
- REST Interactive Example: Processing a Stand-Alone Credit
- REST Example: Processing a Stand-Alone Credit

Authorization Reversals
- Required Fields for Processing an Authorization Reversal
- REST Example: Processing an Authorization Reversal

Void
- Required Fields for Processing a Void
- REST Example: Processing a Void

Timeout Void for a Capture, Sale, Refund, or Credit
- Required Fields for Processing a Timeout Void for a Capture, Sale, Refund, or Credit
- REST Example: Processing a Timeout Void for a Capture, Sale, Refund, or Credit

Card-Present Mobile Point-of-Sale Payment Processing
- Authorization with an mPOS Using an Embedded Reader and Software PIN Entry
  - Required Fields for Processing an Authorization with an mPOS Using an Embedded Reader and Software PIN Entry
  - REST Example: Processing an Authorization with an mPOS Using an Embedded Reader and Software PIN Entry for Mastercard
  - REST Example: Processing an Authorization with an mPOS Using an Embedded Reader and Software PIN Entry for Visa
- Authorization with an mPOS Using an Embedded Reader and Software with No PIN Entry
  - Required Fields for Processing an Authorization with an mPOS Using an Embedded Reader and Software with No PIN Entry
  - REST Example: Processing an Authorization with an mPOS Using an Embedded Reader and Software with No PIN Entry for Mastercard
  - REST Example: Processing an Authorization with an mPOS Using an Embedded Reader and Software with No PIN Entry for Visa
- Authorization with an mPOS Using an External, Contact-Only Reader with No PIN Entry
  - Required Fields for Processing an Authorization with an mPOS Using an External, Contact-Only Reader with No PIN Entry
  - REST Example: Processing an Authorization with an mPOS Using an External, Contact-Only Reader with No PIN Entry for Mastercard
  - REST Example: Processing an Authorization with an mPOS Using an External, Contact-Only Reader with No PIN Entry for Visa
- Authorization with an mPOS Using an External Reader and Hardware PIN Entry
  - Required Fields for Processing an Authorization with an mPOS Using an External Reader and Hardware PIN Entry
  - REST Example: Processing an Authorization with an mPOS Using an External Reader and Hardware PIN Entry for Mastercard
  - REST Example: Processing an Authorization with an mPOS Using an External Reader and Hardware PIN Entry for Visa
- Authorization with an mPOS Using an External Reader and Software PIN Entry
  - Required Fields for Processing an Authorization with an mPOS Using an External Reader and Software PIN Entry
  - REST Example: Processing an Authorization with an mPOS Using an External Reader and Software PIN Entry for Mastercard
  - REST Example: Processing an Authorization with an mPOS Using an External Reader and Software PIN Entry for Visa
- Sale with an mPOS Using an Embedded Reader and Software PIN Entry
  - Required Fields for Processing a Sale with an mPOS Using an Embedded Reader and Software PIN Entry
  - REST Example: Processing a Sale with an mPOS Using an Embedded Reader and Software PIN Entry for Mastercard
  - REST Example: Processing a Sale with an mPOS Using an Embedded Reader and Software PIN Entry for Visa
- Sale with an mPOS Using an Embedded Reader and Software with No PIN Entry
  - Required Fields for Processing a Sale with an mPOS Using an Embedded Reader and Software with No PIN Entry
  - REST Example: Processing a Sale with an mPOS Using an Embedded Reader and Software with No PIN Entry for Mastercard
  - REST Example: Processing a Sale with an mPOS Using an Embedded Reader and Software with No PIN Entry for Visa
- Sale with an mPOS Using an External, Contact-Only Reader with No PIN Entry
  - Required Fields for Processing a Sale with an mPOS Using an External, Contact-Only Reader with No PIN Entry
  - REST Example: Processing a Sale with an mPOS Using an External, Contact-Only Reader with No PIN Entry for Mastercard
  - REST Example: Processing a Sale with an mPOS Using an External, Contact-Only Reader with No PIN Entry for Visa
- Sale with an mPOS Using an External Reader and Hardware PIN Entry
  - Required Fields for Processing a Sale with an mPOS Using an External Reader and Hardware PIN Entry
  - REST Example: Processing a Sale with an mPOS Using an External Reader and Hardware PIN Entry for Mastercard
  - REST Example: Processing a Sale with an mPOS Using an External Reader and Hardware PIN Entry for Visa
- Sale with an mPOS Using an External Reader and Software PIN Entry
  - Required Fields for Processing a Sale with an mPOS Using an External Reader and Software PIN Entry
  - REST Example: Processing a Sale with an mPOS Using an External Reader and Software PIN Entry for Mastercard
  - REST Example: Processing a Sale with an mPOS Using an External Reader and Software PIN Entry for Visa

Introduction to PIN Debit Processing
- PIN Debit Integration
- PIN Debit Transactions
- PIN Debit Network Routing
- PIN Debit Processing Versus Credit Card Processing
- PIN Debit Reconciliation
- Track Data
- Terminal IDs
- Electronic Benefit Transfer
- Optional Features
  - Cash Back
  - Merchant Descriptors
  - Merchant-Inititated Reversals
  - Partial Authorizations
  - Payment Network Tokens
  - Surcharge Fees

PIN Debit Services
- PIN Debit Purchase with Contactless EMV
  - Required Fields for a PIN Debit Purchase with Contactless EMV
  - REST Example: PIN Debit Purchase with Contactless EMV
- PIN Debit Purchase with Contact EMV
  - Required Fields for a PIN Debit Purchase with Contact EMV
  - REST Example: PIN Debit Purchase with Contact EMV
- PIN Debit Purchase with Contactless EMV and Cash Back
  - Required Fields for a PIN Debit Purchase with Contactless EMV and Cash Back
  - REST Example: PIN Debit Purchase with Contactless EMV and Cash Back
- PIN Debit Purchase with Swiped Track Data and Merchant Descriptors
  - Required Fields for a PIN Debit Purchase with Swiped Track Data and Merchant Descriptors
  - REST Example: PIN Debit Purchase with Swiped Track Data and Merchant Descriptors
- PIN Debit Partial Authorization with Swiped Track Data
  - Required Fields for a Swiped PIN Debit Partial Authorization
  - REST Example: PIN Debit Partial Authorization with Swiped Track Data
- PIN Debit Purchase with Contactless EMV and a Surcharge Fee
  - Required Fields for a PIN Debit Purchase with Contactless EMV and a Surcharge Fee
  - REST Example: PIN Debit Purchase with Contactless EMV and a Surcharge Fee
- PIN Debit Balance Inquiry with Contactless EMV
  - Required Fields for a PIN Debit Balance Inquiry with Contactless EMV
  - REST Example: PIN Debit Balance Inquiry with Contactless EMV
- PIN Debit Balance Inquiry with Swiped Track Data
  - Required Fields for a PIN Debit Balance Inquiry with Swiped Track Data
  - REST Example: PIN Debit Balance Inquiry with Swiped Track Data
- PIN Debit Credit with Swiped Track Data
  - Required Fields for a PIN Debit Credit with Swiped Track Data
  - REST Example: PIN Debit Credit with Swiped Track Data
- PIN Debit Credit with Contactless EMV
  - Required Fields for a PIN Debit Credit with Contactless EMV
  - REST Example: PIN Debit Credit with Contactless EMV
- Reverse a PIN Debit Purchase or Credit
  - Required Fields to Reverse a PIN Debit Purchase or Credit
  - REST Example: Reverse a PIN Debit Purchase or Credit
- PIN Debit EBT Purchase with a SNAP Voucher
  - Required Fields for a PIN Debit EBT Purchase with a SNAP Voucher
  - REST Example: PIN Debit EBT Purchase with a SNAP Voucher
- PIN Debit EBT Purchase with SNAP Account Swiped Track Data
  - Required Fields for a PIN Debit EBT Purchase with SNAP Account Swiped Track Data
  - REST Example: PIN Debit EBT Purchase with SNAP Account Swiped Track Data
- PIN Debit EBT Purchase with SNAP Account Swiped Track Data and Balance Inquiry
  - Required Fields for a PIN Debit EBT Purchase with SNAP Account Swiped Track Data and Balance Inquiry
  - REST Example: PIN Debit EBT Purchase with SNAP Account Swiped Track Data and Balance Inquiry
- PIN Debit EBT Purchase with a Cash Benefits Account Swiped Track Data and Cash Back
  - Required Fields for a PIN Debit EBT Purchase with a Cash Benefits Account Swiped Track Data and Cash Back
  - REST Example: PIN Debit EBT Purchase with a Cash Benefits Account Swiped Track Data and Cash Back
- Credit a PIN Debit EBT Purchase with SNAP Account
  - Required Fields to Credit a PIN Debit EBT Purchase with SNAP Account
  - REST Example: Credit a PIN Debit EBT Purchase with SNAP Account
- Reverse a PIN Debit EBT Purchase
  - Required Fields to Reverse a PIN Debit EBT Purchase
  - REST Example: Reverse a PIN Debit EBT Purchase

On This Page

REST API | Visa Platform Connect

REST Example: PIN Debit Credit with Contactless EMV

Endpoint

Production:

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

Test:

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

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"
    }
  },
  "pointOfSaleInformation": {
    "entryMode": "contactless",
    "terminalCapability": 4,
    "emv": {
      "tags": "9F3303204000950500000000009F3704518823719F100706011103A000009F26081E1756ED0E2134E29F36020015820200009C01009F1A0208409A030006219F02060000000020005F2A0208409F0306000000000000",
      "cardSequenceNumber": "01"
    },
    "trackData": "%B4111111111111111^JONES/JONES ^3312101976110000868000000?;4111111111111111=33121019761186800000?"
  }
}

Response to a Successful Request

{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/credits/6886766930876811204951/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/credits/6886766930876811204951"
    }
  },
  "clientReferenceInformation": {
    "code": "ABC1234" 
  },
  "creditAmountDetails": {
    "currency": "usd",
    "creditAmount": "202.00"
  },
  "id": "6886766930876811204951",
  "orderInformation": {
    "amountDetails": {
      "currency": "usd"
    }
  },
  "processingInformation": {
    "reconciliationId": "6886766930876811204951"
  },
  "processorInformation": {
    "systemTraceAuditNumber": "120775",
    "routing": {
      "network": "0000"
    },
    "approvalCode": "831000",
    "retrievalReferenceNumber": "123456120775",
    "transactionId": "000000000000000",
    "responseCode": "00"
  },
  "reconciliationId": "6886766930876811204951",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2023-06-22T15:50:58Z"
}