Create a Samsung digital wallet token

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.

POST

cards

{cardId}

samsung-wallet

cURL

curl --request POST \
  --url 'https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet?accountId={{accountId}}' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deviceType": "WATCH",
  "provisioningAppVersion": "2.11.1",
  "deviceId": "b39f54264a3d",
  "walletUserId": "894b8236-b5cc-4f49-89f7-690d7bc4b9d2"
}
'

import requests

url = "https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet"

payload = {
    "deviceType": "WATCH",
    "provisioningAppVersion": "2.11.1",
    "deviceId": "b39f54264a3d",
    "walletUserId": "894b8236-b5cc-4f49-89f7-690d7bc4b9d2"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    deviceType: 'WATCH',
    provisioningAppVersion: '2.11.1',
    deviceId: 'b39f54264a3d',
    walletUserId: '894b8236-b5cc-4f49-89f7-690d7bc4b9d2'
  })
};

fetch('https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'deviceType' => 'WATCH',
    'provisioningAppVersion' => '2.11.1',
    'deviceId' => 'b39f54264a3d',
    'walletUserId' => '894b8236-b5cc-4f49-89f7-690d7bc4b9d2'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet"

	payload := strings.NewReader("{\n  \"deviceType\": \"WATCH\",\n  \"provisioningAppVersion\": \"2.11.1\",\n  \"deviceId\": \"b39f54264a3d\",\n  \"walletUserId\": \"894b8236-b5cc-4f49-89f7-690d7bc4b9d2\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"deviceType\": \"WATCH\",\n  \"provisioningAppVersion\": \"2.11.1\",\n  \"deviceId\": \"b39f54264a3d\",\n  \"walletUserId\": \"894b8236-b5cc-4f49-89f7-690d7bc4b9d2\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"deviceType\": \"WATCH\",\n  \"provisioningAppVersion\": \"2.11.1\",\n  \"deviceId\": \"b39f54264a3d\",\n  \"walletUserId\": \"894b8236-b5cc-4f49-89f7-690d7bc4b9d2\"\n}"

response = http.request(request)
puts response.read_body

{
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "pushTokenizeRequestData": {
    "cardType": "CREDIT",
    "displayName": "Visa 5678",
    "extraProvisionPayload": "string",
    "lastDigits": "5678",
    "network": "CREDIT",
    "tokenServiceProvider": "MC"
  }
}

Authorizations

Authorization

string

header

required

Path Parameters

cardId

string<uuid>

required

The ID of the card to work with.

Maximum string length: 36

Example:

"e9293471-5eb3-4dbc-916c-dbaf9e2deefd"

Query Parameters

accountId

string

required

The ID of the account to work with.

Example:

"F50091"

personId

string<uuid>

The ID of the person to work with.

Maximum string length: 36

Example:

"775596ae-2624-40af-a9dc-9756110a4a04"

Body

application/json

Body

deviceType

enum<string>

required

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

Available options:

MOBILE_PHONE,

TABLET,

WATCH

Example:

"WATCH"

provisioningAppVersion

string

required

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

Maximum string length: 50

Example:

"2.11.1"

deviceId

string

required

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

Maximum string length: 24

Example:

"b39f54264a3d"

walletUserId

string

required

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

Maximum string length: 50

Example:

"894b8236-b5cc-4f49-89f7-690d7bc4b9d2"

Response

201 - application/json

Created

createdAt

string<date-time>

required

The date the Resource was initially created. ISO 8601 format without milliseconds.

updatedAt

string<date-time>

required

The date the Resource was last modified. ISO 8601 format without milliseconds.

pushTokenizeRequestData

object

Show child attributes

⌘I

cURL

curl --request POST \
  --url 'https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet?accountId={{accountId}}' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deviceType": "WATCH",
  "provisioningAppVersion": "2.11.1",
  "deviceId": "b39f54264a3d",
  "walletUserId": "894b8236-b5cc-4f49-89f7-690d7bc4b9d2"
}
'

import requests

url = "https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet"

payload = {
    "deviceType": "WATCH",
    "provisioningAppVersion": "2.11.1",
    "deviceId": "b39f54264a3d",
    "walletUserId": "894b8236-b5cc-4f49-89f7-690d7bc4b9d2"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    deviceType: 'WATCH',
    provisioningAppVersion: '2.11.1',
    deviceId: 'b39f54264a3d',
    walletUserId: '894b8236-b5cc-4f49-89f7-690d7bc4b9d2'
  })
};

fetch('https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'deviceType' => 'WATCH',
    'provisioningAppVersion' => '2.11.1',
    'deviceId' => 'b39f54264a3d',
    'walletUserId' => '894b8236-b5cc-4f49-89f7-690d7bc4b9d2'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet"

	payload := strings.NewReader("{\n  \"deviceType\": \"WATCH\",\n  \"provisioningAppVersion\": \"2.11.1\",\n  \"deviceId\": \"b39f54264a3d\",\n  \"walletUserId\": \"894b8236-b5cc-4f49-89f7-690d7bc4b9d2\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"deviceType\": \"WATCH\",\n  \"provisioningAppVersion\": \"2.11.1\",\n  \"deviceId\": \"b39f54264a3d\",\n  \"walletUserId\": \"894b8236-b5cc-4f49-89f7-690d7bc4b9d2\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.equalsmoney.com/v2/cards/{cardId}/samsung-wallet")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"deviceType\": \"WATCH\",\n  \"provisioningAppVersion\": \"2.11.1\",\n  \"deviceId\": \"b39f54264a3d\",\n  \"walletUserId\": \"894b8236-b5cc-4f49-89f7-690d7bc4b9d2\"\n}"

response = http.request(request)
puts response.read_body

{
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "pushTokenizeRequestData": {
    "cardType": "CREDIT",
    "displayName": "Visa 5678",
    "extraProvisionPayload": "string",
    "lastDigits": "5678",
    "network": "CREDIT",
    "tokenServiceProvider": "MC"
  }
}

Group placeholder

Group

Group

Create a Samsung digital wallet token

Authorizations

Path Parameters

Query Parameters

Body

Response