Attributes

• METHOD TYPEE-wallet
• PAYMENTS
• PAYOUTS
• REFUNDS
• RECURRING

Introduction

Apple Pay was launched in 2014 as a mobile payment method by Apple. It allows users to make payments in person, in iOS apps and on the Web. It works similarly to other NFC technology-based mobile payments, such as Google Pay or Samsung Pay. In addition, the Apple Pay payments require two-factor authentication via Touch ID, Face ID, PIN or passcode.

Apple Pay is an external token provider, a type of entity in the payment industry with its own flow that typically collects the customer payment method and transaction details. In some cases, they perform 3D-Secure authentication and provide the 3D-Secure authentication values. The first time a customer uses a card in the Apple Pay system, Apple Pay performs 3DS authentication and stores the 3DS values from the successful authentication in an Apple Pay token.

This guide describes how to implement Apple Pay using Nuvei REST API 2.0.

Supported Countries

• Australia
• Austria
• Belarus
• Belgium
• Brazil
• Bulgaria
• Canada
• China
• Croatia
• Cyprus
• Czech Republic
• Denmark
• Estonia
• Faroe Islands
• Finland
• France
• Georgia
• Germany
• Greece
• Greenland
• Guernsey
• Hong Kong
• Hungary
• Iceland
• Ireland
• Isle of Man
• Italy
• Japan
• Jersey
• Kazakhstan
• Latvia
• Liechtenstein
• Lithuania
• Luxembourg
• Macau
• Malta
• Monaco
• Netherlands
• New Zealand
• Norway
• Poland
• Portugal
• Romania
• Russia
• San Marino
• Saudi Arabia
• Singapore
• Slovakia
• Slovenia
• Spain
• Sweden
• Switzerland
• Taiwan
• Ukraine
• United Arab Emirates
• United Kingdom
• United States
• Vatican City

Supported Currencies

Apple Pay supports all currencies supported by Nuvei.

Implementation

Follow these steps to implement Apple Pay using Nuvei REST API 2.0:

1. Register with Apple Pay.
2. Integrate Apple Pay for payments – Nuvei decrypts the Apple Pay token.
3. .

Upon completion, customers are able to make payments using Apple Pay.

Payments – Nuvei Decrypts Token

The Apple Pay token contains Apple Pay authentication values from a successful Apple Pay authentication. The merchant sends the encrypted Apple Pay token as-is in a non-3DS /payments request. Nuvei decrypts the token and uses the relevant data extracted from it.

Send a non-3DS POST /payments request with its mandatory parameters and include:

• paymentOption block with:
  • store: “none“
  • eWallet block with:
    • provider: “ApplePay“
    • token: “<encrypted token merchant received from Apple Pay>“

Example Apple Pay /payments Request

{
  "processingEntityId": "<your processingEntityid>",
  "amount": 10.5,
  "currency": "USD",
  "paymentOption": {
    "store": "none",
    "eWallet": {
      "provider": "ApplePay",
      "token": "<encrypted token merchant received from Apple Pay>"
    }
  },
  "deviceDetails": {
    "ipAddress": "<customer's IP address>"
  },
  "buyerDetails": {
    "email": "[email protected]",
    "billingAddress": {
      "countryCode": "US"
    }
  }
}

Example Apple Pay /payments Response

{
  "paymentId": 493981,
  "transactionId": "1110000000009241613",
  "externalTransactionId": "211011237407",
  "amount": 10.5,
  "currency": "USD",
  "transactionType": "auth",
  "result": {
    "status": "approved"
  },
  "authCode": "465190",
  "partialApproval": {
    "requestedAmount": 10.5,
    "requestedCurrency": "USD"
  },
  "paymentOption": {
    "eWallet": {
      "provider": "ApplePay",
      "expirationMonth": "11",
      "expirationYear": "26"
    }
  },
  "providerResponseDetails": {}
}