Create a Samsung digital wallet token beta

Creates a digital wallet token that can be added to a Samsung wallet. This token represents a specific card, wallet, and device token. The card's data is encrypted using digital wallet provider’s encryption key, meaning your PCI compliance overhead is reduced.

After your request is successfully processed, you'll receive a DigitalWalletTokenTransition webhook containing the digital wallet token. You'll also be able to retrieve it using the List digital wallet tokens endpoint.

SecurityCommonAuth
Request
path Parameters
cardId
required
string <uuid> <= 36 characters

The ID of the card to work with.

Example: e9293471-5eb3-4dbc-916c-dbaf9e2deefd
query Parameters
accountId
required
string

The ID of the account to work with.

Example: accountId=F50091
personId
string <uuid> <= 36 characters

The ID of the person to work with.

Example: personId=775596ae-2624-40af-a9dc-9756110a4a04
Request Body schema: application/json

Body

deviceType
required
string

The type of device into which the digital wallet token is provisioned.

Enum: "MOBILE_PHONE" "TABLET" "WATCH"
provisioningAppVersion
required
string <= 50 characters

The version of the application making the provisioning request. Used for debugging and fraud prevention.

deviceId
required
string <= 24 characters

The cardholder's Android device ID, as provided during the provisioning process.

walletUserId
required
string <= 50 characters

The cardholder's digital wallet account ID, as provided during the provisioning process.

Responses
201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Method Not Allowed

415

Unsupported Media Type

429

Too Many Requests

500

Internal Server Error

post/cards/{cardId}/samsung-wallet
Request samples
application/json
{
  • "deviceType": "WATCH",
  • "provisioningAppVersion": "2.11.1",
  • "deviceId": "b39f54264a3d",
  • "walletUserId": "894b8236-b5cc-4f49-89f7-690d7bc4b9d2"
}
Response samples
application/json
{
  • "createdAt": "2023-03-14T12:08:53Z",
  • "updatedAt": "2023-03-14T12:08:53Z",
  • "pushTokenizeRequestData": {
    }
}