---
title: "Notify Merchant Update"
method: POST
path: "/notify-merchant-update"
tags: ["Merchant Onboarding"]
---

# Notify Merchant Update

`POST /notify-merchant-update`

Notify the token requestor about a merchant onboarding update. 

In case of retryable error returned by the token requestor, the notification will be resent periodically with exponential backoff.

## Parameters

- `#/parameters/authorization` — unresolved $ref
- `#/parameters/xCorrelationId` — unresolved $ref

## Request body

- object
  - `merchantId` string, required — Identifier of the merchant provided by Thales at on-boarding.
  - `scheme` 'MASTERCARD' | 'VISA', required — The card primary scheme.
  - `trId` string — The Token Requestor Identifier generated by the scheme for that merchant. In case of Mastercard Secure Card-On-File program, this field is not returned, see 'mcServiceId' instead.
  - `mcServiceId` string — Token Requestor Id for SCOF solution, equivalent to the TRID. It is assigned by Mastercard to entity for which tokens are created.
  - `error` ErrorOnboarding — Information about the error in case a problem occurs when a merchant is onboarded.
    - `errorCode` string, required — The error code as specified in below table. ----------------- |Error Code|Description| |-------|-------| |NON_RETRYABLE_ERROR|Generic code for all non retryable errors returned by the TMG.| |RETRYABLE_ERROR|Generic code for all retryable errors returned by the TMG.| |TSP_NON_RETRYABLE_ERROR|Generic code for all non retryable errors returned by the TSP.| |TSP_RETRYABLE_ERROR|Generic code for all retryable errors returned by the TSP.| -----------------
    - `errorDetails` string — Additional information about the error. This optional parameter has no specific format as it depends on the different TSP API. It is sent for logging and troubleshooting purpose.
  - `lastUpdateTimestamp` string — Last update timestamp compliant with ISO 8601.

## Other responses

- `204` — unresolved $ref
- `400` — unresolved $ref
- `401` — unresolved $ref
- `404` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref
- `503` — unresolved $ref

---

[API](https://skmtc.net/thalescloud/apis/d1-oauth-api.md) · [All operations](https://skmtc.net/thalescloud/apis/d1-oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thalescloud/d1-oauth-api/revisions/96089514858c/schema)