Skip to main content
PUT
/
digital-wallets
/
{digital_wallet_id}
C#
using Gr4vy;
using Gr4vy.Models.Components;

var sdk = new Gr4vySDK(
    id: "example",
    server: SDKConfig.Server.Sandbox,
    bearerAuthSource: Auth.WithToken(privateKey),
    merchantAccountId: "default"
);

var res = await sdk.DigitalWallets.UpdateAsync(
    digitalWalletId: "1808f5e6-b49c-4db9-94fa-22371ea352f5",
    digitalWalletUpdate: new DigitalWalletUpdate() {}
);

// handle response
{
  "type": "digital-wallet",
  "id": "1808f5e6-b49c-4db9-94fa-22371ea352f5",
  "merchant_account_id": "default",
  "provider": "apple",
  "merchant_name": "ACME Inc.",
  "merchant_display_name": "ACME",
  "merchant_url": "https://example.com",
  "merchant_country_code": "US",
  "domain_names": "example.com",
  "active_certificate_count": 2,
  "pending_certificate_count": 1,
  "expired_certificate_count": 0,
  "fields": {
    "digital_payment_application_id": "8faebf73-5b43-4514-b170-cbfb50c99fff",
    "digital_payment_application_name": "ACME"
  },
  "created_at": "2013-07-16T19:23:00.000+00:00",
  "updated_at": "2013-07-16T19:23:00.000+00:00"
}
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.

Headers

​
x-gr4vy-merchant-account-id
string

The ID of the merchant account to use for this request.

Examples:

"default"

Path Parameters

​
digital_wallet_id
string<uuid>
required

The ID of the digital wallet to edit.

Examples:

"1808f5e6-b49c-4db9-94fa-22371ea352f5"

Body

application/json

Request body for editing a registered digital wallet

​
merchant_name
string | null
Maximum length: 1024
​
domain_names
string[] | null
​
merchant_display_name
string | null
​
merchant_url
string | null
​
merchant_country_code
string | null
Examples:

"DE"

"GB"

"US"

Response

Successful Response

​
id
string<uuid>
required

The ID for the digital wallet.

Examples:

"1808f5e6-b49c-4db9-94fa-22371ea352f5"

​
merchant_account_id
string
required

The ID of the merchant account this digital wallet belongs to.

Examples:

"default"

​
provider
enum<string>
required

The name of the digital wallet provider.

Available options:
apple,
google,
click-to-pay
Examples:

"apple"

​
merchant_name
string
required

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

Examples:

"ACME Inc."

​
domain_names
string[]
required

The list of domain names that a digital wallet can be used on (deprecated).

Examples:

"example.com"

​
created_at
string<date-time>
required

The date this buyer was created at.

Examples:

"2013-07-16T19:23:00.000+00:00"

​
updated_at
string<date-time>
required

The date this buyer was last updated at.

Examples:

"2013-07-16T19:23:00.000+00:00"

​
type
string
default:digital-wallet

Always digital-wallet.

Allowed value: "digital-wallet"
Examples:

"digital-wallet"

​
merchant_display_name
string | null

The consumer facing name of the merchant.

Examples:

"ACME"

​
merchant_url
string | null

The main URL of the merchant.

Examples:

"https://example.com"

​
merchant_country_code
string | null

The country code where the merchant is registered.

Examples:

"US"

​
active_certificate_count
integer
default:0

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

Examples:

2

​
pending_certificate_count
integer
default:0

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

Examples:

1

​
expired_certificate_count
integer
default:0

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

Examples:

0

​
fields
object | null

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

Examples:
{
  "digital_payment_application_id": "8faebf73-5b43-4514-b170-cbfb50c99fff",
  "digital_payment_application_name": "ACME"
}