---
title: MerchantToken Usage Data Availability Notification
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/merchanttoken-usage-data-availability-notification
---

# MerchantToken Usage Data Availability Notification

Notify Apple servers that the user’s devices can retrieve merchant token usage information.

## URL

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

## Path Parameters

merchantId: Your merchant identifier.

## Header Parameters

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

## Response Codes

200 OK: Successful response. 400 Bad Request: Bad request. 403 Forbidden: Authorization failed. 404 Not Found: Not found. 500 Internal Server Error: Internal server error.

## Discussion

Discussion Use this API to notify Apple that the user’s device can retrieve merchant token usage information. The request includes metadata about encryption and where to retrieve the usage information.

## HTTP Body

The data.

## See Also

### Merchant token usage information

- [Retrieve Merchant Token Public Key](merchanttokennotificationservices/retrieve-merchant-token-public-key.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)