Recent Revisions to This Document

About This Guide

VISA Platform Connect: Specifications and Conditions for Resellers/Partners

Introduction to Payments
- Financial Institutions and Payment Networks
  - Merchant Financial Institutions (Acquirers)
  - Issuing (Customer) Financial Institutions
  - Payment Networks
  - Payment Processors
- Card Types
  - Co-Branded Cards
  - Credit Cards
  - Debit Cards
  - Prepaid Cards
  - Private Label Cards
  - Quasi-Cash
- Transaction Types
  - Card-Not-Present Transactions
  - Card-Present Transactions
  - Authorizations with Card Verification Numbers
    - CVN Locations and Terminology
  - Token Management Service
- Payment Services
  - Authorizations
    - payments-intro-processing-auth-micropayment
    - Online Authorizations
    - Offline Authorizations
    - Incremental Authorizations
      - Example: Incremental Authorization
    - Payment Network Token Authorizations
    - Authorization Workflow
  - Authorization Reversals
  - Captures
    - Capture Workflow
  - Credits
    - Credit Workflow
  - Capture or Credit Voids
  - Sales
    - Dual Message Processing
      - Partial Authorizations
    - Single Message Processing
- Payment Features
  - Card-Present Authorizations
  - Debit and Prepaid Card Payments
  - Airline Data
    - Visa Acceptance Solutions Airline Data Processing
    - Airline Travel Legs
    - Airline Data Reference Information
      - Airline Document Type Codes
      - Ancillary Service Category Codes
  - Interchange Optimization
  - Japanese Payment Options
  - Level II and Level III Data
  - Mastercard Bill Payments
  - Mastercard Expert Monitoring Solutions
  - Merchant-Initiated Authorization Reversals
  - Merchant-Initiated Capture Voids
  - Merchant-Initiated Credit Voids
  - Payer Authentication
  - Split Shipments
  - Stored Credentials
  - Token Management Service

Standard Payments Processing
- Basic Authorizations
  - Declined Authorizations
  - Required Fields for Processing a Basic Authorization
  - Simple Order Example: Processing a Basic Authorization
- Authorizations with Line Items
  - Optional Line Item Fields
  - Required Fields for Processing an Authorization with Line Items
    - Country-Specific Required Fields for Processing an Authorization with Line Items
  - Simple Order Example: Processing an Authorization with Line Items
- Authorizations with Payment Network Tokens
  - Supported Processors and Card Types
  - Required Fields for Authorizations with Payment Network Tokens
  - Optional Fields for Authorizations with Payment Network Tokens
  - pnt-ex-so
- Authorizations with a Card Verification Number
  - Required Fields for Processing an Authorization with a Card Verification Number
  - Optional Fields for Processing an Authorization with a Card Verification Number
  - Simple Order Example: Processing an Authorization with a Card Verification Number
- Authorizations with the DCC Gateway Service
  - Required Fields for Processing DCC Authorizations
    - Country-Specific Required Fields for Processing a DCC Authorization
  - Simple Order Example: Processing a Basic Authorization
- Authorizations with Strong Customer Authentication Exemption
  - Required Fields for Processing an Authorization with an SCA Exemption
  - payments-processing-pa-sca-exampts-ex-so
- Zero Amount Authorizations
  - Required Fields for Processing a Zero Amount Authorization
    - Country-Specific Required Fields for Processing a Zero Amount Authorization
  - Simple Order Example: Processing a Zero Amount Authorization
- Incremental Authorizations
  - Required Fields for Processing an Incremental Authorization
    - Country-Specific Required Fields for Processing an Incremental Authorization
  - Optional Fields for Processing an Incremental Authorization
  - Simple Order Example: Processing an Incremental Authorization
- Authorization Reversal
  - Required Fields for Processing an Authorization Reversal
  - Simple Order Example: Processing an Authorization Reversal
- Capture
  - Required Fields for Capturing an Authorization
  - Simple Order Example: Capturing an Authorization
- Multiple Captures
  - Required Fields for Processing Multiple Captures
  - Simple Order Example: Processing Multiple Partial Captures
- Follow-On Credits
  - Required Fields for Processing a Follow-On Credit
  - Simple Order Example: Processing a Follow-On Credit
- Stand-Alone Credit
  - Required Fields for Processing a Stand-Alone Credit
  - Simple Order Example: Processing a Stand-Alone Credit
- Sales
  - Required Fields for Processing a Sale
  - Simple Order Example: Processing a Sale
