---
title: Retrieve Merchant Token Public Key
framework: Apple Pay Merchant Token Management API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple pay merchant token management api 1.0.12+]
path: merchanttokennotificationservices/retrieve-merchant-token-public-key
---

# Retrieve Merchant Token Public Key

Get the merchant token public key.

## URL

POST https://apple-pay-gateway.apple.com/paymentservices/v1/merchantId/{merchantId}/merchantToken/publicKey

## Path Parameters

merchantId: Your merchant identifier.

## Header Parameters

Accept: The response format the client expects, for example, application/json for JSON. Content-Type: The format of the data sent in the request body, for example, application/json for JSON payloads. x-request-id: The header used to uniquely identify the request.

## Response Codes

200 OK: Successful response. 202 Accepted: Accepted. The public key isn’t yet available. Apple notifies via tokenNotificationURL when it’s available. 400 Bad Request: Bad request. 403 Forbidden: Authorization failed. 404 Not Found: Resource not found. 409 Conflict: Metadata conflict. Update the tokenNotificationURL. 500 Internal Server Error: Internal server error.

## Discussion

Discussion Your server calls this API to get the public key of a particular merchant token. This public key is created by the merchant token owner’s device. The key is a P-384 public key. The response includes the supportedCiphersuite, which specifies the cipher suite to use when calling the Merchant-Token-Usage-Data-Availability-Notification or responding to Get MerchantToken Usage Information Package.

## HTTP Body

The request body you use for the merchant token public key.

## See Also

### Merchant token usage information

- [MerchantToken Usage Data Availability Notification](merchanttokennotificationservices/merchanttoken-usage-data-availability-notification.md)
- [MerchantTokenUsageDataAvailabilityNotificationRequest](merchanttokennotificationservices/merchanttokenusagedataavailabilitynotificationrequest.md)
- [Get MerchantToken Usage Information Package](merchanttokennotificationservices/get-merchanttoken-usage-information-package.md)
- [GetMerchantTokenUsageInformationPackageResponse](merchanttokennotificationservices/getmerchanttokenusageinformationpackageresponse.md)
- [AutomaticReloadPaymentDetails](applepaymerchanttokenusageinformation/automaticreloadpaymentdetails.md)
- [CurrencyAmount](applepaymerchanttokenusageinformation/currencyamount.md)
- [DeferredPaymentDetails](applepaymerchanttokenusageinformation/deferredpaymentdetails.md)
- [PastPayment](applepaymerchanttokenusageinformation/pastpayment.md)
- [PaymentIssueDetails](applepaymerchanttokenusageinformation/paymentissuedetails.md)
- [RecurringPaymentDetails](applepaymerchanttokenusageinformation/recurringpaymentdetails.md)
- [UpcomingPayment](applepaymerchanttokenusageinformation/upcomingpayment.md)
- [UsageInformation](applepaymerchanttokenusageinformation/usageinformation.md)
