latestOpenAPI 3.0.12026-08-10122864.6 KB

15f03804be72

Push provisioning

Fetch wallet payload for Google Pay in-app provisioning

Returns a wallet payload for adding the customer's card to their Google Pay wallet via request to the Google Pay API. <br>Note: This endpoint will trigger the change request process. The customer will receive a 2FA challenge to confirm the request.

post/v1/cards/{card_id}/sca_push_provision/google

Path parameters

card_idstring required

The unique identifier of the customer's card.

Request body

client_app_id'SolarisPushProvisioning'

Unique identifier for the client application. Use the value SolarisPushProvisioning.

client_device_idstring

Stable identifier for a physical Android device. Google refers to this attribute as a Stable hardware ID in their SDK documentation. Use the getStableHardwareId method to retrieve this value.

client_wallet_account_idstring

Unique 24-byte identifier for each instance of a [Android user, Google account] pair. Google computes the ID as a keyed hash of the Android user ID and the Google account ID. The key to this hash lives on Google's servers; the wallet ID is created during user setup as an RPC.

Example request

{
  "client_app_id": "SolarisPushProvisioning",
  "client_device_id": "DeviceIDZIiG3a0DgF4mQfkC",
  "client_wallet_account_id": "Rwt3tJek_k1JxivcwbPHjKDk"
}

Response

The request was accepted, and now the customer must confirm the change request.

idstring

ID of the change request.

status'ACCEPTED' | 'AUTHORIZATION_REQUIRED' | 'CONFIRMATION_REQUIRED' | 'COMPLETED' | 'FAILED'

The current status of the change request.

updated_atstring date-time

UTC timestamp from the last time the change request was updated.

urlstring

URL to use to authorize the change request.

Example response

{
  "id": "d6c778822b2d7bd3b778935bcfd0d1d3csc",
  "status": "AUTHORIZATION_REQUIRED",
  "updated_at": "2022-04-21T13:59:52+00:00",
  "url": "https://example.com/authorize"
}