---
title: Invalidate a Merchant Token
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/unlinking-merchanttoken
---

# Invalidate a Merchant Token

Invalidate a merchant token associated with your merchant identifier, making it invalid for future transaction authorizations.

## URL

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

## Path Parameters

merchantId: Your merchant identifier.

## Header Parameters

Accept: Content-Type: x-request-id:

## Response Codes

204 No Content: Success. The service doesn’t return any additional information. 400 Bad Request: Invalid request. The merchant token identifier isn’t valid for the merchant identifier. 500 Internal Server Error: Internal server error.

## Discussion

Discussion When you call this endpoint, Apple Pay server unlinks — invalidates — the merchant token, and the token is no longer valid for future transaction authorizations. Call this endpoint in the following cases: Someone cancels a recurring transaction on your website or in your app that uses this merchant token Someone changes the payment method for a recurring transactions, for example, they stop using Apple Pay for the transaction

## HTTP Body

The request body you use to specify the merchant token that Apple Pay should invalidate.

## See Also

### Merchant token invalidation

- [MerchantTokenUnlinkRequest](merchanttokennotificationservices/merchanttokenunlinkrequest.md)
