Payment processing certificates
As part of your integration with Apple Pay, you need to create a Merchant ID and a Payment Processing Certificate. This process must be done according to the guidance below for your platform to be able to process Apple Pay payments with Mangopay.
How to set up your Payment Processing Certificate
Prerequisites
- Enrollment in the Apple Developer Program
1. Create your Apple Pay Merchant ID using the Mangopay format
The Apple Pay Merchant ID is a unique identifier that identifies your platform to Apple Pay. You need a separate Merchant ID for each Mangopay ClientId, in both Sandbox and Production. You can use the same Merchant ID for more than one website or iOS app.
Use the formats below to create your Apple Pay Merchant ID. Note that Apple Pay auto-populates the merchant. prefix shown below.
Sandbox:
merchant.com.mangopay.
ClientId.sandbox
Production:
merchant.com.mangopay.
ClientId
Warning - Respect the Merchant ID formatting
Because the Apple Pay merchant identifier must match the processing certificate that will be created by Mangopay, it is important to respect the nomenclature above.
2. Send your Merchant ID to Mangopay
Once generated, send your Merchant ID to Mangopay by contacting the Support team via the Dashboard.
Mangopay will generate a Certificate Signing Request (CSR) file and return it to you.
3. Create your Payment Processing Certificate with the CSR file
Once you receive the CSR file from Mangopay, follow the Apple Pay process to create – but not activate – a Payment Processing Certificate.
During this process, upload the CSR file when you create a certificate signing request.
Warning - Do not activate your certificate
You must not activate your Payment Processing Certificate at this stage - only create it.
4. Download and send the CER file to Mangopay
Download the Payment Processing Certificate’s CER file and send it to Mangopay Support team via the Dashboard.
5. Await confirmation from Mangopay
Mangopay will use the CER file to finalize the configuration of Apple Pay on your Mangopay API environment. One of our team members will confirm that everything is ready.
6. Activate your certificate
Once you have received confirmation from Mangopay that everything is ready, activate your Payment Processing Certificate.
Renewal
Your certificate has limited validity and expires every 25 months.
The process to renew your certificate is the same as when you created it first time. You create a new certificate which, when activated, automatically revokes the previous one.
When your certificate is nearing expiry, Mangopay will send you a CSR file for your ClientId.
Once you receive the CSR file from Mangopay, follow the Apple Pay process to create – but not activate – a Payment Processing Certificate.
During this process, upload the CSR file when you create a certificate signing request.
Warning - Do not activate your certificate
You must not activate your Payment Processing Certificate when you create it. Activation must be done later once you have received confirmation from Mangopay.
Follow Steps 4 to 6 above to complete the renewal of your certificate.
Related resources
Payment processing certificates
As part of your integration with Apple Pay, you need to create a Merchant ID and a Payment Processing Certificate. This process must be done according to the guidance below for your platform to be able to process Apple Pay payments with Mangopay.
How to set up your Payment Processing Certificate
Prerequisites
- Enrollment in the Apple Developer Program
1. Create your Apple Pay Merchant ID using the Mangopay format
The Apple Pay Merchant ID is a unique identifier that identifies your platform to Apple Pay. You need a separate Merchant ID for each Mangopay ClientId, in both Sandbox and Production. You can use the same Merchant ID for more than one website or iOS app.
Use the formats below to create your Apple Pay Merchant ID. Note that Apple Pay auto-populates the merchant. prefix shown below.
Sandbox:
merchant.com.mangopay.
ClientId.sandbox
Production:
merchant.com.mangopay.
ClientId
Warning - Respect the Merchant ID formatting
Because the Apple Pay merchant identifier must match the processing certificate that will be created by Mangopay, it is important to respect the nomenclature above.
2. Send your Merchant ID to Mangopay
Once generated, send your Merchant ID to Mangopay by contacting the Support team via the Dashboard.
Mangopay will generate a Certificate Signing Request (CSR) file and return it to you.
3. Create your Payment Processing Certificate with the CSR file
Once you receive the CSR file from Mangopay, follow the Apple Pay process to create – but not activate – a Payment Processing Certificate.
During this process, upload the CSR file when you create a certificate signing request.
Warning - Do not activate your certificate
You must not activate your Payment Processing Certificate at this stage - only create it.
4. Download and send the CER file to Mangopay
Download the Payment Processing Certificate’s CER file and send it to Mangopay Support team via the Dashboard.
5. Await confirmation from Mangopay
Mangopay will use the CER file to finalize the configuration of Apple Pay on your Mangopay API environment. One of our team members will confirm that everything is ready.
6. Activate your certificate
Once you have received confirmation from Mangopay that everything is ready, activate your Payment Processing Certificate.
Renewal
Your certificate has limited validity and expires every 25 months.
The process to renew your certificate is the same as when you created it first time. You create a new certificate which, when activated, automatically revokes the previous one.
When your certificate is nearing expiry, Mangopay will send you a CSR file for your ClientId.
Once you receive the CSR file from Mangopay, follow the Apple Pay process to create – but not activate – a Payment Processing Certificate.
During this process, upload the CSR file when you create a certificate signing request.
Warning - Do not activate your certificate
You must not activate your Payment Processing Certificate when you create it. Activation must be done later once you have received confirmation from Mangopay.
Follow Steps 4 to 6 above to complete the renewal of your certificate.