Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
gateways:apple-pay [2017/07/20 16:31] – created vladimirgateways:apple-pay [2020/11/25 08:45] (current) – [Creating Merchant Identity Apple Pay Certificate] adam
Line 1: Line 1:
 ---- dataentry gateway ---- ---- dataentry gateway ----
-type            : gateway         # do not change this line+type               : gateway # do not change this line 
 +name               : Apple Pay (Auth.Net) 
 +countries          : US 
 +support-added      : 2.0 
 +support-removed    : 
 +auth-net-emulation :  # enter "yes" or "no" (without quotes) 
 +supports-3dsecure  : no # enter "yes" or "no" (without quotes) 
 +gateway_url        : https://www.apple.com/apple-pay/ 
 +----
  
-# Add the full name of the gateway after the colon below. 
-name            : Apple Pay(Auth.Net) 
  
-# Supported Countries. Please use 2-character ISO Country Codes available at 
-# http://www.iso.org/iso/english_country_names_and_code_elements 
-# Separate multiple country codes by commas. 
-countries       : US 
  
-# Enter the FoxyCart versions where support was added or removed (if applicable). 
-# Version numbers should include applicable decimals, such as "0.7.0" and not "070" 
-support-added   : 2.0 
-support-removed :  
  
-# Features and Details +====== Apple Pay (Auth.Net======
-auth-net-emulation :  # enter "yes" or "no" (without quotes) +
-supports-3dsecure  :  # enter "yes" or "no" (without quotes)+
  
-# Gateway URL +<WRAP round tip> 
-gateway_url     https://www.apple.com/apple-pay/ +**NOTEApple Pay in Foxy is changing soon** 
-----+Please reach out to us if you'd like to enable Apple PayWe're working on a method that makes it much easier than described in this page. 
 +</WRAP>
  
- +<WRAP round alert> 
-====== Apple Pay(Auth.Net) ======+**In the EU? Contact us.** 
 +Authorize.net is not supporting 3D Secure, which makes it less useful for EU merchants moving forward. Please contact us to discuss alternatives and/or Apple Pay. 
 +</WRAP>
 ===== Setting Up Apple Pay for FoxyCart ===== ===== Setting Up Apple Pay for FoxyCart =====
-Apple Pay requires an Apple development and Authorise.Net accounts+Apple Pay requires an Apple development and Authorize.net account.
  
 ==== Obtaining an Apple Merchant id ==== ==== Obtaining an Apple Merchant id ====
  
 First of all create account on https://developer.apple.com, after that register a Merchant ID: First of all create account on https://developer.apple.com, after that register a Merchant ID:
-  - In Member Center, select Certificates, Identifiers & Profiles. + 
-  - Under Identifiers, select Merchant IDs.+{{ :gateways:apple_pay_account.png?nolink&600 |}} 
 + 
 +  - In the "Account" section, select "Certificates, Identifiers & Profiles"
 +  - Under "Identifiers", select "Merchant IDs".
   - Click the Add button (+) in the upper-right corner.   - Click the Add button (+) in the upper-right corner.
   - Enter a description and identifier, and click Continue.   - Enter a description and identifier, and click Continue.
Line 58: Line 60:
   - In the Apple Pay section, click Sign Up.   - In the Apple Pay section, click Sign Up.
  
-==== Generating the CSR ==== +==== Generating the CSR and Apple Pay Payment Processing Certificate ==== 
-You must submit a Certificate Signing Request (CSR) to Apple in order to receive a necessary payment entitlement certificate.+You must submit a Certificate Signing Request (CSR) to Apple in order to receive a necessary Payment Processing Certificate.
  
 To generate the CSR: To generate the CSR:
Line 69: Line 71:
  
  
-==== Submitting the CSR file to Apple(creating Payment Processing Apple Pay Certificate) ==== +After you have the CSR, you need to submit it to Apple within your Apple Developer account in order to generate the required Payment Processing Certificate
-You must submit the CSR to Apple in order to receive the required payment entitlement certificate.+
  
-To submit the CSR file to Apple:+  - Within the Apple Developer account, proceed to the "Certificates, Identifiers & Profiles" section and select "Identifiers" from the sidebar 
 +  - Under "Identifiers", select "Merchant IDs" using the filter in the top-right. 
 +  - On the right, select your merchant identifier. 
 +  - Under "Apple Pay Payment Processing Certificate", click Create Certificate. 
 +  - Upload the CSR you received from Authorize.Net 
 +  - If renewing the certificate - you may need to click "Activate" on the new certificate to replace the existing one.
  
