---
title: "Account Holder Messaging"
method: POST
path: "/pws/customerservice/v2/token/account_holder_messaging"
tags: ["Tokenization customer service"]
---

# Account Holder Messaging

`POST /pws/customerservice/v2/token/account_holder_messaging`

Allows issuer to display customized messages per token within the Apple Pay wallet, below the digitized image of the card.

## Request body

- AccountHolderMessagingRequestModel
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `issuerApplicationMessageDisplay` boolean, required — This is the indicator if the message can be viewed in the Issuer Application using the MessageIdentifier.
  - `messageExpiration` string, required — Date and time after which the message is no longer valid. Maximum value of 30 days in the future. ISO 8601 format.
  - `messageIdentifier` string, required — This is the message identifier. This could be used for linking into the issuer application.
  - `messageLanguageCode` string, required — The language of the message. Only messages with the requested language code will be presented to the account holder. ISO 639-1 format
  - `messageText` string, required — This is the message which will be displayed to the cardholder.
  - `token` integer, required — Paymentology Public Token.
  - `tokenUniqueReference` string, required — Unique reference of the token to be updated.
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request

## Response `200`

Successful Response

- AccountHolderMessagingResponseModelBody
  - `responseId` string — Response ID
  - `tokenUniqueReference` string — Unique reference to the digital token

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)