Sign in

v1

latestOpenAPI 3.0.0UNLICENSED2026-07-26178479713.7 KB
cards

aid_cards_cardid_token_post

Create a temporary token (also referred as Card Code) for the card, an temporary alias that must be used when when creating a drawdown transaction

The token can be stored in a barcode to allow use of virtuell card in purchase in POS or webstore

scopes:

  • admin:wallets
  • write:wallets
post/accounts/{aid}/wallets/cards/{card_id}/tokens

Path parameters

aidstring ^[PT]{1}\d{8}$ required

An id that uniquely identifies the account.

card_idstring required

The card id you have defined for the card. (must not have trailing or leading spaces)

Request body

metadataobject

A key-value JSON object to store any additional information. The dintero_* namespace for keys is reserved

ref_idstring required

Unique ref ID provided by the client to support safely retrying requests without accidentally performing the same operation twice

All card transaction must have a unique ref ID, but it is not required that the ref ID is globally unique.

expires_after_transactionboolean

The token can only be used to create one transaction, card lookup by token will be available until token expires by date

expires_ininteger required

The lifetime in seconds for the card token. For example, the value "3600" denotes that the token will expire in one hour from the time the response was generated.

Example request

{
  "metadata": {
    "order_id": "xk39592f"
  },
  "format": {
    "prefix": "DINCARD:"
  },
  "token": {
    "value": "DINCARD:6ccfec5d-3a53-47de-910a-97d6dda22e5f",
    "barcode_128": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIA..."
  }
}

Response

Token created

idstring uuid

An UUID that uniquely identifies the resource

created_atstring date-time

The date-time when the resource was created

created_bystring

The ID of the user/client that created the resource

metadataobject

A key-value JSON object to store any additional information. The dintero_* namespace for keys is reserved

ref_idstring required

Unique ref ID provided by the client to support safely retrying requests without accidentally performing the same operation twice

All card transaction must have a unique ref ID, but it is not required that the ref ID is globally unique.

expires_after_transactionboolean

The token can only be used to create one transaction, card lookup by token will be available until token expires by date

expires_ininteger required

The lifetime in seconds for the card token. For example, the value "3600" denotes that the token will expire in one hour from the time the response was generated.

Example response

{
  "created_by": "1c92f7e1-2897-4d46-bdcc-c127a914fb4e",
  "metadata": {
    "order_id": "xk39592f"
  },
  "format": {
    "prefix": "DINCARD:"
  },
  "token": {
    "value": "DINCARD:6ccfec5d-3a53-47de-910a-97d6dda22e5f",
    "barcode_128": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIA..."
  }
}