Apple Pay on the Web — Platform Integrator: Is sub-merchant registration required when all transactions occur on a single hosted domain?

Hi Apple Pay Team,

We are building a QR-based payment platform and planning to integrate Apple Pay on the Web as a Payment Platform Integrator.

Our setup:

  • We operate a single domain (e.g., pay.example.com) where all Apple Pay transactions take place
  • When a customer scans a merchant's QR code, our hosted page opens with the Apple Pay button
  • We process payments on behalf of multiple merchants (receivers), each with a separate merchant ID at our payment processor
  • We want to use a single Payment Platform Integrator ID with one set of certificates (Merchant Identity + Payment Processing)
  • The payment processor handles sub-merchant identification and settlement to the correct receiver via card network (Visa/Mastercard) sub-merchant fields

Our question:

Since all transactions happen on our single domain, is it mandatory to register each sub-merchant via the Apple Pay Web Merchant Registration API (/paymentservices/registerMerchant) and use their partnerInternalMerchantIdentifier in the payment session request?

Or is it acceptable to use our Platform Integrator's own merchant identifier for all payment sessions, given that:

  • Only one domain is involved

  • Sub-merchant identification is handled at the payment processor / card network level

  • Our domain verification file is already hosted and verified

We would appreciate clarity on the correct approach before we proceed with our integration.

Thank you.

Answered by DTS Engineer in 893825022

Hi @maggiesha,

You wrote:

[...] Since all transactions happen on our single domain, is it mandatory to register each sub-merchant via the Apple Pay Web Merchant Registration API (/paymentservices/registerMerchant) and use their partnerInternalMerchantIdentifier in the payment session request? [...] Or is it acceptable to use our Platform Integrator's own merchant identifier for all payment sessions, given that: [...]

Please see my answer on the following post:

Apple Pay with one domain and several PSP integration

https://developer.apple.com/forums/thread/818826?answerId=893846022#893846022

Cheers,

Paris X Pinkney |  WWDR | DTS Engineer

Hi @maggiesha,

You wrote:

[...] Since all transactions happen on our single domain, is it mandatory to register each sub-merchant via the Apple Pay Web Merchant Registration API (/paymentservices/registerMerchant) and use their partnerInternalMerchantIdentifier in the payment session request? [...] Or is it acceptable to use our Platform Integrator's own merchant identifier for all payment sessions, given that: [...]

Please see my answer on the following post:

Apple Pay with one domain and several PSP integration

https://developer.apple.com/forums/thread/818826?answerId=893846022#893846022

Cheers,

Paris X Pinkney |  WWDR | DTS Engineer

Apple Pay on the Web — Platform Integrator: Is sub-merchant registration required when all transactions occur on a single hosted domain?
 
 
Q