Google Pay push provisioning

This endpoint is only used for Google Pay push provisioning.

Response is a JSON that must be passed to Google and onwards to MDES/VTS.

Google is introducing Unified Android Push Provisioning (UPP) for Google Wallet.

Existing Enfuce Google Pay Push Provisioning integrations remain backwards compatible. Customers migrating to UPP only need to extend their existing integration with two additional request fields (googleOpaquePaymentCardRequested and serverSessionId) and one additional response field (googleOpaquePaymentCard).

These fields are only required when integrating with Google’s Unified Android Push Provisioning flow. Existing integrations using the legacy Google Pay Push Provisioning flow continue to work unchanged.

POST

{cardId}

provision

googlepay

Google Pay push provisioning

curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientAppID": "<string>",
  "clientDeviceID": "<string>",
  "clientWalletAccountID": "<string>",
  "googleOpaquePaymentCardRequested": false,
  "serverSessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay"

payload = {
    "clientAppID": "<string>",
    "clientDeviceID": "<string>",
    "clientWalletAccountID": "<string>",
    "googleOpaquePaymentCardRequested": False,
    "serverSessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientAppID: '<string>',
    clientDeviceID: '<string>',
    clientWalletAccountID: '<string>',
    googleOpaquePaymentCardRequested: false,
    serverSessionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  })
};

fetch('https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay', 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://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay",
  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([
    'clientAppID' => '<string>',
    'clientDeviceID' => '<string>',
    'clientWalletAccountID' => '<string>',
    'googleOpaquePaymentCardRequested' => false,
    'serverSessionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "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://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay"

	payload := strings.NewReader("{\n  \"clientAppID\": \"<string>\",\n  \"clientDeviceID\": \"<string>\",\n  \"clientWalletAccountID\": \"<string>\",\n  \"googleOpaquePaymentCardRequested\": false,\n  \"serverSessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")

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

	req.Header.Add("Authorization", "Basic <encoded-value>")
	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://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientAppID\": \"<string>\",\n  \"clientDeviceID\": \"<string>\",\n  \"clientWalletAccountID\": \"<string>\",\n  \"googleOpaquePaymentCardRequested\": false,\n  \"serverSessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clientAppID\": \"<string>\",\n  \"clientDeviceID\": \"<string>\",\n  \"clientWalletAccountID\": \"<string>\",\n  \"googleOpaquePaymentCardRequested\": false,\n  \"serverSessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"

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

{
  "digitizationData": "<string>",
  "googleOpaquePaymentCard": "<string>"
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

cardId

integer<int64>

required

CardId for the card that should be provisioned (returned from card operation)

Query Parameters

auditUser

string

required

The audit user to log the request

Body

application/json

clientAppID

string

Only applicable for VTS customers

Maximum string length: 36

clientDeviceID

string

clientWalletAccountID

string

googleOpaquePaymentCardRequested

boolean

default:false

When true, a Google OPC is generated and returned in googleOpaquePaymentCard. Requires serverSessionId.

serverSessionId

string<uuid>

UUID generated by the Google Wallet SDK for Unified Push Provisioning. Required when googleOpaquePaymentCardRequested is true; ignored otherwise.

Response

digitizationData

string

Base64 encoded json structure containing needed data for MDES/VTS

googleOpaquePaymentCard

string

Base64-encoded (RFC 4648 §4, non-URL-safe) PGP signed and encrypted Google Opaque Payment Card. Present only on Google Pay provisioning responses when the request included a serverSessionId.

⌘I

Google Pay push provisioning

curl --request POST \
  --url 'https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientAppID": "<string>",
  "clientDeviceID": "<string>",
  "clientWalletAccountID": "<string>",
  "googleOpaquePaymentCardRequested": false,
  "serverSessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay"

payload = {
    "clientAppID": "<string>",
    "clientDeviceID": "<string>",
    "clientWalletAccountID": "<string>",
    "googleOpaquePaymentCardRequested": False,
    "serverSessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientAppID: '<string>',
    clientDeviceID: '<string>',
    clientWalletAccountID: '<string>',
    googleOpaquePaymentCardRequested: false,
    serverSessionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  })
};

fetch('https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay', 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://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay",
  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([
    'clientAppID' => '<string>',
    'clientDeviceID' => '<string>',
    'clientWalletAccountID' => '<string>',
    'googleOpaquePaymentCardRequested' => false,
    'serverSessionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "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://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay"

	payload := strings.NewReader("{\n  \"clientAppID\": \"<string>\",\n  \"clientDeviceID\": \"<string>\",\n  \"clientWalletAccountID\": \"<string>\",\n  \"googleOpaquePaymentCardRequested\": false,\n  \"serverSessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")

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

	req.Header.Add("Authorization", "Basic <encoded-value>")
	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://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientAppID\": \"<string>\",\n  \"clientDeviceID\": \"<string>\",\n  \"clientWalletAccountID\": \"<string>\",\n  \"googleOpaquePaymentCardRequested\": false,\n  \"serverSessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://integration-api-cat2.{{environment}}.ext.{{realm}}.cia.enfuce.com/wallet/v1/{cardId}/provision/googlepay")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clientAppID\": \"<string>\",\n  \"clientDeviceID\": \"<string>\",\n  \"clientWalletAccountID\": \"<string>\",\n  \"googleOpaquePaymentCardRequested\": false,\n  \"serverSessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"

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

{
  "digitizationData": "<string>",
  "googleOpaquePaymentCard": "<string>"
}

Introduction

Account Details

Authorisation Control

Authorisation Forwarding

Card details

Customer

Exchange Rates API

ID

Instalment

Invoice

Notification

PIN

PIN Control

Purchase Details

Repricing

Transaction

Transfer API

Wallet

Test API

Hierarchy API

Spend Control API

Fraud Case API

Google Pay push provisioning

Authorizations

Path Parameters

Query Parameters

Body

Response