PUT
/
digital-wallets
/
{digital_wallet_id}
curl --request PUT \
  --url https://api.{gr4vy_id}.gr4vy.app/digital-wallets/{digital_wallet_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "merchant_name": "Gr4vy",
  "domain_names": [
    "example.com"
  ],
  "merchant_display_name": "Gr4vy",
  "merchant_country_code": "US",
  "merchant_url": "https://example.com"
}'
{
  "type": "digital-wallet",
  "id": "8d3fe99b-1422-42e6-bbb3-932d95ae5f79",
  "merchant_account_id": "default",
  "provider": "apple",
  "merchant_name": "Gr4vy",
  "merchant_url": "https://example.com",
  "merchant_display_name": "Gr4vy",
  "merchant_country_code": "US",
  "domain_names": [
    "example.com"
  ],
  "fields": {
    "digital_payment_application_id": "<string>",
    "digital_payment_application_name": "<string>"
  },
  "created_at": "2012-12-12T10:53:43+00:00",
  "updated_at": "2012-12-12T10:53:43+00:00",
  "active_certificate_count": 1,
  "pending_certificate_count": 1,
  "expired_certificate_count": 1
}

This endpoint requires the digital-wallets.write scope.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
digital_wallet_id
string
required

The ID of the registered digital wallet.

Example:

"fe26475d-ec3e-4884-9553-f7356683f7f9"

Body

application/json

Request body to update a registered digital wallet's details.

​
merchant_name
string

The name of the merchant. This is used to update the value initially used to register with a digital wallet provider and this name is not displayed to the buyer.

Example:

"Gr4vy"

​
domain_names
string[]

The list of domain names that a digital wallet can be used on. To use a digital wallet on a website, the domain of the site is required to be in this list.

Example:
["example.com"]
​
merchant_display_name
string | null

The consumer facing name of the merchant.

Example:

"Gr4vy"

​
merchant_country_code
string | null

The country code where the merchant is registered.

Required string length: 2
Example:

"US"

​
merchant_url
string

The main URL of the merchant.

Example:

"https://example.com"

Response

200
application/json
Returns the updated digital wallet.

A digital wallet (e.g. Apple Pay) that has been registered.

​
type
enum<string>

digital-wallet.

Available options:
digital-wallet
Example:

"digital-wallet"

​
id
string

The ID of the registered digital wallet.

Example:

"8d3fe99b-1422-42e6-bbb3-932d95ae5f79"

​
merchant_account_id
string

The unique ID for a merchant account.

Example:

"default"

​
provider
enum<string>

The name of the digital wallet provider.

Available options:
apple,
google
Example:

"apple"

​
merchant_name
string

The name of the merchant the digital wallet is registered to.

Example:

"Gr4vy"

​
merchant_url
string | null

The main URL of the merchant.

Example:

"https://example.com"

​
merchant_display_name
string | null

The consumer facing name of the merchant.

Example:

"Gr4vy"

​
merchant_country_code
string | null

The country code where the merchant is registered.

Required string length: 2
Example:

"US"

​
domain_names
string[]

The list of domain names that a digital wallet can be used on. To use a digital wallet on a website, the domain of the site is required to be in this list.

Example:
["example.com"]
​
fields
object

Custom attributes for some digital wallets. Currently only used by Click to Pay.

​
created_at
string

The date and time when this digital wallet was registered.

Example:

"2012-12-12T10:53:43+00:00"

​
updated_at
string

The date and time when this digital wallet was last updated.

Example:

"2012-12-12T10:53:43+00:00"

​
active_certificate_count
integer

The number of active custom certificates registered for this digital wallet (Apple Pay only).

Example:

1

​
pending_certificate_count
integer

The number of pending custom certificates registered for this digital wallet (Apple Pay only).

Example:

1

​
expired_certificate_count
integer

The number of expired custom certificates registered for this digital wallet (Apple Pay only).

Example:

1

Was this page helpful?

Register digital walletDe-register digital wallet