Sign in

v1

latestOpenAPI 3.0.02026-08-0631139237.5 KB
Apple Pay Certificate

Activate Certificate

Activates an Apple Pay certificate by uploading the signed certificate from Apple.

After creating a certificate in the Apple Developer Portal using your CSR, download the signed certificate and upload it here to activate payment processing.

Activation process

  1. Ensure you have downloaded the signed certificate (.cer file) from Apple Developer Portal.

  2. Convert the certificate to base64:

    base64 -i apple_pay.cer

  3. Call this endpoint with the base64-encoded certificate in the cert field.

Validation

The certificate is validated to ensure:

  • It matches the private key generated when creating the CSR
  • It has a valid expiration date

Once activated, the certificate becomes available for decrypting Apple Pay payment tokens in your iOS app.

Notes

  • A certificate can only be activated once.
  • After successful activation, the CSR is no longer returned in responses.
  • The certificate's expiration date is returned in the expireAt field once activated.
post/apple-pay/certificates/{id}/activate

Path parameters

idstring required
Example:a6ea0c67-d061-4f7c-9e3b-4a96a6e1e8b1

The unique identifier of the certificate.

Request body

certstring required

The signed certificate from Apple in base64 format. Download this from Apple Developer Portal after creating the certificate with your CSR.

Example request

{
  "cert": "MIIEpDCCA4ygAwIBAgIIU..."
}

Response

A certificate object

idstring required

Unique identifier of the certificate.

accountIdstring required

The account ID this certificate belongs to.

csrstring

The Certificate Signing Request in base64 format. Only present before activation. Use this to create a certificate in Apple Developer Portal.

certstring

The certificate body in base64 format. Only present after activation.

activeboolean required

Whether the certificate is active for payment processing.

expireAtstring date-time

The certificate expiration date in ISO 8601 format. Only present after activation.

createdAtstring date-time required

The certificate creation date in ISO 8601 format.

Example response

{
  "id": "a6ea0c67-d061-4f7c-9e3b-4a96a6e1e8b1",
  "accountId": "acct_12345",
  "csr": "MIIBEjCBuQIBADBOMRMwE...",
  "cert": "MIIEpDCCA4ygAwIBAgIIU...",
  "active": true,
  "expireAt": "2026-01-15T12:00:00.000Z",
  "createdAt": "2024-01-15T12:00:00.000Z"
}