-  Navigate to the Apple World Wide Developer Relations (WWDR) website & Member Center & Certificates, Identifiers. +You don't need to do anything with this certificate but it needs to be generated and activated to ensure Authorize.Net is able to process the payment details coming via Apple PayIt will also need to be renewed before it expires (by completing this and the previous step again), but you should receive a notice by email from Apple when this is coming up
-  - Under Identifiers, select Merchant IDs. +==== Creating Apple Pay Merchant Identity Certificate ====
-  - Select the merchant ID from the list, and click Edit. +
-  - In the Payment Processing Certificates section, click Create CertificateFollow the instructions to obtain or generate your certificate signing request (CSR), and click Continue+
-  - Click Choose File, select your CSR, and click Generate.+
  
- +  - Navigate to the [[https://developer.apple.com|Apple Developer]] website and login if not already. 
-==== Creating Merchant Identity Apple Pay Certificate ==== +  - Once logged inproceed to the "Account" section and then to the "Certificates, Identifiers & Profiles" section
- +  - Under "Identifiers", select "Merchant IDs".
-  - Navigate to the Apple World Wide Developer Relations (WWDR) website In Member Centerselect Certificates, Identifiers & Profiles. +
-  - Under Identifiers, select Merchant IDs.+
   - Select the merchant ID from the list, and click Edit.   - Select the merchant ID from the list, and click Edit.
-  - In the Merchant Identity Certificate section, click Create Certificate. Follow the instructions to obtain or generate your certificate signing request (CSR), and click Continue.+  - In the "Apple Pay Merchant Identity Certificatesection, click Create Certificate. Follow the instructions to obtain or generate your certificate signing request (CSR), and click Continue.
   - Click Choose File, select your CSR, and click Generate.   - Click Choose File, select your CSR, and click Generate.
   - Download the certificate by clicking Download, and click Done.   - Download the certificate by clicking Download, and click Done.
-  - Double-click downloaded file to insert it into keychain access.app. this should automatically get appended to the existing entry for your Private key in keychain access.app +  - Double-click downloaded file to insert it into keychain access.app. This should automatically get appended to the existing entry for your Private key in keychain access.app, within the "My Certificates" category. 
-  - Right-click that certificate (probably named "Merchant ID: merchant...." from within keychain access.app (you may need to expand the private key entry to see the certificate under it) and select "Export 'Merchant ID merchant....' "This will default to exporting xxxx.p12 file to your desktop.+  - Right-click that certificate (probably named "Merchant ID: merchant...." from within keychain access.app (you may need to expand the private key entry to see the certificate under it) and select "Export 'Merchant ID merchant....' "You will need to export as ''.p12'' filetype, which it should be selected as default. 
 +  - You will be prompted to "enter a password which will be used to protect the exported items". Enter a password here, and make note of it, as it will be entered as the "merchant identity cert password" in your Foxy payment settings.
  
 ==== Verify domain ==== ==== Verify domain ====
-Good 'How To' you can read here https://developer.apple.com/documentation/applepayjs  
  
 +You will need to verify your FoxyCart store domain, to provide permission for Apple Pay to be presented as an option to customers there.
 +
 +To do that, you will need to register and verify your store's domain within your Apple Developer account. Apple have a guide on doing that here: https://help.apple.com/developer-account/#/dev1731126fb.
 +
 +For the domain, you would use your FoxyCart store subdomain, either in the standard format of ''https://yourstore.foxycart.com'' or ''https://store.yourdomain.com'' if you have a custom subdomain configured for your store.
 +
 +After registering the domain, you will be presented with a file - you will specify this as part of the settings for Apple Pay on the "Payments" section of your store's Foxy administration, for the ''domain validate file'' option. After saving the file in your payment settings, you will then be able to verify the domain within your Apple Developer account.
 ==== Set up the Apple Pay Sandbox ==== ==== Set up the Apple Pay Sandbox ====
 To use Apple Pay while developing your site, you'll need to use the Apple Pay Sandbox. Getting it set up takes just a few minutes. To use Apple Pay while developing your site, you'll need to use the Apple Pay Sandbox. Getting it set up takes just a few minutes.

Site Tools