Skip to main content
GET
https://checkout.dintero.com/v1/
/
card-tokens
List card tokens
curl --request GET \
  --url https://checkout.dintero.com/v1/card-tokens \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "type": "payment_token",
    "status": "ACTIVE",
    "card_brand": "visa",
    "account_id": "P12345678",
    "payment_product_type": "dintero_psp.creditcard",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "token": "<string>",
    "masked_pan": "476173******0416",
    "pan_expiry_date": "09/2030",
    "token_expiry_date": "09/2030",
    "links": [
      {
        "href": "<string>",
        "rel": "digital_card_art",
        "mime_type": "image/png"
      }
    ],
    "customer_id": "<string>",
    "relationship_id": "<string>",
    "transaction_id": "<string>",
    "external_token_references": [
      "<string>"
    ],
    "created_by": "<string>",
    "deleted_at": "2023-11-07T05:31:56Z",
    "deleted_by": "<string>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.dintero.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication (token authentication) should be used for accessing the API.

Use Get Token to get an access token for client credentials. Pass the token in the request header:

Authorization: Bearer {access_token}

where the access_token is JSON Web Tokens (JWT).

Query Parameters

​
customer_id
string

Filter by customer_id

​
relationship_id
string

Filter by relationship_id

​
status
enum<string>[]

Filter by status

Available options:
ACTIVE,
INACTIVE,
SUSPENDED,
CANCELLED,
DELETED
​
include_deleted
boolean
default:false

Include deleted card tokens in the response

​
limit
integer
default:10

A limit on the number of objects to be returned. Limit can range between 1 and 100 items, and the default is 10 items.

Required range: 1 <= x <= 100
​
starting_after
string

The cursor to use in the next request to get the next page of results

Response

Card Tokens

​
id
string
required
​
type
enum<string>
required
Available options:
payment_token
​
status
enum<string>
required
Available options:
ACTIVE,
INACTIVE,
SUSPENDED,
CANCELLED,
DELETED
​
card_brand
enum<string>
required
Available options:
visa,
mastercard
​
account_id
string
required
Required string length: 9
Pattern: ^[PT]{1}\d{8}$
Example:

"P12345678"

​
payment_product_type
string
required
Example:

"dintero_psp.creditcard"

​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
token
string
​
masked_pan
string
Example:

"476173******0416"

​
pan_expiry_date
string<\d{2}/\d{4}>
Example:

"09/2030"

​
token_expiry_date
string<\d{2}/\d{4}>
Example:

"09/2030"

​
links
object[]
​
customer_id
string
​
relationship_id
string

Reference to the merchant entity for which the token is dedicated. Merchant-dedicated tokens are uniquely created per merchant_relationship_id.

​
transaction_id
string<checkout-id>

Reference to the transaction where the token was created

​
external_token_references
string[]

External references to migrated card tokens

​
created_by
string
​
deleted_at
string<date-time>
​
deleted_by
string