/
Retrieve a token

Retrieve a token

Request

Retrieves a token with a specified ID.

Security
PublishableApiKey
Path
tokenstringrequired

ID of the token.

curl -i -X GET \
  'https://www.rebilly.com/_mock/catalog/all/tokens/{token}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Token retrieved.

Bodyapplication/json
methodstringrequired

Payment method of the token.

Value:"payment-card"
Discriminator
paymentInstrumentobjectrequired

Payment card instrument details.

billingAddressobject(ContactObject)

Billing address object. This value is required to perform payments. For payment-card updates, billingAddress can be ignored.

idstring, <= 50 characters(ResourceId)read-only

ID of the token.

Example:"4f6cf35x-2c4y-483z-a0a9-158621f77a21"
isUsedbooleanread-only

Specifies if the token has been used.

Default:false
riskMetadataRisk metadata (object) or null
One of:

Risk metadata used for 3D Secure and risk scoring.

createdTimestring, (date-time)(CreatedTime)read-only

Date and time when the resource is created. This value is set automatically when the resource is created.

updatedTimestring, (date-time)(UpdatedTime)read-only

Date and time when the resource is updated. This value is set automatically when the resource is updated.

usageTimestring or null, (date-time)read-only

Date and time when the token is used.

expirationTimestring or null, (date-time)read-only

Date and time when the token expired.

Response
{
  "method": "payment-card",
  "paymentInstrument": {
    "encryptedCvv": "stringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstri",
    "expMonth": 0,
    "expYear": 0,
    "bin": "string",
    "last4": "string",
    "brand": "Visa"
  },
  "billingAddress": {
    "firstName": "Benjamin",
    "lastName": "Franklin",
    "organization": "Rebilly",
    "address": "36 Craven St",
    "address2": "string",
    "city": "Austin",
    "region": "Texas",
    "country": "GB",
    "postalCode": "WC2N 5NF",
    "phoneNumbers": [ … ],
    "emails": [ … ],
    "dob": "1980-04-01",
    "jobTitle": "CEO",
    "hash": "056ae6d97c788b9e98b049ebafd7b229bf852221"
  },
  "id": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
  "isUsed": false,
  "riskMetadata": {
    "ipAddress": "93.92.91.90",
    "fingerprint": "pIUt3xbgX3l9g3YDiLbx",
    "httpHeaders": { … },
    "browserData": { … },
    "extraData": { … },
    "isProxy": true,
    "isVpn": true,
    "isTor": true,
    "isHosting": true,
    "hostingName": "string",
    "isp": "string",
    "country": "US",
    "region": "NY",
    "city": "New York",
    "latitude": 0.1,
    "longitude": 0,
    "postalCode": "string",
    "timeZone": "America/New_York",
    "accuracyRadius": 0,
    "distance": 0,
    "hasMismatchedBillingAddressCountry": true,
    "hasMismatchedBankCountry": true,
    "hasMismatchedTimeZone": true,
    "hasMismatchedHolderName": true,
    "hasFakeName": true,
    "isHighRiskCountry": true,
    "paymentInstrumentVelocity": 0,
    "declinedPaymentInstrumentVelocity": 0,
    "deviceVelocity": 0,
    "ipVelocity": 0,
    "emailVelocity": 0,
    "billingAddressVelocity": 0,
    "paymentInstrumentApprovedTransactionCount": 0,
    "score": 0
  },
  "createdTime": "2019-08-24T14:15:22Z",
  "updatedTime": "2019-08-24T14:15:22Z",
  "usageTime": "2019-08-24T14:15:22Z",
  "expirationTime": "2019-08-24T14:15:22Z",
  "_links": [
    { … }
  ]
}