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}

Example: Retrieve Transient Token Details Using the REST API

Request
{
}
Response 200
{
    "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"
        }
    }
}
Retrieving Transient Token Details