> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/xpay-enablement/ja/apirifarensu/tsp-api-v2/rirsu.md).

# リリース履歴

| リリース   | 日付                   | 変更内容                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 1.0    | トークンリクエスタAPIの初回リリース。 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.0.1  | 23/01/2018           | <ul><li>APIメソッド名を更新。</li><li>createToken に deviceInfo を追加。</li><li>cipheredCardInfo に additionalCardInfos を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.0.2  | 19/03/2018           | <ul><li>tokenStorageId の最大長を64に拡張。</li><li>additionalCardInfos の最大長を指定。</li><li>tokenPersoInfo#value の最大長を指定。</li><li>requestReplenisment および replenishmentDone パラメータの長さを指定。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.0.3  | 07/05/2018           | <ul><li>TSP がトークンを更新できるようにする新しいリクエストを追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 1.0.4  | 31/05/2018           | <ul><li>ヘルスチェックメソッドがHTTP 200ではなくHTTP 204を返す。</li><li>cardRefId の長さを64に拡張。</li><li>createToken API に任意パラメータ「initialState」を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.0.5  | 19/07/2018           | <ul><li>updateToken に、イシュアによって変更された場合に新しい cardRefId を指定するための新しい任意パラメータを追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 1.0.6  | 14/08/2018           | <ul><li>APIごとに使用可能なエラーコードを追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 1.0.7  | 25/09/2018           | <ul><li>updateTokenState API に新しい任意パラメータ reason を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.0.8  | 22/11/2018           | <ul><li>トークンの再パーソナライズ後にTSPへ通知するための submitNewTokenDataStatus 操作を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 1.0.9  | 17/12/2018           | <ul><li>リトライ可能なエラーに関する情報を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.0.10 | 17/12/2018           | <ul><li>submitTokenData および submitNewTokenData リクエストに tokenInfo を追加。</li><li>submitTokenData および submitNewTokenData リクエストにおけるデータ要素値の最大長を拡張。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 1.1.0  | 07/05/2020           | <ul><li>TSH によってトリガーされるトークン再パーソナライズフロー用に repersoToken を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 1.1.1  | 26/06/2020           | <ul><li>Apple Pay の mCommerce transactionIdentifier の誤った説明を修正。</li><li>「Card Update」で説明されているフローのエラーを修正。リクエスト 'updateToken' は TSP ではなく TSH により送信されます。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2.0.0  | 04/06/2020           | <p>後方互換性のないバージョン<br><br></p><ul><li>システム間の呼び出しを相関付けるために、ヘルスチェックを除くすべてのリクエストに新しい HTTP ヘッダー x-correlation-id を追加。</li><li>x-request-id は削除されました（ヘルスチェックを除く）。</li><li>API呼び出し間の関連付けに関する詳細を含む新しい「Guidelines」ページを追加。</li><li>walletProviderId は tokenRequestorId と重複しているため削除されました。</li><li>createToken の cardRefId パラメータは削除されました。代わりに新しいパラメータ issuerCardRefId と walletCardRefId を使用します。</li><li>updateToken の newCardRefId パラメータは削除されました。代わりに新しいパラメータ newIssuerCardRefId を使用します。</li><li>issuerCardRefId と walletCardRefId を反映するよう「Data Model」ページを更新。</li><li>「Card Update」で説明されているフローのエラーを修正。リクエスト 'updateToken' は TSP ではなく TSH により送信されます。</li></ul> |
| 2.0.1  | 26/06/2020           | <ul><li>Apple Pay の mCommerce transactionIdentifier の誤った説明を修正。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 2.1.0  | 21/09/2020           | <ul><li><p>PKCS7 暗号化を管理する API を更新。暗号化に使用された RSA 公開鍵を表すキー識別子が以下に追加されました：</p><ul><li>createToken（cipheredCardInfo 用）</li><li>updateToken（newCipheredCardInfo 用）</li></ul></li><li>トークン取引通知APIの誤った説明を更新。transactionIdentifier は必須ではありません（返金時）。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                            |
| 2.2.0  | 16/12/2020           | <ul><li>Apple Iron アプレット更新通知用の新しいAPIを導入。</li><li>createToken にデバイス言語、アプレットバージョン、eコマース証明書を追加。</li><li>TSH から TSP に送信される暗号化ペイロードに対する OAEP パディングのサポートを追加。</li><li>開発上の考慮事項セクションを追加。 <a href="https://docs.payments.thalescloud.io/xpay-enablement/api-reference/guidelines">ガイドライン</a>.</li><li>createToken リクエストで送信される 'deviceInfo' オブジェクトに type を追加。</li></ul>                                                                                                                                                                                                                                                                                    |
| 2.2.1  | 24/11/2023           | <ul><li>どのウォレット種別が取引を実行したかを示すために、token transaction notification API に新しい HTTP ヘッダーを追加。</li><li>Google Pay および Samsung Pay のデータ準備セクションを追加。</li><li>取引通知で使用される transactionIdentifier の説明を更新。</li><li>x-request-id と x-correlation-id ヘッダーの長さを64に拡張。</li><li>Google Pay 用の補充 API を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                     |
| 2.2.2  | 08/04/2024           | <ul><li>device type enum に新しい値 'REALITY' を追加。</li><li>replenishToken レスポンスのエラーを修正: paymentKeys は文字列であり、文字列の配列ではありません。</li><li>「HCE イシュアウォレットのパーソナライズ」セクションを追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 2.2.3  | 20/11/2024           | <ul><li>Google 補充 API における HTTP ヘッダーの誤った説明を修正（'x-request-id' ではなく 'x-correlation-id'）。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 2.2.4  | 15/01/2025           | <ul><li>Google Pay Discover のパーソナライズデータ形式を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 2.2.5  | 05/06/2025           | <ul><li>token transaction notification API リクエストにパラメータ 'linkedTransactionId' を追加。Google Pay ソリューションに適用されます。返金時に、通知を以前の購入取引に関連付けるために使用されます。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 2.2.6  | 13/08/2025           | <ul><li>Google Pay CPACE Girocard のパーソナライズデータ形式を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 2.2.7  | 22/05/2026           | <ul><li>CCI 用の listTokens 関数を追加。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/xpay-enablement/ja/apirifarensu/tsp-api-v2/rirsu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.