Retrieve Merchant Token Public Key
Get the merchant token public key.
URL
POST https://apple-pay-gateway.apple.com/paymentservices/v1/merchantId/{merchantId}/merchantToken/publicKeyPath Parameters
| Name | Type | Description |
|---|---|---|
merchantId Required | string | Your merchant identifier. |
Header Parameters
| Name | Type | Description |
|---|---|---|
Accept Optional | string | The response format the client expects, for example, |
Content-Type Required | string | The format of the data sent in the request body, for example, |
x-request-id Required | string | The header used to uniquely identify the request. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | RetrieveMerchantTokenPublicKeyResponse | Successful response. |
| 202 | Accepted Content-Type: application/json | ErrorResponse | Accepted. The public key isn’t yet available. Apple notifies via |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | Bad request. |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | Authorization failed. |
| 404 | Not Found Content-Type: application/json | ErrorResponse | Resource not found. |
| 409 | Conflict Content-Type: application/json | ErrorResponse | Metadata conflict. Update the |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse | Internal server error. |
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 NotificationMerchantTokenUsageDataAvailabilityNotificationRequestGet MerchantToken Usage Information PackageGetMerchantTokenUsageInformationPackageResponseAutomaticReloadPaymentDetailsCurrencyAmountDeferredPaymentDetailsPastPaymentPaymentIssueDetailsRecurringPaymentDetailsUpcomingPaymentUsageInformation