POST
/
digital-wallets

This endpoint requires the digital-wallets.write scope.

Authorizations

Authorization
string
headerrequired

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

Body

application/json

Merchant details used to register with a digital wallet provider.

provider
enum<string>
required

The name of the digital wallet provider.

Available options:
apple,
google
merchant_name
string
required

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

merchant_url
string | null

The main URL of the merchant.

merchant_display_name
string | null

The consumer facing name of the merchant.

merchant_country_code
string | null

The country code where the merchant is registered.

domain_names
string[]
required

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.

accept_terms_and_conditions
boolean
required

The explicit acceptance of the digital wallet provider's terms and conditions by the merchant. Needs to be true to register a new digital wallet.

Response

201 - application/json

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

type
enum<string>

digital-wallet.

Available options:
digital-wallet
id
string

The ID of the registered digital wallet.

merchant_account_id
string

The unique ID for a merchant account.

provider
enum<string>

The name of the digital wallet provider.

Available options:
apple,
google
merchant_name
string

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

merchant_url
string | null

The main URL of the merchant.

merchant_display_name
string | null

The consumer facing name of the merchant.

merchant_country_code
string | null

The country code where the merchant is registered.

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.

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.

updated_at
string

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

active_certificate_count
integer

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

pending_certificate_count
integer

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

expired_certificate_count
integer

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