Retrieving Transient Token Details

This section describes how to use the token retrieval service to get the transient token details such as the instrument identifier token and payment instrument token. Use the payment instrument token for token management. Use the instrument identifier for these transactions:
  • Merchant-initiated debt recovery
  • Stand-alone credit

Endpoint

Test:
POST
https://apitest.cybersource.com
/tms/v2/taps/{id}
Production:
POST
https://api.cybersource.com
/tms/v2/taps/{id}

REST Example: Retrieve Transient Token Details Using the REST API

Light Dark
Request
1
{}
Response 200
123456789101112131415161718192021222324252627282930313233343536
{"id": "a76392f4-cde4-97aa-1111-0252ac14c005",
    "paymentInformation": {
        "card": {
            "expirationMonth": "12",
            "expirationYear": "2030"
        }
    },
    "pointOfSaleInformation": {
        "deviceId": "FF123457",
        "emv": {
            "applicationIdentifier": "A0000000031010",
            "applicationLabel": "Company"
        }
    },
    "processingInformation": {
        "industryDataType": "transit"
    },
    "tokenInformation": {
        "instrumentIdentifier": {
            "id": "CD616772D8355EA6E53AF598E0AE794"
        },
        "paymentInstrument": {
            "id": "DB0875B76F95085CE053AF598E0A6354"
        }
    },
    "_links": {
        "self": {
            "href": "/tms/v2/taps/a76392f4-cde4-97aa-1111-0252ac14c005"
        },
        "paymentInstrument": {
            "href": "/tms/v1/paymentinstruments/DB0875B76F95085CE053AF598E0A6354"
        },
        "instrumentIdentifier": {
            "href": "/tms/v1/instrumentidentifiers/CD616772D835EA6E53AF598E0AE794"
        }
    }}