---
title: Send Merchant Token Event
framework: Apple Pay Merchant Token Management API
role: symbol
role_heading: Web Service Endpoint
platforms: [app store connect api 1.0.10+, apple pay merchant token management api 1.0.12+]
path: merchanttokennotificationservices/send-merchant-token-event
---

# Send Merchant Token Event

Receive and handle merchant token life-cycle updates from Apple Pay.

## URL

GET https://merchant.example.com/notification/merchantToken/{eventId}

## Path Parameters

eventId: A string that uniquely identifies a life-cycle event for a merchant token.

## Response Codes

200 OK: Successful response.

## Mentioned in

Receiving and handling merchant token notifications

## Discussion

Discussion You implement this endpoint on your server to receive notifications about merchant token life-cycle events. When a life-cycle event affects the merchant token — for example, the card’s expiration date changes, or the user or issuer deletes the token — Apple Pay calls this endpoint to notify you. To receive requests at this endpoint, your server needs to support the Transport Layer Security (TLS) 1.2 protocol or later. Process the event in your system with the appropriate action. Respond with 200 OK if your endpoint successfully receives the notification, even if your endpoint can’t find the related merchant token or event identifier. Respond with 500 Internal Server Error if your endpoint isn’t able to process the notification request. Apple Pay immediately retries the notification up to three times if the response isn’t 200. For more information about implementing this endpoint on your server, see Receiving and handling merchant token notifications.

## See Also

### Merchant token notification handling

- [Receiving and handling merchant token notifications](applepaymerchanttokenmanagementapi/receiving-and-handling-merchant-token-notifications.md)
- [Update Merchant Metadata](merchanttokennotificationservices/update-merchant-metadata.md)
