Apple Pay - Getting Started
1. Log in to your Portal account. 2. Select “Application” in Developer.
3. Click “Edit App” on the top.

?
4. Input the appropriate information.
Bundle name represents the unique identifier of the application. Domain name represents the URL of the website. You may separate multiple domains with semicolons(;). x Submit Cancel 5.  You may view your app ID, app key, and bundle name here. Application
紹
1. Log in to your Portal account. 2. Select “Create Merchant” on the left hand side. 3.  Click “Create Merchant” on the top. You may not create new merchants in Sandbox environment. Please use the preexisting merchants instead. 4. Input the appropriate information.

Create New Merchant
Fill the merchant info 11 2 Fill the card number 3 Merchant Test Result Description Connected Acquirer " TAISHIN INTERNATIONAL BANK ■ Enable 3D Secure (If enabled, only 3D Secure redirect transaction is supported) │ Create Sub Merchant Merchant ID * Account ID provided by Acquirer, Bank or Processor Submit Cancel
IP Registration
*Please bind your server’s IP address to our server first before testing. 1.  Log in to your Portal account. 3. Select the correct environment. Make sure you choose the right environment on the top. Sandbox environment does NOT share the same allowable IPs as production environment.
4. Input your IP.
This list will bind your server’s IP address to our server. You may separate multiple IPs with semicolons(;). The number after the backslash indicates subnet mask(0~32). Each IPv4 address consists of 32 bits: 8bits.8bits.8bits.8bits So, the range of all IPv4 addresses, in dot-decimal notation, falls between 0.0.0.0 ~ 255.255.255 The subnet mask determines the number of bits that must match your IP address. Please refer to the following example:
1.  Log in to your Portal account. 2.  Select “Account Management” on the top. 3.  Click “Create People”. 4. You may register new accounts and alter their permission status. You may use our default options or change the permission yourself.
1.  Log in to your Portal account. 2. Select “Create Merchant” on the left hand side. 3. Select the merchant you wish to enable this feature.
4. Input the appropriate information. SMS Notification for Transaction Failure Setting
If you enable Apple Pay on the Web Merchant Application Service, you can ignore all the processes in Getting Started > Apple Pay (it means you don’t need to register Apple Pay Developer Account ). You just need to set up the relevant information on TapPay Portal and you will get Apple Pay merchant identifier successfully. Please complete the following steps: 1.  Log in to your Portal account. 2.   Choose Payment methods > Apple Pay on the Web, click 『Create Apple Pay Setting л 3. Fill in domain names, download domain verification file, host the domain verification file under the storage path, and then click 『Submit』 After finishing settings, you will get an Apple Pay merchant identifier. Please 4. use this merchant identifier in the Sandbox environment. If you want to enable this service in the Production environment, please complete following steps : 1.  Contact TapPay Support 2.  Log in to your Portal account. 3.  Go to Activate > Apple Pay on The Web. Fill in the website and agree to the declaration. Foundation Approved ID is required if you are a foundation. 4. You will see the following picture after submitting. 5.  TapPay will send a notification letter to contact person mailbox after reviewing. And you can enjoy your service in the Production environment!
If you meet any condition as below, please complete the following steps. 1. Need a developer account for Web but didn’t purchase [Apple Pay on the Web Merchant Application Service] 2. Need a developer account for App 1.  Log in to your Apple Developer account. If you don’t have one, create one now. Click “Certificates, Identifiers & Profiles.” 2.  Select identifiers and click + button. ✔ Developer Certificates, Identifiers & Profiles Certificates
Q   App IDs PLATFORM Identifier
3.  Select Merchant IDs click Continue button.
Register a New Identifier Continu o o O o C 4. Fill out the appropriate information, click Continue button. Certificates, Identifiers & Profiles < All Identifiers Register a Merchant ID
Identifier
com.domainname.appname). 5. Double check your Merchant ID information, click Register button, create Merchant ID success. Certificates, Identifiers & Profiles < All Identifiers Register a Merchant ID Back Register Description TapPay docs test Identifier merchant.docs.test Back Continue
1.  Select Certificate click + button. Certificates, Identifiers & Profiles
2. Select Service > Apple Pay Payment Processing Certificate, click Continue button. Create a New Certificate Continue macOS Apple Push Notification service SSL (Production) Establish connectivity between your notification server and the Apple Push Notification service production environment. A separate certificate is required for each app you distribute. Pass Type ID Certificate C Sign and send updates to passes in Wallet. Website Push ID Certificate C Sign and send updates for Websites. WatchKit Services Certificate Establish connectivity between your notification server, the Apple Push Notification service sandbox, and production environment to update ClockKit complication data. When utilizing HTTP/2, the same certificate can be used to deliver app notifications, update ClockKit complication data, and alert background VoIP apps of incoming activity. A separate certificate is required for each app you distribute. VoIP Services Certificate o Establish connectivity between your notification server, the Apple Push Notification service sandbox, and production ervironment to alert background VoIP apps of incoming activity. A separate certificate is required for each app you distribute. Apple Pay Payment Processing Certificate o Decrypt app transaction data sent by Apple to a merchant/developer. Apple Pay Merchant Identity Certificate A client TLS certificate that is used to authenticate you to Apple Pay Payment Processing Servers 3. Select the desired Merchant ID, click Continue button. Certificates, Identifiers & Profiles < All Cartificates Create a New Certificate Back Continue Select a Merchant ID for your Apple Pay Payment Processing Certificate Each Marchant ID you identify webni your app wil require its own individual Apple Pay Payment Processing Cartficate. The certificate is used by Apple to encrypt transaction Apple back to the merchant. Merchant ID: T9G64ZZGC4.merchant.docs.test ,
4.   Click Apple Pay Payment Processing Certificate > Create Ceate button.
Identifier
Edit or Configure Merchant ID Remove Save
Identifier merchant.docs.test You cannot use special characters such as @, &, *, '', '' Apple Pay Payment Processing Certificate To configure Apple Pay Payment Processing for this merchant ID, create a Payment Processing Certificate, Apple Pay Payment Processing reguires this certificate to encrypt transaction data. Use the same certificate for Apple Pay Payment Processing in apps or on the web Create an Apple Pay Payment Processing Certificate for this Merchant ID. Create Certificate Apple Pay Payment Processing on the Web To configure Apple Pay Payment Processing on the web for this merchant ID, you must register and verify the domains that will process transactions. You must also create a Apple Pay Merchant Identity, which authenticates your web sessions with the Apple Pay Payment Processing servers. Incorporation of Apple Pay Payment Processing into your website is s subject to these Apple Pay Payment Processing Web Merchant Terms and Conditions and Acceptable Use Guidelines. Failure to comply with any of these Ter ms and Conditions or guidelines may result in deactivation of Apple Pay Payment Processing transactions on your website.
5.   Click Continue button.
Please choose No. TapPay doesn’t support Union Pay for Apple Pay so far. < All Identifiers Edit or Configure Merchant ID Continue Name TapPay docs test Identifier merchant.docs.test Will payments associated with this Merchant ID be processed exclusively in China? ● No ○ Yes
6.
Log in to TapPay Portal, select Payment methods > Apple Pay, click + button. TopPay E Activate   • Developer   o Current Billing

