Plexy
Pay API
Gate APISDKDashboard
Pay API
Gate APISDKDashboard
  1. Wallets
  • Overview
  • Authorization
  • Webhooks
  • API Errors
  • Test Scenarios
  • Ecommerce Plugins
  • API
    • Payments
      • Overview
      • Transaction Errors
      • Payment Links
        • Create Payment Link
        • List Payment Links
        • Retrieve Payment Link by Order Reference
        • Cancel Payment Link
        • Retrieve Payment Link
        • Update Payment Link Expiration
        • Retrieve Payment Links Statistics
      • Reccurent Payments
        • Create Merchant-Initiated Payment
      • Direct Payments
        • Get Keys
        • Create Host-to-Host Payment
      • Transaction Management
        • Find Transaction's History by ID
        • Find Transaction by Payment Link ID
        • Find Transaction by ID
        • Find Transaction by Order reference
      • Payment Management
        • Cancel Payment
        • Capture Payment
        • Process Refund
      • Split Requests
        • Create
        • List
        • Update
        • Get By Id
        • Delete
    • Payouts
      • Retrieve Payout Transactions
      • Process Payout
      • Save Card for Payouts
    • Customers
      • Get Customer's Card Tokens
      • List Customers
      • Create Customer
      • Get Customer by ID
      • Get Customer's Transactions
    • Merchants
      • Payment Beneficiary
        • Create
        • Update
        • Gey By Id
        • List
        • Transfer from beneficiary balance to merchant balance
        • Create manual settlement for beneficiary
      • Retrieve Merchant's Details
    • Wallet
      • Authorize
      • Сapture
      • Refund
      • Cancel
    • Payment Methods
      • Google Pay™ Integration
    • Invoice
      • List Bank Invoices
      • Create Bank Invoice
      • Get Bank Invoice
    • Distributions
      • Create distribution
      • List distributions
      • Get distribution by ID
      • Get distributions balance
  • Client SDK
    • Server flow
      • Session server flow
    • Web
      • Web Drop-in
      • Web iFrame
    • Flutter
      • Flutter Drop-in
    • Wallets
      • Apple Pay Web SDK Integration
      • Apple Pay Moible Integration
      • Google Pay Integration
  • Schemas
    • Schemas
      • response.TransactionList
      • entity.SplitRequest
      • entity.PaymentBeneficiary
      • request.CreatePaymentBeneficiary
      • entity.SettlementPaymentOrder
      • entity.PayoutRequest
      • entity.PayoutRequestRowData
      • entity.UserProfile Copy
      • entity.Store
      • request.AssignStoreToUser
      • request.RemoveStoreFromUser
      • entity.AccountExternalSystem
      • response.AssignStoreToUser
      • request.CreateStore
      • response.Store
      • response.UserList
      • request.WalletAuthorizeRequest
      • entity.ShortWalletTransaction
      • response.WalletAuthorizeResponse
      • request.WalletCapture
      • response.RemoveStoreFromUser
      • command.HandleThreeDResult
      • domain.Report
      • entity.CardSaveSessionCustomer
      • entity.Permission
      • entity.UserProfile
      • entity.UserRole
      • git_plexypay_com_ecom_back_api_internal_domain_view.Page-domain_Report
      • git_plexypay_com_ecom_back_api_internal_domain_view.Page-entity_UserProfile
      • models.CSVApiRequest
      • models.CreateBussinessDetails
      • models.KeyResponse
      • models.OnboardingRequest
      • models.Transaction
      • paymentcore.Address
      • paymentcore.CustomerDetails
      • request.AuthorizePayment
      • request.BrowserDetails
      • request.CardData
      • request.ChangeUserRole
      • request.ContinueThreeDS
      • request.CreateCardSaveSession
      • request.CreateInviteSession
      • request.CreatePaymentLink
      • request.CreatePaymentLinkMetadata
      • request.HandlePayout
      • request.MerchantInitiatedPayment
      • request.PasswordRequest
      • request.Recurring
      • request.RefundPayment
      • request.SaveCard
      • request.SaveOneCustomer
      • request.TwoStepAuthorizePayment
      • request.UpdateMerchantSettingsRequest
      • request.UpdatePaymentLink
      • response.AcquirerResponseThreeDSecure
      • response.AuthorizeAndCapturePayment
      • response.AuthorizePayment
      • response.CancelPaymentResponse
      • response.CapturePaymentResponse
      • response.ContinueThreeDS
      • response.Currency
      • response.Customer
      • response.CustomerTransaction
      • response.CustomerTransactions
      • response.Customers
      • response.Merchant
      • response.MerchantInitiatedPayment
      • response.MerchantSettings
      • response.PaymentLink
      • response.PaymentLinkInfo
      • response.PaymentLinkMetadata
      • response.PaymentLinksInfo
      • response.PaymentLinksStatistics
      • response.PaymentLinksStatisticsItem
      • response.Payout
      • response.Permission
      • response.RefundPaymentResponse
      • response.Report
      • response.SavedCard
      • response.Session
      • response.Settlement
      • response.SettlementTransaction
      • response.Store
      • response.Stores
      • response.Transaction
      • response.TransactionDetails
      • response.TransactionEvents
      • response.TransactionHistoryEvent
      • response.TransactionHistoryEventData
      • response.TransactionResponse
      • response.TransactionWebhookDetails
      • response.Transactions
      • response.UpdateMerchantSettingsResponse
      • response.UserProfile
      • value.PaymentMethod
    • receipt
    • Error
    • response.BankInvoice
    • DistributionStatus
    • DecimalAmount
    • errors.Source
    • Currency
    • ProductType
    • errors.Message
    • DistributionRecipient
    • ProductCategory
    • request.CreateBankInvoice
    • DistributionCreateRequest
    • Product
    • git_plexypay_com_ecom_back_api_internal_platform_errors.Code
    • DistributionBase
    • response.Error
    • Order
    • DistributionCreatedResponse
    • AgentBalance
    • response.BankInvoiceList
    • DistributionDetailResponse
    • AgentDeposit
    • errors.Type
    • DistributionListItem
    • TopupRequest
    • DistributionListResponse
    • CreateOrderRequest
    • DistributionBalanceResponse
  1. Wallets

