Apple Pay iFrame

The Apple Pay iFrame allows your platform to offer a digital wallets solution to merchants. The iFrame is an embeddable component that can be hosted on the checkout page for merchants. Merchants' customers can choose Apple Pay as a contactless alternate method of payment.

Requirements

1. Download the SDK for iFrame
2. Enable and configure Apple Pay
3. Set up the domain verification file
4. Apple Pay tokenized bundle is received from the iFrame, which is is then processed by WePay
5. Ensure that email and notification functionality is available through the triggers
   • payments.created
   • payments.updated
   • payments.completed
   • payments.failed

Apple requires additional verification of the domains that will host/contain the Apple Pay button. Before payments can be accepted via Apple Pay, the platform or the merchant must register all domains that will host the Apple Pay button.

Domain verification steps:

1. Download the verification file that Apple provides. This file will be the same for all WePay merchants:Download Domain Verification File
   
   
2. Host the domain verification file in the following format: https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association.
3. In your codebase or the merchant’s codebase, make sure the verification file is in a folder called .well-known.
4. Apple will make a request to https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association (no filename extension) and verify the file.
5. Apple will check that the file is hosted at the provided URL to verify the domain.

	{
		"domain_names": ["https://example.com", "https://example2.com", "https://example3.com", "...etc"],
		"merchant_url": "http://merchantdomain.com",
		"partner_merchant_name": "Merchant Selling a Product or Service, Inc."
	}

	{
		"domain_names": ["https://example.com", "https://example2.com", "https://example3.com", "...etc"],
		"reason": "Changed domain"
	}

If the you are hosting the merchant's domain for them, then you would register all their merchant's domains and host the verification file either via Partner Center or via an API interaction.

If the merchant has a sub-domain within your domain or if they have their own e-commerce website, they can register their domains themselves using Merchant Center.

Response Schema

{
	"domain_names": ["https://example.com", "https://example2.com", "https://example3.com", "...etc"],
	"merchant_url": "http://merchantdomain.com",
	"partner_merchant_name": "Merchant Selling a Product or Service, Inc."
}