API Overview

Recent Revisions to This Document

About This Guide

VISA Platform Connect: Specifications and Conditions for Resellers/Partners

Introduction to Apple Pay
- Requirements for Using Apple Pay
- Supported Card Types and Optional Features
- Payment Processors
  - Visa Platform Connect Acquirers
- Apple Pay Integrations and Payload Decryption Methods
  - Flow of Apple Pay In-App Transactions Processed Using Cybersource Decryption
  - Flow of Apple Pay In-App Transactions Processed Using Merchant Decryption
  - Flow of Apple Pay Web Transactions Using Cybersource Decryption
  - Flow of Apple Pay Web Transactions Using Merchant Decryption

Configuring Apple Pay Processing
- Generating and Loading a New Certificate Signing Request
- Configuring Apple Pay Response Handling

Processing Apple Pay Transactions
- Authorization Service
- Authorizations Using Cybersource Decryption for JCB
  - Required Fields for Authorizing a Payment Using Cybersource Decryption for JCB
  - Optional Fields for Authorizing a Payment for Apple Pay Transactions
  - Simple Order XML Example: Cybersource Decryption and JCB
- Authorizations Using Cybersource Decryption for mada
  - Required Fields for Authorizing a Payment Using Cybersource Decryption for mada
  - Optional Fields for Authorizing a Payment for Apple Pay Transactions
  - Simple Order XML Example: Cybersource Decryption for mada
- Authorizations Using Cybersource Decryption for Mastercard
  - Required Fields for Authorizing a Payment Using Cybersource Decryption for Mastercard
  - Optional Fields for Authorizing a Payment for Apple Pay Transactions
  - Simple Order XML Example: Cybersource Decryption for Mastercard
- Authorizations Using Cybersource Decryption for Visa
  - Required Fields for Authorizing a Payment Using Cybersource Decryption for Visa
  - Optional Fields for Authorizing a Payment for Apple Pay Transactions
  - Simple Order XML Example: Cybersource Decryption for Visa
- Authorizations Using Merchant Decryption for JCB
  - Required Fields for Authorizing a Payment Using Merchant Decryption for JCB
  - Optional Fields for Authorizing a Payment for Apple Pay Transactions
  - Simple Order XML Example: Merchant Decryption and JCB
- Authorizations Using Merchant Decryption for mada
  - Required Fields for Authorizing a Payment Using Merchant Decryption for mada
  - Simple Order XML Example: Merchant Decryption and mada
- Authorizations Using Merchant Decryption for Mastercard
  - Required Fields for Authorizing a Payment Using Merchant Decryption for Mastercard
  - Optional Fields for Authorizing a Payment for Apple Pay Transactions
  - Simple Order XML Example: Merchant Decryption and Mastercard
- Authorizations Using Merchant Decryption for Visa
  - Required Fields for Authorizing a Payment Using Merchant Decryption for Visa
  - Optional Fields for Authorizing a Payment for Apple Pay Transactions
  - Simple Order XML Example: Merchant Decryption and Visa
- Authorization Reversals
  - Required Fields for Processing an Authorization Reversal
  - Simple Order Example: Processing an Authorization Reversal
- Captures
  - Required Fields for Capturing an Authorization
  - Simple Order Example: Capturing an Authorization
- Sales
  - Required Fields for Processing a Sale
  - Simple Order Example: Processing a Sale

Searching for Apple Pay Transactions

Authorization Reversals

This section provides the information you need in order to process an authorization reversal.

Reversing an authorization releases the hold on the customer’s payment card funds that the issuing bank placed when processing the authorization.

Supported Card Types

All supported card types can process reversals. For a list of all supported card types, see Payment Processors.

Endpoint

Set the

ccAuthReversalService_run

field to

true

.

Send the request to

https://ics2ws.ic3.com/commerce/1.x/transactionProcessor

.

Required Fields for Processing an Authorization Reversal

card_cardType: For Visa Platform Connect, when reversing the authorization of an Apple Pay transaction on the mada Pay mobile app, set this field to
060
. Apple Pay transactions on the mada Pay app are supported for these cards issued in the Kingdom of Saudi Arabia:
mada debit and prepaid cards
Mastercard payment cards co-badged with mada
Visa payment cards co-badged with mada
ccAuthReversalService_authRequestID: Set this field to the request ID that was included in the authorization response message.
ccAuthReversalService_run: Set this field to
true
.
merchantReferenceCode
merchantTransactionIdentifier
purchaseTotals_currency
purchaseTotals_grandTotalAmount: The amount of the reversal must be the same as the authorization amount that was included in the authorization response message. Do not use the amount that was requested in the authorization request message.

Authorization Reversals

Simple Order Example: Processing an Authorization Reversal

Request

ccAuthReversalService_authRequestID=6522033834410167772169
ccAuthReversalService_run=true
merchantReferenceCode=482046C3A7E94F5BD1FE3C66C
merchantTransactionIdentifier=Napa Valley Vacations
purchaseTotals_currency=USD
purchaseTotals_grandTotalAmount=49.95

Response to a Successful Request

requestID=1019827520348290570293
merchantReferenceCode=482046C3A7E94F5BD1FE3C66C
decision=ACCEPT
reasonCode=100
ccAuthReversalReply_amount=49.95
purchaseTotals_currency=USD
ccAuthReversalReply_reasonCode=100
ccAuthReversalReply_reconciliationID=1094820975023470

Authorization Reversals

Back to top