Apple Pay Web SDK Integration

This guide applies only to Apple Pay integration through Plexy WebSDK.
INFO
If you use Plexy Hosted Checkout through Payment Links, Apple Pay works out of the box. No additional Apple Pay domain verification is required from your side.
WARNING
The steps below are required only when Apple Pay is displayed directly on your website through Plexy WebSDK.

Before You Start#

Make sure you have:
RequirementDescription
Plexy accountYou need access to Plexy Dashboard.
Website domainExample: shop.example.com.
Plexy WebSDK integrationPayment components must be integrated on your website.
Integration manager contactYour Plexy technical integration manager must receive your domain list.

Setup Flow#

1. Merchant prepares the list of domains.
2. Merchant sends all domains to the Plexy technical integration manager.
3. Plexy registers the domains on its side.
4. Merchant downloads the Apple Pay domain verification file from Plexy Dashboard.
5. Merchant uploads the verification file to the website server.
6. Merchant verifies the domain in Plexy Dashboard.
7. Merchant configures WebSDK payment components with merchantName.
8. Apple Pay becomes available in Plexy WebSDK.

Step 1. Prepare Domain List#

Prepare all domains where Apple Pay will be used.
Examples:
shop.example.com
checkout.example.com
example.com
WARNING
Send every domain where the Plexy WebSDK payment components can be displayed.
If Apple Pay is shown on a domain that was not registered and verified, Apple Pay may not appear or may fail during payment.

Step 2. Send Domains to Plexy#

Send the full domain list to your Plexy technical integration manager.
INFO
Plexy must register the merchant domains on its side before you can complete domain verification in Plexy Dashboard.

Step 3. Wait for Plexy Confirmation#

Plexy will register the provided domains for Apple Pay processing.
After registration, your technical integration manager will confirm that you can continue with domain verification in Plexy Dashboard.
WARNING
Do not skip this step. Domain verification in Plexy Dashboard should be done only after Plexy confirms that the domain has been registered.

Step 4. Open Apple Pay Domain Verification in Plexy Dashboard#

Open Plexy Dashboard and go to:
Web Integration
→ Apple Pay Domain Verification
You will see:
registered domains;
domain verification instructions;
verification file download button;
domain input field;
verification action.

Step 5. Download Verification File#

Click:
Download verification file
The file name must be:
apple-developer-merchantid-domain-association
WARNING
Do not rename the file.

Step 6. Upload Verification File to Your Server#

Upload the file to your website server at this exact path:
/.well-known/apple-developer-merchantid-domain-association
For example, if your domain is:
shop.example.com
the file must be available at:
https://shop.example.com/.well-known/apple-developer-merchantid-domain-association
WARNING
The file must be publicly accessible over HTTPS.

Step 7. Check File Availability#

Open the file URL in a browser:
https://shop.example.com/.well-known/apple-developer-merchantid-domain-association
Expected result:
HTTP status is 200;
the file opens without redirect loops;
the file is not blocked by firewall, CDN, WAF, or authentication;
the file content is not modified by your server.
INFO
If your website uses CDN or reverse proxy, make sure the .well-known path is served correctly.

Step 8. Verify Domain in Plexy Dashboard#

Return to Plexy Dashboard.
Enter your domain:
shop.example.com
Click:
Verify domain
If verification is successful, the domain will appear in the registered domains list.
The domain is ready for Apple Pay when it is shown as verified in Plexy Dashboard.

Step 9. Configure WebSDK Payment Components#

How to Check Merchant Name#

Open Plexy Dashboard and go to:

Settings

→ Merchant Settings

→ merchantName (example: 85aa27ef-321a-49cb-934f-59b2fdfae290)

Step 10. Test Apple Pay#

After domain verification and WebSDK configuration, test Apple Pay on the verified domain.
Check that:
Apple Pay button is displayed;
Apple Pay sheet opens;
merchant name is displayed correctly;
payment token is created successfully;
payment is processed by Plexy.
INFO
Apple Pay is available only in supported browsers, devices, regions, and cards.

Common Errors#

ErrorCauseHow to fix
Apple Pay button is not displayedDomain is not verifiedVerify the domain in Plexy Dashboard
Domain verification failsFile is missing or unavailableCheck the .well-known file URL
Verification file returns 404File uploaded to the wrong pathUpload it to /.well-known/apple-developer-merchantid-domain-association
Verification file redirectsServer/CDN redirects the requestServe the file directly with HTTP 200
Apple Pay fails in WebSDKDomain was not registered by PlexySend the domain to your Plexy integration manager
Merchant name is missingmerchantName is not configuredAdd merchantName to WebSDK payment components config
Wrong merchant name is displayedIncorrect merchantName valueUpdate merchantName in WebSDK config
Modified at 2026-06-18 13:54:49
Previous
Flutter Drop-in
Next
Apple Pay Moible Integration
Built with