トランジットAPI

Request to send personalization data to a digital card

post

This method is used by TES to submit the perso data used for personalizing a digital card. This request is sent after TES approves a previous provisionCard call and after finishing to prepare the required data.

本文

issuerIdstring · 最小: 1 · 最大: 16必須

The Card Issuer Identifier. Unique for each card issuer.

cardIdstring · 最小: 1 · 最大: 48必須

The Card Identifier. Unique for each card.

レスポンス

200

submitCardPersoData response payload

application/json

500

Internal Server Error

post/submitCardPersoData

POST /tsh/transitapi/1/0/submitCardPersoData HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 206

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z"
  },
  "issuerId": "text",
  "cardId": "text",
  "cardPersoData": [
    {
      "name": "text",
      "value": "text",
      "keyIndex": "text"
    }
  ]
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z",
    "statusCode": 1,
    "statusMessage": "text"
  }
}

Request to update the state of a digital card

post

This method is used by TES to request to update the state of a digital card.

本文

issuerIdstring · 最小: 1 · 最大: 16必須

The Card Issuer Identifier. Unique for each card issuer.

cardIdstring · 最小: 1 · 最大: 48必須

The Card Identifier. Unique for each card.

actionstring · enum必須

The LCM action to apply on the card.Possible values are:

DELETE
SUSPEND
RESUME
ERASE (used in the Rights of Individuals context) All personal data are physically removed from TSH server

可能な値:

レスポンス

200

updateCardState response payload

application/json

500

Internal Server Error

post/updateCardState

POST /tsh/transitapi/1/0/updateCardState HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z"
  },
  "issuerId": "text",
  "cardId": "text",
  "action": "DELETE"
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z",
    "statusCode": 1,
    "statusMessage": "text"
  }
}

Request to update the metadata of a card

post

This method is used by TES to request to update the metadata of a digital card:

either commute plans metadata
or card arts

It's not possible to update them both in a single request.

本文

issuerIdstring · 最小: 1 · 最大: 16必須

The Card Issuer Identifier. Unique for each card issuer.

cardIdstring · 最小: 1 · 最大: 48必須

The Card Identifier. Unique for each card.

cardArtManifeststring[]オプション

Array of asset identifiers required to build card arts. Both cardBackground and icon asset identifiers shall be provided.

Asset identifier can be up to 64 characters.

When this parameter is provided, a request will be sent to wallet provider for updating the card arts deployed with the ones specified

レスポンス

200

updateCardMetadata response payload

application/json

500

Internal Server Error

post/updateCardMetadata

POST /tsh/transitapi/1/0/updateCardMetadata HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 473

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z"
  },
  "issuerId": "text",
  "cardId": "text",
  "commutePlans": [
    {
      "identifier": "text",
      "title": [
        {
          "label": "text",
          "value": "text",
          "language": "text"
        }
      ],
      "usage": {
        "label": "Usage",
        "value": [
          {
            "text": "text",
            "language": "text"
          }
        ]
      },
      "validityPeriod": {
        "startDate": "2026-01-01T00:00:00.000Z",
        "expiryDate": "2026-01-01T00:00:00.000Z",
        "dateStyle": "SHORT",
        "timeStyle": "SHORT"
      }
    }
  ],
  "cardArtManifest": [
    "text"
  ]
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z",
    "statusCode": 1,
    "statusMessage": "text"
  }
}

Request to initiate a session for a digital card

post

This method is used by TES to request TSH to initiate a session for a digital card. This request is sent when TES needs to exchange commands with targeted device (during a topup for example).

本文

issuerIdstring · 最小: 1 · 最大: 16必須

The Card Issuer Identifier. Unique for each card issuer.

cardIdstring · 最小: 1 · 最大: 48必須

The Card Identifier. Unique for each card.

operationstring · enumオプション

The operation to be initiated

可能な値:

レスポンス

200

initiateCardSession response payload

application/json

500

Internal Server Error

post/initiateCardSession

POST /tsh/transitapi/1/0/initiateCardSession HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 166

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z"
  },
  "issuerId": "text",
  "cardId": "text",
  "operation": "READ_BALANCE"
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z",
    "statusCode": 1,
    "statusMessage": "text"
  }
}

Request to get the list of cards details associated to a card account

post

This method is used by TES to request TSH to return the list of cards associated to the specified card account.

本文

issuerIdstring · 最小: 1 · 最大: 16必須

The Card Issuer Identifier. Unique for each card issuer.

cardAccountIdstring · 最小: 1 · 最大: 48必須

The Card Account Identifier. Unique for each card account.

レスポンス

200

getCards response payload

application/json

walletCardAccountIdstring · 最小: 1 · 最大: 64オプション

The Wallet Card Account Identifier. Unique for each wallet card account.

walletAccountIdstring · 最小: 1 · 最大: 128オプション

The Wallet Account Identifier. Unique for each wallet account.

cardAccountStatestring · enumオプション可能な値:

500

Internal Server Error

post/getCards

POST /tsh/transitapi/1/0/getCards HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z"
  },
  "issuerId": "text",
  "cardAccountId": "text"
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z",
    "statusCode": 1,
    "statusMessage": "text"
  },
  "walletCardAccountId": "text",
  "walletAccountId": "text",
  "cardAccountState": "ACTIVE",
  "cards": [
    {
      "cardId": "text",
      "walletCardId": "text",
      "cardState": "CREATED"
    }
  ]
}

Request to refund a card account

post

This method is used by TES to notify TSH that a card account has been refunded.

本文

issuerIdstring · 最小: 1 · 最大: 16必須

The Card Issuer Identifier. Unique for each card issuer.

cardAccountIdstring · 最小: 1 · 最大: 48必須

The Card Account Identifier. Unique for each card account.

レスポンス

200

refundCardAccount response payload

application/json

500

Internal Server Error

post/refundCardAccount

POST /tsh/transitapi/1/0/refundCardAccount HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z"
  },
  "issuerId": "text",
  "cardAccountId": "text"
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z",
    "statusCode": 1,
    "statusMessage": "text"
  }
}

Get request status

post

This method is used by TES to check the status of an asynchronous request previously submitted.

本文

issuerIdstring · 最小: 1 · 最大: 16必須

The Card Issuer Identifier. Unique for each card issuer.

targetRequestIdstring · 最小: 1 · 最大: 48必須

Unique request identifier

レスポンス

200

getRequestStatus response payload

application/json

requestStatusstring · enumオプション

The status of the request.

可能な値:

500

Internal Server Error

post/getRequestStatus

POST /tsh/transitapi/1/0/getRequestStatus HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "requestHeader": {
    "requestId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z"
  },
  "issuerId": "text",
  "targetRequestId": "text"
}

{
  "responseHeader": {
    "responseId": "text",
    "sessionId": "text",
    "generationDateTime": "2026-01-01T00:00:00.000Z",
    "statusCode": 1,
    "statusMessage": "text"
  },
  "requestStatus": "PROCESSING"
}

前へ受信API（TES発）

次へ通知API

最終更新 7 か月前

役に立ちましたか？