Create a mobile wallet push provisioning request

curl --request POST \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/create_mobile_wallet_provisioning_request \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "wallet_provider": "apple_pay",
  "apple_pay": {
    "leaf_cert": "<string>",
    "subordinate_cert": "<string>",
    "nonce": "<string>",
    "nonce_signature": "<string>",
    "encoding": "base64"
  },
  "google_pay": {
    "client_wallet_account_id": "<string>",
    "client_device_id": "<string>"
  }
}
'

{
  "wallet_provider": "apple_pay",
  "apple_pay": {
    "activation_data": "<string>",
    "encrypted_pass_data": "<string>",
    "ephemeral_public_key": "<string>"
  },
  "google_pay": {
    "opaque_payment_card": "<string>"
  }
}

POST

customers

{customerID}

card_accounts

{cardAccountID}

create_mobile_wallet_provisioning_request

Create a mobile wallet push provisioning request

curl --request POST \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/create_mobile_wallet_provisioning_request \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "wallet_provider": "apple_pay",
  "apple_pay": {
    "leaf_cert": "<string>",
    "subordinate_cert": "<string>",
    "nonce": "<string>",
    "nonce_signature": "<string>",
    "encoding": "base64"
  },
  "google_pay": {
    "client_wallet_account_id": "<string>",
    "client_device_id": "<string>"
  }
}
'

{
  "wallet_provider": "apple_pay",
  "apple_pay": {
    "activation_data": "<string>",
    "encrypted_pass_data": "<string>",
    "ephemeral_public_key": "<string>"
  },
  "google_pay": {
    "opaque_payment_card": "<string>"
  }
}

Authorizations

Api-Key

string

header

required

Headers

Idempotency-Key

string

required

Path Parameters

customerID

string

required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

cardAccountID

string

required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Body

application/json

A mobile wallet push provisioning request

wallet_provider

enum<string>

The wallet provider of the push provisioning request

Available options:

apple_pay,

google_pay

apple_pay

object

Apple Pay specific provisioning request data. Required for apple_pay wallet provider.

Show child attributes

apple_pay.leaf_cert

string

required

The leaf certificate returned by the wallet provider that was signed using the subordinate cert. The binary data of this certificate should be hex (case-insensitive) or base64 encoded, as specified by the encoding field

apple_pay.subordinate_cert

string

required

The subordinate certificate returned by the wallet provider that was signed using the wallet provider's Certificate Authority (CA) certificate. The binary data of this certificate should be hex (case-insensitive) or base64 encoded, as specified by the encoding field

apple_pay.nonce

string

required

The nonce value returned by Apple Pay. It should be hex (case-insensitive) or base64 encoded, as specified by the encoding field

apple_pay.nonce_signature

string

required

The nonce signature value returned by Apple Pay. It should be hex (case-insensitive) or base64 encoded, as specified by the encoding field

apple_pay.encoding

enum<string>

Specifies the encoding of each field in the Apple Pay provisioning request. Defaults to hex if unspecified.

Available options:

base64,

hex

google_pay

object

Google Pay specific push provisioning request data. Required for google_pay wallet provider.

Show child attributes

google_pay.client_wallet_account_id

string

required

Value returned by Google Pay for use with Visa

google_pay.client_device_id

string

required

Value returned by Google Pay for use with Visa

Response

A successful push provisioning response

The mobile wallet push provisioning response

wallet_provider

enum<string>

The wallet provider of the push provisioning request

Available options:

apple_pay,

google_pay

apple_pay

object

The detailed provisioning request data that need to be sent directly to the apple_pay wallet provider

Show child attributes

apple_pay.activation_data

string

The request's activation data. This field is always Base64-encoded

apple_pay.encrypted_pass_data

string

An encrypted JSON file containing the sensitive information needed to add a card to a wallet. This field is always Base64-encoded

apple_pay.ephemeral_public_key

string

A generated key that is combined with a private key. This field is always Base64-encoded

google_pay

object

The detailed provisioning request data that need to be sent directly to the google_pay wallet provider

Show child attributes

google_pay.opaque_payment_card

string

A Base64-encoded or Base64url-encoded opaque string

Unfreeze the card account Retrieve pending card authorizations

⌘I

Endpoints

Authorizations

Headers

Path Parameters

Body

Response