7.
Click payment_processing_certificate.csr download file, Click next button. x Create Apple Pay Merchant Next
8.
See the following screen, continue to step 9 x Create Apple Pay Merchant 2 Upload 9. Go back to apple pay developer, upload your CSR file by clicking “Choose File…” Click “Continue”. All Certificates Create a New Certificate Back Continue Payment Processing Certificato Certificate Signing Regu ually generate a Certificate, you need a Certificate Signing Request (CSR) file from your 10. Click download button download apple_pay.cer file. < All Certificates Download Your Certificate Certificate Details
11. Back to TapPay Portal, click choose apple_pay.csr button and upload the 12. On the Apple Pay page, you can see the newly created Apple Pay in App, and you can start to develop (refer to Frontend> Apple Pay in Apps); if you need to create Apple Pay on the Web, please complete the follow-up actions
1. Select Certificate click + button. Certificates, Identifiers & Profiles
2. Select Apple Pay Merchant Identity Certificate, Click Continue button. Create a New Certificate Continus Services o iOS Apple Push Notification service SSL (Sandbox) Establish connectivity between your notification server and the Apple Push Notification service sandbox ervironment to deliver remote notifications to your app. A separate certificate is required for each app you develop. macOS Apple Push Notification service SSL (Sandbox) o Establish connectivity between your notification server and the Apple Push Notification service sandbox environment. A separate certificate is required for each app you develop. Apple Push Notification service SSL (Sandbox & Production) o Establish connectivity between your notification server, the Apple Push Notification service sandbox, and production environments to deliver remote notifications to your app. When utilizing HTTP/2, the same certificate can be used to deliver app notifications, update ClockKit complication data, and alert background VoIP apps of incoming activity. A separate certificate is required for each app you distribute macOS Apple Push Notification service SSL (Production) o Establish connectivity between your notification server and the Apple Push Notification service production environment. A separate certificate is required for each app you distribute. O Pass Type ID Certificate Sign and send updates to passes in Wallet. Website Push ID Certificate o Sign and send updates for Websites. o WatchKit Services Certificate Establish connectivity between your notification server, the Apple Push Notification service sandbox, and production environment to update ClockKit complication data. When utilizing HTTP/2, the same certificate can be used to deliver app notifications, update ClockKit complication data, and alert background VoIP apps of incoming activity. A separate certificate is required for each app you distribute. o VolP Services Certificate Establish connectivity between your notification server, the Apple Push Notification service sandbox, and essailism connectivity between your nothically of ver, the support our form formats of not surfaces, and for each app you distribute. o Apple Pay Payment Processing Certificate Decrypt app transaction data sent by Apple to a merchant/developer Apple Pay Merchant Identity Certificate o A client TLS certificate that is used to authenticate you to Apple Pay Payment Processing Serve
3. Select desired MerchantID, click Continue button.
All Certificates Create a New Certificate Back Continue Select a Merchant ID for your Apple Pay Merchant Identity Certificate Each Merchant ID you identify within your app will require its own individual Apple Pay Merchant Identify Certificate. The certificate is used is used to authenticate you to Processing servers 464ZZGC4.merchant.docs.tes 4. Log in to TapPay Portal Apple Pay, select desired Apple merchant identifier and 5. Click Apple Pay on the web > Upload Certificate Merchant Identifier: [中? 6. Download merchant_identity_certificate.csr Update Merchant Identity Certificate
7.
See the following screen, continue to step 8
x Update Merchant Identity CertificateのUpload
Upload your CSR file by clicking “Choose File…”
8.
Certificates Create a New Certificate Back Continue Pay Merchant Identity Certi transally peperate a Certificat herchant_identity_certificate (2).cs
9.   Go back to TapPay Portal, Click Download.
< All Certificates Download Your Certificate Revoke Download Certificate Details
Apple Pay Merchant Identity
Download your certificate to your Mac, then double click the .cer file to install in Keychain Access. Make sure to save a backup copy of your private and public keys somewhere secure.
10. Upload the resulting .cer file back to TapPay Portal.
Update Merchant Identity Certificate
1. Select Certificate click + button. Certificates, Identifiers & Profiles Certificates O
2.   Select Service > Apple Pay Payment Processing Certificate, click Continue button. Create a New Certificate Continue macOS Apple Push Notification service SSL (Production) Establish connectivity between your notification server and the Apple Push Notification service production environment. A separate certificate is required for each app you distribute. C Pass Type ID Certificate Sign and send updates to passes in Wallet. Website Push ID Certificate Sign and send updates for Websites. WatchKit Services Certificate Establish connectivity between your notification server, the Apple Push Notification service sandbox, and production environment to update ClockKit complication data. When utilizing HTTP/2, the same certificate can be used to deliver app notifications, update ClockKit complication data, and alert background VoIP apps of incoming activity. A separate certificate is required for each app you distribute. o VoIP Services Certificate Establish connectivity between your notification server, the Apple Push Notification service sandbox, and production environment to alert background VoIP apps of incoming activity. A separate certificate is required for each app you distribute. o Apple Pay Payment Processing Certificate Decrypt app transaction data sent by Apple to a merchant/developer. Apple Pay Merchant Identity Certificate A client TLS certificate that is used to authenticate you to Apple Pay Payment Processing Servers 3. Select desired MerchantID, Click Continue button. Certificates, Identifiers & Profiles < All Certificates Create a New Certificate Back Continue Select a Merchant ID for your Apple Pay Payment Processing Certificate Each Merchant ID you identify within your app will require its own individual Apple Pay Payment Processing Certificate. The certificate is used by Apple to encrypt transacti Apple back to the merchant. Merchant ID: T9364ZZGC4.merchant.docs.test
4.   Click Add Domain button.
Apple Pay Payment Processing on the Web
To configure Apple Pay Payment Processing on the web for this merchant ID, you must register and verify the domains that will process transactions. You must also create a Apple Pay Merchant Identity, which authenticates your web sessions with the Apple Pay Payment Processing servers. Incorporation of Apple Pay Payment Processing into your website is subject to these Apple Pay Payment Processing Web Merchant Terms and Conditions and Acceptable Use Guidelines. Failure to comply with any of these Terms and Conditions or guidelines may result in deactivation of Apple Pay Payment Processing transactions on your website.
Merchant Domains
Add a domain for use with this Merchant ID. Apple Pay Merchant Identity Certificate Name: merchant.docs.test Type:  Apple Pay Merchant Identity Expires: Jul 19, 2021 Create an Apple Pay Merchant Identity Certificate for this Merchant ID. Create Certificate
5. Fill out your domain.
< View Identifier Register Save To use Apple Pay Payment Processing on the web you must register and verify your fully qualified domain name. To begin enter your domain below. Enter the domain you wish to register https:// tappaysdk.docs 6. Download the verification file and host it in the designated path. Click “Verify” after you are done. < View Identified Verify Download Verify Instructions and Information To verify ownership of your domain download the file and place it at the location listed below. After uploading your file confinue with the verification step. We'll look for your file at the following location: https://tappaysdk.docs/.well-known/apple-developer-merchantid-domain-association.txt 7. Go back to TapPay Portal payment methods> Apple Pay, select the Apple Pay merchant ID you want to use, and click i o # 8. Go to Apple Pay on the web, fill out the domain, click save Merchant Identifier: Apple Pay Apple Pay on the Web Domain test.com.tw ? 9.   Apple Pay on the web is established. Please go to Frontend> Apple Pay on the Web to start develop TopPay E Current Billing Activate   - Developer   -
Q1 : How to solve the following error when create Merchant ID  ? This error means that your naming does not comply with Apple regulations. Please change your name and press Register
Q2 : How to renew the certificate ?
Apple will notify the merchant one month before the certificate expires, you can update the certificate according to the following process Go to TapPay Portal, select the Apple Merchant ID of the voucher to be updated, and click i 1. TapPay ■ # ? 2. Click Update Certificate, select the certificate just created, upload the update certificate Merchant Identifier: Apple Pay Apple Pay on the Web Domain 3. Please re-apply for Payment Processing Certificate and Merchant Identify Certificate *When you apply for a new certificate, the following screen will appear Please click Activate   (The old certificate will be revoke) c All Certificates Download Your Certificate Activate Revoke Download Certificate Details Certificate Name Certificate Type Apple Pay Payment Processing Expiration Date 2022/06/21 Created By Download your certificate to your Mac, then double click the .cer file to install in Keychain Access. Make sure to save a backup copy of your private and public keys somewhere secure. (When you already have two sets of certificates, Apple will ask you if you want to activate the new certificate)
Q3 : Domain verification failed
If continuous verification is not possible, please cooperate with your IT staff to perform the following tests 1.   Use SSL checker (https://www.sslshopper.com/ssl-checker.html)   › Confirm whether the SSL certificate has reached A + level 2. All pages containing Apple Pay must have HTTPS, which is necessary in both formal and test environments. In the development environment, you can meet the needs of HTTPS through the ngrok service. You can refer to our Ngrok tutorial