Skip to content
A sample implementation of Apple Pay JS using ASP.NET Core
Branch: master
Clone or download
Latest commit 13f4d45 Feb 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add stale app config Jul 29, 2018
.vscode Update to ASP.NET Core 2.2.0 Nov 18, 2018
src/ApplePayJS
.editorconfig Update EditorConfig settings Dec 7, 2018
.gitattributes Setup CI Aug 15, 2017
.gitignore Fix content not being served from .well-known Aug 19, 2017
.travis.yml Use Xenial in Travis CI Feb 12, 2019
ApplePayJS.sln Use final ASP.NET Core 2.1 release May 26, 2018
Build.ps1 Refactor package installation Dec 7, 2018
CODE_OF_CONDUCT.md Add community documents Feb 13, 2018
LICENSE Update LICENSE boilerplate Sep 20, 2016
NuGet.config
README.md Update to ASP.NET Core 2.2.2 Feb 12, 2019
appveyor.yml
build.sh Remove obsolete build script args Feb 12, 2019
global.json Update to ASP.NET Core 2.2.2 Feb 12, 2019

README.md

Apple Pay JS Example Integration

Linux Windows
Build Status Build status Build status

This repository contains a sample implementation of Apple Pay JS using ASP.NET Core 2.2 written in C# and JavaScript.

Overview

Apple Pay JS is a way of accepting Apple Pay in websites using Safari in either iOS 10 and macOS for users who have a TouchID compatible device.

This example integration shows a minimal sample of how to integrate Apple Pay into a webpage to obtain an Apple Pay token that can be used to capture funds for a user for goods and services.

The key components to look at for the implementation are:

  • src\ApplePayJS\Views\Home\Index.cshtml - The view that renders the Apple Pay button.
  • src\ApplePayJS\wwwroot\css\site.css - The CSS used to style the Apple Pay button.
  • src\ApplePayJS\wwwroot\js\site.js - The JavaScript that performs the majority of the Apple Pay functionality.
  • src\ApplePayJS\Controllers\HomeController.cs - The controller that performs the POST to the Apple Pay service to verify a merchant session.

Setup

To setup the repository to run the sample, perform the steps below:

  1. Install the .NET Core 2.2.104 SDK, Visual Studio 2017 or Visual Studio Code.
  2. Fork this repository.
  3. Clone the repository from your fork to your local machine: git clone https://github.com/{username}/ApplePayJSSample.git
  4. Restore the Bower, npm and NuGet packages.
  5. Follow the steps to obtain your Apple Pay Merchant ID, Payment Processing Certificate, Domain Verification file and Merchant Identity Certificate if you do not already have them.
  6. Place the Domain Verification file (apple-developer-merchantid-domain-association) in the src\ApplePayJS\wwwroot\.well-known folder.
  7. Generate a .pfx file from your Merchant Identity Certificate (merchant_id.cer, which is the public key) and the Certificate Signing Request (your_file_name.csr, which is the private key) that you used to generate it.
  8. Either add your .pfx file to the root of the application in src\ApplePayJS (but not in the wwwroot folder) or install it into the local certificate store.
  9. Update the Apple touch icon (src\ApplePayJS\wwwroot\apple-touch-icon.png) and favicon (src\ApplePayJS\wwwroot\favicon.ico) to your own designs.
  10. Configure the following settings as appropriate in either your environment variables or in src\ApplePayJS\appsettings.json: * ApplePay:StoreName * ApplePay:UseCertificateStore * ApplePay:MerchantCertificateThumbprint or ApplePay:MerchantCertificateFileName
  11. Configure the following setting in either your environment variables, your user secrets or in src\ApplePayJS\appsettings.json (not recommended) if loading the .pfx file from disk (i.e. ApplePay:UseCertificateStore=false): * ApplePay:MerchantCertificatePassword
  12. Deploy the application to the hosting environment for the domain where you wish to use Apple Pay JS.
  13. Verify the domain in the Apple Developer Portal.

You should now be able to perform Apple Pay JS transactions on the deployed application.

Local Debugging

You should be able to debug the application in Visual Studio Code or Visual Studio 2017 (15.3 or later).

Azure App Service Deployment

If you are deploying the sample application to a Microsoft Azure App Service Web App, you will need to make the following configuration changes to your Web App for the sample application to run correctly:

  • Navigate to the SSL certificates tab of your Web App and upload your Apple Merchant certificate as a .pfx file, making a note of the THUMBPRINT value.
  • Navigate to the Application settings tab of your Web App and add the following settings:
    • WEBSITE_LOAD_CERTIFICATES to the value of THUMBPRINT you noted above.
    • ApplePay:MerchantCertificateThumbprint to the value of THUMBPRINT you noted above.
    • ApplePay:UseCertificateStore to the value of true.
    • Save the changes.
  • Ensure the hostname you are using (either {yourappname}.azurewebsites.net or a custom hostname that you have set up) has been added in the Apple Developer portal to your merchant Id and you've added the Apple Pay domain validation file as described in the Setup section above.

Feedback

Any feedback or issues can be added to the issues for this project in GitHub.

License

This project is licensed under the Apache 2.0 license.

External Links

You can’t perform that action at this time.