| Tabla de Contenido |
|
|
Accept payments with Apple Pay in your integration with Kushki. Depending on the solution you use (Smartlink/Button or Custom Integration), the configuration process varies.
🚧 BETA: Limited Availability 🇵🇪 🇨🇱
Please note that Apple Pay is currently in Beta phase. This feature is available only for merchants in Chile and Peru, and processes transactions exclusively with Visa and Mastercard cards.
1. Direct Integrations (Payment Button and Smartlinks)
If you use Payment Button (Webcheckout) or Smartlinks, the technical integration is already solved. However, you must manually enable this option in your Kushki Console.
When creating or editing your Smartlink or Payment Button in the Console, make sure to enable the Apple Pay toggle in the "Payment Methods" section.
- Smartlinks: Refer to the step-by-step guide for activating Apple Pay in Smartlinks.
- Payment Button: Refer to the guide for activating Apple Pay in Payment Buttons.
2. Custom Integrations (Libraries and Kajita)
If you use Kushki.js (v1 or v2 - hosted fields) or kajita, domain verification is necessary to guarantee your website is authorized to process Apple Pay payments.
ℹ️ Prerequisites: Before starting, ensure you have access to the Kushki Console, specifically the Configuration module.
Paso 1: Request the verification file
To validate your domain, you need the Apple merchant association file (apple-developer-merchantid-domain-association).
- Contact the Kushki Support team.
- Request the Apple Pay Configuration Certificate.
- Specify the environment you require the file for: Testing (UAT) or Production.
❗ Important: Verification files are unique for each environment. Ensure you request and use the correct file for UAT or Production respectively.
Paso 2: Host the file on your server
Once Kushki provides the file, you must host it on your web server. Apple requires this file to be publicly accessible via HTTPS at a specific path.
Create a folder named .well-known at the root of your domain and place the downloaded file there. The final URL should look like this:
https://your-domain.com/.well-known/apple-developer-merchantid-domain-association
You can verify the file is correctly hosted by running the following command in your terminal or simply pasting the URL into your browser:
curl -I https://your-domain.com/.well-known/apple-developer-merchantid-domain-association
You must receive a 200 OK response and the file must be downloadable or visible.
Paso 3: Domain registration in Kushki Console
With the file correctly hosted, the final step is to register your domain in our platform to finalize the association.
- Log in to the Kushki Console.
- Go to Configuration > Integrations.
- Find the Apple Pay section.
- Enter your domain URL (example:
your-domain.com) in the corresponding field. - Click Register or Verify.
At this moment, Kushki will communicate with Apple to verify that the file exists on your server. If everything is correct, the domain will be verified.
Paso 4: Technical Implementation
Once the domain is verified, proceed with the technical implementation according to your integration method:
- Kajita: Follow the guide to activate Apple Pay in your Kajita form.
- Kushki.js v2 (Hosted Fields): Review the Apple Pay integration in v2 documentation.
- Kushki.js v1: Consult the one-time payment examples to see the implementation.
Do I need an Apple Developer account?
No. Since you use Kushki as your payment processor, we manage the certificate complexity with Apple. You only need to host the file we provide to prove you own the domain.