Newer Version Available

This content describes an older version of this product. View Latest

PaymentLink

A payment link that a merchant can embed into a Salesforce app. The link directs payers to a Pay Now page that shows what’s being paid for, in the payers currency, and lets payers enter their payment data. This object is available in API version 58.0 and later.

Supported Calls

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

Special Access Rules

To access Commerce PaymentLink, your org must have a Salesforce Payments license.

Fields

Field Details
AccountId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Payer account.
This field is a relationship field.
Relationship Name
Account
Relationship Type
Lookup
Refers To
Account
Amount
Type
currency
Properties
Create, Filter, Sort, Update
Description
Amount the payer owes.
CartId
Type
reference
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
The ID of the cart record.
Relationship Name
Cart
Relationship Type
Lookup
Refers To
Webcart
CurrencyIsoCode
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
3-digit ISO code for the payment currency that is shown on the Pay Now page. Possible values are:
  • EUR – Euro
  • GBP – British Pound
  • USD – US Dollar
The default value is USD.
Description
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
A description on the Pay Now page explaining what is being paid.
Expiry Time
Type
dateTime
Properties
Create, Filter, Nillable, Sort, Update
Description
The date and time that the payment link expires. The time is based on the user’s time zone, not the org’s time zone.
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, this record can be referenced and not viewed directly.
OwnerId
Type
reference
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
The ID of the user who owns this record.
Relationship Name
Owner
Relationship Type
Lookup
Refers To
Group, User
PaymentLinkNumber
Type
string
Properties
Autonumber, Defaulted on create, Filter, idLookup, Sort
Description
Auto-generated number that identifies the payment link.
PaymentMethodSetId
Type
reference
Properties
Create, Filter, Group, Sort, Update
Description
Reference to the PaymentMethodSet object, which determines what payment methods are shown to the payer.
This field is a relationship field.
Relationship Name
PaymentMethodSet
Relationship Type
Lookup
Refers To
MerchAccPaymentMethodSet
PaymentUrl
Type
url
Properties
Filter, Group, Sort
Description
Unique URL of the Pay Now page. This URL IS auto-generated, and not editable.
QrCodeImageId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
Reference to the QR code image included in the payment link record.
This field is a relationship field.
Relationship Name
QrCodeImage
Relationship Type
Lookup
Refers To
ContentVersion
Status
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update
Description
Indicates whether the payment link is active and can be used.
Possible values are:
  • Active
  • Disabled
The default value is Active.
TaxAmount
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
Amount of the tax for the purchase. This amount is shown on the Pay Now page.
Title
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Title of the Pay Now page, indicating what is being paid.
Type
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Restricted picklist, Sort
Description
Indicates the type of payment link created, which the merchant can share with the customer to receive payment. The payment link also determines which Pay Now page is generated and what’s included on that page.
Possible values are:
  • CheckoutWithOrder (only for orgs with Payments and Commerce).– includes the amount owed based on the products you select, lists the products purchased, and calculates tax using the billing address and selected shipping options. After a customer makes a payment, this link type creates an order record. The merchant can’t edit the cart with this link type.
  • PredefinedAmount—shows only an amount due for products purchased. The merchant enters the amount due when creating the payment link.
  • WithProducts—includes the amount owed, and lists the products purchased. Tax and shipping costs are calculated manually. The merchant can’t edit the cart with this link type.
The default value is PredefinedAmount.
UsageType
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Restricted picklist, Sort
Description
Determines whether the payment link is used one time or multiple times before the configured expiration date and time.
Possible values are:
  • MultiUse—Multiple Uses
  • SingleUse
The default value is MultiUse.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

PaymentLinkOwnerSharingRule
Sharing rules are available for the object.
PaymentLinkShare
Sharing is available for the object.