---
title: "POST /apple-pay/merchant-registration/{merchantId}/certificates"
method: POST
path: "/apple-pay/merchant-registration/{merchantId}/certificates"
tags: ["ApplePay"]
---

# POST /apple-pay/merchant-registration/{merchantId}/certificates

`POST /apple-pay/merchant-registration/{merchantId}/certificates`

## Request

- Base URL: `https://api.basistheory.com`
- URL: `https://api.basistheory.com/apple-pay/merchant-registration/{merchantId}/certificates`
- Auth: API key in header `BT-API-KEY`

## Path parameters

- `merchantId` string, uuid, required

## Request body

- ApplePayMerchantCertificatesRegisterRequest
  - `merchant_certificate_data` string, nullable
  - `merchant_certificate_password` string, nullable
  - `payment_processor_certificate_data` string, required
  - `payment_processor_certificate_password` string, required
  - `domain` string, nullable

## Response `200`

OK

- ApplePayMerchantCertificates
  - `id` string, uuid
  - `tenant_id` string, uuid
  - `domain` string, nullable
  - `merchant_certificate_expiration_date` string, date-time, nullable
  - `merchant_certificate_fingerprint` string, nullable
  - `payment_processor_certificate_expiration_date` string, date-time, nullable
  - `payment_processor_certificate_fingerprint` string, nullable
  - `created_by` string, uuid, nullable
  - `created_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-08-08** `88754703a861`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/basistheory/apis/basis-theory-api/changes/apple-pay/merchant-registration/:merchantId/certificates/post.md)

---

[API](https://skmtc.dev/basistheory/apis/basis-theory-api.md) - [All operations](https://skmtc.dev/basistheory/apis/basis-theory-api/llms.txt) - [OpenAPI document](https://skmtc.dev/basistheory/apis/basis-theory-api/revisions/05fab7a622ac?raw)