Create a Google digital wallet token

Creates a digital wallet token that can be added to a Google 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}

google-wallet

cURL

curl --request POST \
  --url 'https://api.equalsmoney.com/v2/cards/{cardId}/google-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",
  "serverSessionId": "abc123"
}
'

import requests

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

payload = {
    "deviceType": "WATCH",
    "provisioningAppVersion": "2.11.1",
    "deviceId": "b39f54264a3d",
    "walletUserId": "894b8236-b5cc-4f49-89f7-690d7bc4b9d2",
    "serverSessionId": "abc123"
}
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',
    serverSessionId: 'abc123'
  })
};

fetch('https://api.equalsmoney.com/v2/cards/{cardId}/google-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}/google-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',
    'serverSessionId' => 'abc123'
  ]),
  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}/google-wallet"

	payload := strings.NewReader("{\n  \"deviceType\": \"WATCH\",\n  \"provisioningAppVersion\": \"2.11.1\",\n  \"deviceId\": \"b39f54264a3d\",\n  \"walletUserId\": \"894b8236-b5cc-4f49-89f7-690d7bc4b9d2\",\n  \"serverSessionId\": \"abc123\"\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}/google-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  \"serverSessionId\": \"abc123\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.equalsmoney.com/v2/cards/{cardId}/google-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  \"serverSessionId\": \"abc123\"\n}"

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

{
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "pushTokenizeRequestData": {
    "displayName": "Visa 5678",
    "lastDigits": "3264",
    "network": "Visa",
    "tokenServiceProvider": "TOKEN_PROVIDER_VISA",
    "opaquePaymentCard": "my_opaque_payment_card_RUza...",
    "userAddress": {
      "name": "John Doe",
      "address1": "180 Grand Ave",
      "address2": "Suite 500",
      "city": "Oakland",
      "state": "CA",
      "postalCode": "94612",
      "country": "US",
      "phone": "5105551212"
    }
  },
  "googleOpaquePaymentCard": "google_opc_base64..."
}

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"

serverSessionId

string

The Google-supplied backend session identifier, taken from the Google Wallet onSessionCreated callback. Used to generate the Google OPC that saves the card to the cardholder's Google account (card-on-file). Only required when a Google OPC is needed.

Maximum string length: 50

Example:

"abc123"

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

required

Show child attributes

googleOpaquePaymentCard

string | null

required

An encrypted OPC that saves the funding card to the cardholder's Google account (card-on-file). Returned by Unified Push Provisioning; null when a Google OPC was not requested or is unavailable.

Example:

"google_opc_base64..."

⌘I

cURL

curl --request POST \
  --url 'https://api.equalsmoney.com/v2/cards/{cardId}/google-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",
  "serverSessionId": "abc123"
}
'

import requests

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

payload = {
    "deviceType": "WATCH",
    "provisioningAppVersion": "2.11.1",
    "deviceId": "b39f54264a3d",
    "walletUserId": "894b8236-b5cc-4f49-89f7-690d7bc4b9d2",
    "serverSessionId": "abc123"
}
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',
    serverSessionId: 'abc123'
  })
};

fetch('https://api.equalsmoney.com/v2/cards/{cardId}/google-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}/google-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',
    'serverSessionId' => 'abc123'
  ]),
  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}/google-wallet"

	payload := strings.NewReader("{\n  \"deviceType\": \"WATCH\",\n  \"provisioningAppVersion\": \"2.11.1\",\n  \"deviceId\": \"b39f54264a3d\",\n  \"walletUserId\": \"894b8236-b5cc-4f49-89f7-690d7bc4b9d2\",\n  \"serverSessionId\": \"abc123\"\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}/google-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  \"serverSessionId\": \"abc123\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.equalsmoney.com/v2/cards/{cardId}/google-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  \"serverSessionId\": \"abc123\"\n}"

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

{
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "pushTokenizeRequestData": {
    "displayName": "Visa 5678",
    "lastDigits": "3264",
    "network": "Visa",
    "tokenServiceProvider": "TOKEN_PROVIDER_VISA",
    "opaquePaymentCard": "my_opaque_payment_card_RUza...",
    "userAddress": {
      "name": "John Doe",
      "address1": "180 Grand Ave",
      "address2": "Suite 500",
      "city": "Oakland",
      "state": "CA",
      "postalCode": "94612",
      "country": "US",
      "phone": "5105551212"
    }
  },
  "googleOpaquePaymentCard": "google_opc_base64..."
}