DigitalWallet

The digital wallet entity represents a customer’s digital wallet service. Commerce Payments can use a digital wallet as a payment source when processing payments through a payment gateway. This object is available in API version 48.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert()

Special Access Rules

To access Commerce Payments entities, your org must have a Salesforce Order Management license with the Payment Platform org permission activated. Commerce Payments entities are available only in Lightning Experience.

Fields

Field	Details
AccountId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The account of the customer owns the digital wallet. This field is a relationship field. Relationship Name Account Relationship Type Lookup Refers To Account
AuditEmail	Type email Properties Create, Filter, Group, Nillable, Sort, Update Description Email of the digital wallet owner. This field is available in API v49.0 and later. It doesn’t appear in the UI by default for Salesforce orgs that upgraded from v48.0. Users must add it to the DigitalWallet page layout on their own.
Comments	Type textarea Properties Create, Nillable, Update Description Users can provide additional details about the digital wallet. Supports a maximum of 1000 characters.
CompanyName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Company of the digital wallet owner.
Customer	Type string Properties Create, Filter, Group, Nillable, Sort Description Customer name of the digital wallet owner.
DigitalWalletNumber	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description System-generated reference number for the digital wallet.
Email	Type email Properties Create, Filter, Group, Nillable, Sort, Update Description Email of the digital wallet owner.
GatewayToken	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Unencrypted unique token ID generated by the payment gateway to represent the digital wallet during transactions. This field is available for backward compatibility. To secure the token, use the GatewayTokenEncrypted field. If you try to record a GatewayToken for a digital wallet that already has a GatewayToken or GatewayTokenEncrypted value, Salesforce throws an error.
GatewayTokenDetails	Type textarea Properties Create, Filter, Nillable, Sort, Update Description Unique ID generated by the payment gateway for the card for future transactions.
GatewayTokenEncrypted	Type encryptedstring Properties Create, Nillable, Update Description Encrypted unique token ID generated by the payment gateway to represent the digital wallet during transactions. Encrypted using Salesforce Classic Encryption for custom fields. Available in API v52.0 and later.
IpAddress	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The IP address of the digital wallet owner. This field is available in API v49.0 and later. It doesn’t appear in the UI by default for Salesforce orgs that upgraded from v48.0. Users must add it to the DigitalWallet page layout on their own.
IsAutoPayEnabled	Type boolean Properties Create, Defaulted on create, Filter, Group, Update, Sort Indicates whether the payment method can be used for recurring payments (True) or not (False). The default value is False. This field is available in API v55.0 and later. For orgs that upgraded from v54.0, you must add this field to the Digital Wallet page layout in the UI. It isn't automatically added.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed a record related to this record.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed this record. If this value is null, it's possible the user only referenced this record (LastReferencedDate) but not viewed it.
MacAddress	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The MAC address of the digital wallet owner. This field is available in API v49.0 and later. It doesn’t appear in the UI by default for Salesforce orgs that upgraded from v48.0. Users must add it to the DigitalWallet page layout on their own.
NickName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description User-defined nickname for the digital wallet.
PaymentGatewayId	Type reference Properties Create, Filter, Group, Nillable, Sort Description Gateway used with transactions for the digital wallet. This field is a relationship field. Relationship Name PaymentGateway Relationship Type Lookup Refers To PaymentGateway
PaymentMethodAddress	Type address Properties Filter, Nillable Description Part of the address for the payment method.
PaymentMethodCity	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Part of the address for the payment method.
PaymentMethodCountry	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Part of the address for the payment method.
PaymentMethodGeocodeAccuracy	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Part of the address for the payment method.
PaymentMethodLatitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Part of the address for the payment method.
PaymentMethodLongitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Part of the address for the payment method.
PaymentMethodPostalCode	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Part of the address for the payment method.
PaymentMethodState	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Part of the address for the payment method.
PaymentMethodStreet	Type textarea Properties Create, Filter, Group, Nillable, Sort, Update Description Part of the address for the payment method.
Phone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description Phone number of the digital wallet owner. This field is available in API v49.0 and later. It doesn’t appear in the UI by default for Salesforce orgs that upgraded from v48.0. Users must add it to the DigitalWallet page layout on their own.
ProcessingMode	Type picklist Properties Create, Filter, Group, Restricted picklist, Sort Description Defines whether the digital wallet is used for transactions made inside or outside the payment platform. Possible values are: `External`—Transactions happened outside of the Salesforce payments platform. `Salesforce`—Salesforce made and recorded an external call to the payment platform. This field is available in API v49.0 and later. It doesn’t appear in the UI by default for Salesforce orgs that upgraded from v48.0. Users must add it to the DigitalWallet page layout on their own. ProcessingMode is required to create a DigitalWallet entity. Important
Status	Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description Defines the state of the digital wallet as a payment source. Possible values are: `Active`—Customers can make payments with the digital wallet. `Canceled`—The digital wallet can no longer be used for payments. This status can’t be changed. `InActive`—The digital wallet can’t be used for payments until a user changes its status to Active.

Object Reference for the Salesforce Platform

DigitalWallet

Supported Calls

Special Access Rules

Fields