GET///
Use this endpoint if you use Marqeta only for tokenization as a service and are not a Marqeta card issuer.
If Marqeta is your card issuer, use the Digital Wallets Management endpoint instead.
/digitalwallettokentransitions/digitalwallettoken/{token} endpoint to return an array of all transitions for a particular digital wallet token.
This endpoint supports field filtering, pagination, and sorting.
Header parameter
| Fields | Description |
|---|---|
| req-sys-id string Optional | Random pseudo-unique identifier of a request, used for troubleshooting between multiple parties. Usually a globally unique identifier (GUID). Allowable Values: 1–36 chars |
URL path parameters
| Fields | Description |
|---|---|
| token string Required | Unique identifier of the digital wallet token transition. Allowable Values: Existing digital wallet token transition token |
URL query parameters
| Fields | Description |
|---|---|
| count integer Optional | Number of resources to retrieve. Allowable Values: Any integer |
| start_index integer Optional | Sort order index of the first resource to retrieve. Allowable Values: Any integer |
| sort_by string Optional | Field on which to sort. Use any field in the resource model, or one of the system fields lastModifiedTime or createdTime. Prefix the field name with a hyphen (-) to sort in descending order. Omit the hyphen to sort in ascending order.Allowable Values: createdTime, lastModifiedTime, or any field in the resource modelDefault value: id |
| fields string Optional | Comma-delimited list of fields to return (field_1,field_2, and so on). Leave blank to return all fields.Allowable Values: Comma-delimited list of fields, or blank |
Response body
| Fields | Description |
|---|---|
| count integer Returned | Number of resources returned. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
| start_index integer Returned | Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
| end_index integer Returned | Sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
| is_more boolean Conditionally returned | A value of true indicates that more unreturned resources exist. A value of false indicates that no more unreturned resources exist.This field is returned if there are resources in your returned array. Allowable Values: true, false |
| data array of objects Conditionally returned | Array of digital wallet token transition objects. Objects are returned as appropriate to your query. Allowable Values: Valid array of one or more digital wallet token transition objects |
| data[].token string Returned | Unique identifier of the digital wallet token transition, and not the identifier of the digital wallet token itself. Allowable Values: 1–36 chars |
| data[].digital_wallet_token object Returned | Hashed version of Marqeta’s unique identifier for the digital wallet tokens. Allowable Values: token |
| data[].digital_wallet_token.token string Returned | Marqeta’s unique identifier for the digital wallet token. Allowable Values: 1–36 chars |
| data[].card_swap object Conditionally returned | Hashed version of the card_swap object. Specifies the old and new payment card tokens that were swapped.Allowable Values: newCardToken, previousCardToken |
| data[].card_swap.previousCardToken string Returned | Unique identifier of the old card from which the digital wallet tokens are transferred. Allowable Values: 1–36 chars |
| data[].card_swap.newCardToken string Returned | Unique identifier of the new card to which the digital wallet tokens are transferred. Allowable Values: 1–36 chars |
| data[].type string Returned | Type of digital wallet token transition. state.activated, for example.Allowable Values: card.swap, fulfillment.requested, state.activated, state.reinstated, state.request_declined, state.suspended, state.terminated |
| data[].channel string Returned | Mechanism by which the transition was initiated. API, for example.Allowable Values: ADMIN, API, DIGITAL_WALLET, FRAUD, IVR, MARQETA_DASHBOARD, SYSTEM, TOKEN_SERVICE_PROVIDER |
| data[].state string Returned | Specifies the state to which to transition the digital wallet token. Allowable Values: ACTIVE, REQUESTED, REQUEST_DECLINED, SUSPENDED, TERMINATED |
| data[].fulfillment_status string Returned | Digital wallet token’s provisioning status. Allowable Values: DECISION_GREEN, DECISION_RED, DECISION_YELLOW, PROVISIONED, REJECTED |
| data[].reason string Conditionally returned | Descriptive reason for the transition. Allowable Values: 255 char max |
| data[].reason_code string Returned | Code describing the reason for the transition. Marqeta does not validate what is provided, although Marqeta-sourced changes use standard codes. Allowable Values: 1–255 chars |
| data[].created_time datetime Returned | Date and time when the resource was created, in UTC. Allowable Values: date-time Format: yyyy-MM-ddThh:mm:ssZ |