- Void
  - Required Fields for Processing a Void

Card Present Connect | Retail Processing
- Authorization with Contact EMV and Online PIN
  - Required Fields for Processing an Authorization with Contact EMV and Online PIN
  - Simple Order 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
  - Simple Order 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
  - Simple Order Example: Processing an Authorization with Contactless EMV and Online PIN
- Card-Present Authorizations for Cash Advances with Credit Cards
  - Required Fields for Processing an Authorization for a Cash Advance
  - Optional Fields for Processing an Authorization for a Cash Advance
  - Simple Order Example: Processing an Authorization for a Cash Advance
- Capture
  - Required Fields for Capturing an Authorization
  - Capturing an Authorization Using SO APIs
  - Simple Order Example: Capturing an Authorization

Card Present Connect | Mass Transit Processing
- Card Present Connect | Mass Transit Developer Guide
- Performing a Discover Authorization with EMV Data
- Mass Transit Mastercard Authorization with EMV Data
  - Required Fields for a Mastercard Authorization with EMV Data Using the REST API
  - Required Fields for a Mastercard Authorization with EMV Data in Europe Using the REST API
  - Performing a Mastercard Authorization with EMV Data Using the REST API
- Mass Transit Visa Account Verification Request (AVR) with EMV Data
  - Required Fields for a Visa AVR Authorization with EMV Data Using the REST API
  - Performing a Visa AVR Authorization with EMV Data Using the REST API
- Performing a Discover Sale with EMV Data
- Mass Transit Visa Deferred Sale with EMV Data
  - Required Fields for a Visa Deferred Sale with EMV Data Using the REST API
  - Performing a Visa Deferred Sale with EMV Data Using the REST API
- Mass Transit Authorizations for a Tap-Initiated Debt Recovery with EMV Data
  - Required Fields for a Tap-Initiated Authorization for Debt Recovery with EMV Data Using the REST API
  - Required Fields for a Tap-Initiated Authorization for Debt Recovery with EMV Data for Mastercard in Europe Using the REST API
  - Performing a Tap-Initiated Authorization for Debt Recovery with EMV Data Using the REST API
- Mass Transit Merchant-Initiated Authorizations for Debt Recovery with Stored Card Data
  - Required Fields for a Merchant-Initiated Authorization for Debt Recovery with Stored Card Data Using the REST API
  - Required Fields for a Merchant-Initiated Authorization for Debt Recovery with Stored Card Data for Mastercard in Europe Using the REST API
  - Performing a Merchant-Initiated Authorization for Debt Recovery with Stored Card Data Using the REST API
- Mass Transit Tap-Initiated Sales for Debt Recovery with EMV Data
  - Required Fields for a Tap-Initiated Sale for Debt Recovery with EMV Data Using the REST API
  - Required Fields for a Tap-Initiated Sale for Debt Recovery with EMV Data for Mastercard in Europe Using the REST API
  - Performing a Tap-Initiated Sale for Debt Recovery with EMV Data Using the REST API
- Mass Transit Merchant-Initiated Sales for Debt Recovery with Stored Card Data
  - Required Fields for a Merchant-Initiated Sale for Debt Recovery with Stored Card Data Using the REST API
  - Required Fields for a Merchant-Initiated Sale for Debt Recovery with Stored Card Data in Europe Using the REST API
  - Performing a Merchant-Initiated Sale for Debt Recovery with Stored Card Data Using the REST API
- Mass Transit Stand-Alone Credits with Card Data
  - Required Fields for a Stand-Alone Credit with Card Data Using the REST API
  - Performing a Stand-Alone Credit with Card Data Using the REST API
- Mass Transit Captures
  - Required Fields for a Mass Transit Capture Using the REST API
  - Capturing a Mass Transit Authorization Using the REST API
- Mass Transit Authorization Reversals
  - Required Fields for a Mass Transit Authorization Reversal Using the REST API
  - Reversing a Mass Transit Authorization Using the REST API
- Mass Transit Timeout Reversal
  - Required Fields for a Timeout Reversal Using the REST API
  - Performing a Timeout Reversal Using the REST API
- Mass Transit Timeout Voids
  - Required Field for a Timeout Void Using the REST API
  - Performing a Timeout Void Using the REST API

Debit and Prepaid Card Processing
- Processing Debit and Prepaid Authorizations
  - Required Fields for Processing Debit and Prepaid Authorizations
    - Country Specific Required Fields to Process Debit and Prepaid Authorizations
  - Optional Field for Processing Debit and Prepaid Authorizations
  - Simple Order Example: Processing Debit and Prepaid Authorizations
