---
title: Update Merchant Metadata
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/update-merchant-metadata
---

# Update Merchant Metadata

Update the merchant token’s notification URL.

## URL

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

## Path Parameters

merchantId: The merchant identifier issued by Apple.

## 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. 400 Bad Request: Bad request. 403 Forbidden: Authorization failed. 404 Not Found: Resource not found. 500 Internal Server Error: Internal server error.

## Discussion

Discussion The merchant server calls this API to update the value of a merchant token’s tokenNotificationURL. This URL receives life-cycle and metadata update notifications from the Apple Pay servers about the Apple Pay merchant token.

## HTTP Body

The request body you use to specify the updated merchant metadata.

## See Also

### Merchant token notification handling

- [Receiving and handling merchant token notifications](applepaymerchanttokenmanagementapi/receiving-and-handling-merchant-token-notifications.md)
- [Send Merchant Token Event](merchanttokennotificationservices/send-merchant-token-event.md)
