TransaktDocs

payment_connection.merchant_mismatch

A rotated secret key belongs to a different Revolut merchant account; saved payment methods cannot move between accounts, so rotation must stay on the same account.

Codepayment_connection.merchant_mismatch
HTTP status422
CategoryUnprocessable
ArgumentsNone (args is {})

What the portals show

The portals translate the code, never the title. The English (en-GB) message, in ICU format with the arguments as placeholders:

This key belongs to another Revolut merchant account. Use a key of the connected account; to use another account, disconnect and connect it.

Example response

application/problem+json
{
  "type": "https://docs.test.konsolutelab.uk/errors/payment_connection.merchant_mismatch",
  "title": "…",
  "status": 422,
  "code": "payment_connection.merchant_mismatch",
  "args": {},
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
  "instance": "/api/v1/…"
}

Handling it

Branch on code, not on title or the status alone, and log traceId. Codes are stable; new codes may appear, so fall back on the HTTP status for a code you do not know. See Handling errors and the list of codes.