- Enabling Debit and Prepaid Partial Authorizations
  - Required Fields for Enabling Debit and Prepaid Partial Authorizations
  - Optional Field for Enabling Debit and Prepaid Partial Authorizations
  - Simple Order Example: Enabling Debit and Prepaid Partial Authorizations
- Disabling Debit and Prepaid Partial Authorizations
  - Required Field for Disabling Debit and Prepaid Partial Authorizations
  - Optional Field for Disabling Debit and Prepaid Partial Authorizations
  - Simple Order Example: Disabling Debit and Prepaid Partial Authorizations

Airline Data Processing
- Visa Platform Connect Airline Authorizations
  - Required Fields for Authorizing an Airline Payment
  - Simple Order Example: Authorizing an Airline Payment
- Visa Platform Connect Airline Captures for Ticket Purchases
  - Required Fields for Capturing an Airline Payment
    - Card-Specific Field to Capture an Airline Payment
  - Optional Fields for Capturing an Airline Payment
  - Simple Order Example: Capturing an Airline Payment
- Visa Platform Connect Airline Captures for Ancillary Purchases
  - Required Fields for Capturing an Authorization for Ancillary Purchases
  - Ancillary Fields for Capturing an Authorization for an Ancillary Purchase
  - Simple Order Example: Capturing an Authorization for an Ancillary Purchase
- Visa Platform Connect Airline Follow-On Credits
  - Required Fields for Processing an Airline Follow-On Credit
  - Optional Fields for Processing an Airline Follow-On Credit
  - Simple Order Example: Processing an Airline Follow-On Credit
- Visa Platform Connect Airline Stand-Alone Credits
  - Required Fields for Processing an Airline Stand-Alone Credit
  - Optional Fields for Processing an Airline Stand-Alone Credit
  - Simple Order Example: Processing an Airline Stand-Alone Credit

Japanese Payment Options Processing
- Authorize a Single Payment with Japanese Payment Options
  - Required Fields for Authorizing a Single Payment Using the JPO Method
  - Simple Order Example: Authorizing a JPO Single Payment
- Authorize a Bonus Payment with Japanese Payment Options
  - Required Fields for Authorizing a JPO Bonus Payment
  - Simple Order Example: Authorizing a JPO Bonus Payment
- Authorize an Installment Payment with Japanese Payment Options
  - Required Fields for Authorizing a JPO Installment Payment
  - Simple Order Example: Authorizing a JPO Installment Payment
- Authorize a Revolving Payment with Japanese Payment Options
  - Required Fields for Authorizing a Revolving Payment Using the JPO Method
  - Simple Order Example: Authorizing a JPO Installment Payment
- Authorize a Combination Payment with Japanese Payment Options
  - Required Fields for Authorizing a Combination Payment Using the JPO Method
  - Simple Order Example: Authorizing a JPO Combination Payment

Level II Processing
- Captures with Level II Data
  - Required Fields for Capturing a Payment with Level II Data
  - Optional Fields for Capturing a Payment with Level II Data
- Stand Alone Credits with Level II Data
  - Required Fields for Processing a Stand Alone Credit with Level II Data
  - Optional Fields for Processing a Stand Alone Credit with Level II Data
- Sales with Level II Data
  - Required Fields for Processing a Sale with Level II Data
  - Optional Fields for Processing a Sale with Level II Data

Level III Processing
- Captures with Level III Data
  - Required Fields for Capturing a Payment with Level III Data
  - Optional Fields for Capturing a Payment with Level III Data
- Stand Alone Credits with Level III Data
  - Required Fields for Processing a Stand Alone Credit with Level III Data
  - Optional Fields for Processing a Stand Alone Credit with Level III Data
- Sales with Level III Data
  - Required Fields for Processing a Sale with Level III Data
  - Optional Fields for Processing a Sale with Level III Data

Mastercard Bill Payment Processing
- Required Fields for Authorizing a Mastercard Bill Payment
- Simple Order Example: Authorizing a Mastercard Bill Payment

Mastercard Expert Monitoring Solutions Processing
- Required Fields for Processing an Authorization with Mastercard Expert Monitoring Solutions
- Response Field for Authorizations with Mastercard Expert Monitoring Solutions
- Simple Order Example: Obtaining the Mastercard Fraud Score for an Authorization

Merchant-Initiated Authorization Reversals
- Required Fields for Processing a Merchant-Initiated Authorization Reversal
- Simple Order Example: Processing a Merchant-Initiated Authorization Reversal

Merchant-Initiated Capture Voids
- Required Fields for Processing a Merchant-Initiated Capture Void
- Example: Processing a Merchant-Initiated Capture Void Using the SO API

Merchant-Initiated Credit Voids
- Required Fields for Processing a Merchant-Initiated Credit Void

Payer Authentication Processing
- Providing Payer Authentication Information for Authorization
- American Express SafeKey
  - Required Fields for Processing an Authorization Using American Express SafeKey
  - Optional Field for Processing an Authorization Using American Express SafeKey
  - Simple Order Example: Processing an Authorization Using American Express SafeKey
- JCB J/Secure
  - Required Fields for Processing an Authorization Using JCB J/Secure Authentication
  - Simple Order Example: Processing an Authorization Using JCB J/Secure Authentication
- Mastercard Identity Check
  - Required Fields for Processing an Authorization Using Mastercard Identity Check
  - Simple Order Example: Processing an Authorization Using Mastercard Identity Check
- Visa Secure
  - Required Fields for Processing an Authorization Using Visa Secure
  - Simple Order Example: Processing an Authorization Using Visa Secure

Split Shipments Processing
- Authorizing a Sale for a Product Not Yet Available
- Processing Two Authorizations and a Capture for Multiple Products
- Processing an Authorization and Two Captures for Multiple Products

Processing Payments Using Credentials
- Customer-Initiated Transactions with Credentials on File
  - Storing Customer Credentials with a Customer-Initiated Transaction
    - Required Fields for Storing Customer Credentials During a Customer-Initiated Transaction
    - Simple Order Example: Storing Customer Credentials During a Customer-Initiated Transaction
  - Using Stored Customer Credentials During a Customer-Initiated Transaction
    - Required Fields for Retrieving Customer Credentials During a Customer-Initiated Transaction
      - Card-Specific Required Field for Retrieving Customer Credentials During a Customer-Initiated Transaction
    - Simple Order Example: Retrieving Customer Credentials During a Customer-Initiated Transaction
- Merchant-Initiated Delayed Transaction
  - Required Fields for Processing a Merchant-Initiated Delayed Transaction
    - Card-Specific Required Field for Processing a Merchant-Initiated Transactions
  - Simple Order Example: Processing a Merchant-Initiated Delayed Authorization Transaction
- Merchant-Initiated Incremental Transaction
  - Required Fields for Processing Merchant-Initiated Incremental Transactions
    - Card-Specific Required Field for Processing a Merchant-Initiated Transactions
  - Simple Order Example: Processing Merchant-Initiated Incremental Transactions
- Merchant-Initiated No-Show Transactions
  - Required Fields for Processing Merchant-Initiated No-Show Charges
    - Card-Specific Required Field for Processing a Merchant-Initiated Transactions
  - Optional Field for Processing Merchant-Initiated No-Show Charges
  - Simple Order Example: Processing Merchant-Initiated No-Show Transactions
- Merchant-Initiated Reauthorization Transactions
  - Required Fields for Processing Merchant-Initiated Reauthorized Transactions
    - Card-Specific Required Field for Processing a Merchant-Initiated Transactions
  - Simple Order Example: Processing a Merchant-Initiated Reauthorized Transaction
- Merchant-Initiated Resubmission Transaction
  - Required Fields for Processing a Merchant-Initiated Resubmitted Transaction
    - Card-Specific Required Field for Processing a Merchant-Initiated Transactions
  - Simple Order Example: Processing a Merchant-Initiated Resubmitted Transaction
- Installment Payments
  - Initial Customer-Initiated Installment Payments with a PAN
    - Required Fields for Authorizing Customer-Initiated Initial Installment Payments with a PAN
    - Simple Order Example: Authorizing Initial Customer-Initiated Installment Payments with a PAN
  - Merchant-Initiated Subsequent Installment Payments
    - Required Fields for Authorizing Merchant-Initiated Subsequent Installment Payments
      - Card-Specific Required Field for Retrieving Customer Credentials During a Customer-Initiated Transaction
      - India-Specific Required Fields for Installment Payments
    - Simple Order Example: Authorizing Merchant-Initiated Subsequent Installment Payments
  - Installments for Installment Payments
- Recurring Payments
  - Recurring Billing for Recurring Payments
  - Initial CIT Recurring Payment with a PAN
    - Required Fields for Authorizing Initial Recurring Payments Using Simple Order API
    - Simple Order Example: Authorizing an Initial CIT Recurring Payment with a PAN
  - Subsequent MIT Recurring Payments
    - Required Fields for Authorizing Subsequent Recurring Payments
      - Card-Specific Required Fields for Authorizing Subsequent Recurring Payments
      - Country-Specific Required Fields for Authorizing Subsequent Recurring Payments
    - Simple Order Example: Authorizing Subsequent Recurring Payments
- Mastercard Standing Order Payments
  - Mastercard Initial CIT Standing Order Payment
    - Required Fields for Authorizing Initial CIT Standing Order Payments
    - Simple Order Example: Authorizing Initial CIT Standing Order Payments
- Mastercard Subscription Payments
  - Mastercard CIT Initial Subscription Payment
    - Required Fields for Authorizing CIT Initial Subscription Payments
    - Simple Order Example: Authorizing Initial CIT Subscription Payments
- Unscheduled COF Payments
  - Initial CIT Unscheduled COF Payment
    - Required Fields for Authorizing Initial CIT Unscheduled COF Payments
    - Simple Order Example: Authorizing Initial CIT Unscheduled COF Payments
  - Subsequent MIT Unscheduled COF Payments
    - Required Fields for Authorizing Subsequent MIT Unscheduled COF Payments
      - Card-Specific Required Field for Processing a Merchant-Initiated Transactions
      - Country-Specific Required Fields for Authorizing Subsequent Recurring Payments
    - credentials-mit-unsched-optfields
    - Simple Order Example: Authorizing Subsequent MIT Unscheduled COF Payments

Token Management Service Processing
- Authorize a Payment with a Customer Token
  - tms-cust-tkn-pay-reqfields
- Authorize a Payment with a Non-Default Shipping Address
  - tms-ship-addr-make-pay-nondefault-ship-addr-reqfie
- Authorize a Payment with Non-Default Payment Instrument
  - tms-cust-pi-tkn-pay-nondefault-pi-reqfields
  - tms-cust-pi-tkn-pay-nondefault-pi-optfields
- Authorize a Payment with a Payment Instrument
  - tms-pi-tkn-pay-reqfields
  - tms-pi-tkn-pay-optfields
- Authorize a Payment with an Instrument Identifier
  - tms-ii-tkn-pay-reqfields
- Authorize a Payment with Legacy Token
  - tms-legacy-tkn-pay-reqfields
- Make a Credit with a Customer Token
  - tms-cust-tkn-credit-reqfields
- Make a Credit with Non-Default Payment Instrument
  - tms-cust-pi-tkn-credit-nondefault-pi-reqfields
  - tms-cust-pi-tkn-credit-nondefault-pi-optfields
- Make a Credit with a Payment Instrument
  - tms-pi-tkn-credit-reqfields
- Make a Credit with an Instrument Identifier
  - tms-ii-tkn-credit-reqfields
- Make a Credit with Legacy Token
  - tms-legacy-tkn-credit-reqfields

On This Page

Simple Order API | Visa Platform Connect

Optional Fields for Authorizations with Payment Network Tokens

billTo.city
billTo.country
billTo.email
billTo.firstName
billTo.lastName
billTo.postalCode: Required only for transactions in the U.S. and Canada.
billTo.state: Required only for transactions in the U.S. and Canada.
billTo.street1
card.accountNumber: Set to the token value that you received from the token service provider.
card.cardType: It is strongly recommended that you send the card type even if it is optional for your processor. Omitting the card type can cause the transaction to be processed with the wrong card type.
card.expirationMonth: Set to the token expiration month that you received from the token service provider.
card.expirationYear: Set to the token expiration year that you received from the token service provider.
ccAuthService.cavv: For 3-D Secure in-app transactions for Visa and JCB, set to the 3-D Secure cryptogram. Otherwise, set to the network token cryptogram.
ccAuthService.commerceIndicator
ccAuthService.networkTokenCryptogram
ccAuthService.run: Set to
true
.
merchantID
merchantReferenceCode
purchaseTotals.currency
purchaseTotals.grandTotalAmount or item_#.unitPrice
paymentNetworkToken.transactionType
paymentNetworkToken.requestorID: Required on Visa Platform Connect
ucaf.authenticationData: For Mastercard requests, set this field to the Identity Check cryptogram.
ucaf.collectionIndicator: For Mastercard requests, set this field to
2
.

Back to top