この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

CardPaymentMethod

クレジットカードまたはデビットカードの支払方法を表し、PaymentMethod オブジェクトを実装します。このオブジェクトは、API バージョン 48.0 以降で使用できます。

サポートされているコール

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

特別なアクセスルール

API で Salesforce Payment オブジェクトにアクセスするには、組織に 1 つ以上の Salesforce Payments ライセンス、Salesforce Order Management ライセンス、B2B Commerce ライセンス、または D2C Commerce ライセンスが必要です。Salesforce Payment オブジェクトは、Lightning Experience のみで使用できます。

項目

項目 詳細
AccountId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払方法のカスタマー取引先。
この項目はリレーション項目です。
リレーション名
Account
リレーション種別
Lookup
参照先
Account
AuditEmail
email
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払に関する監査情報が送信される、カード所有者のメールアドレス。
この項目は API v49.0 以降で使用できます。V48.0 からアップグレードした組織では、デフォルトでは UI に表示されません。ユーザーが自分で CardPaymentMethod ページレイアウトに追加する必要があります。
AutoCardType
string
プロパティ
Create、Filter、Group、Nillable、Sort
説明
カード番号に基づくカードネットワーク種別。
CardBin
int
プロパティ
Create、Filter、Group、Nillable、Sort
説明
カード番号の上 6 桁。
CardCategory
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort
説明
カードがクレジットカードかデビットカードかを定義します。
可能な値は次のとおりです。
  • CreditCard
  • DebitCard
CardHolderFirstName
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カード所有者の名。
CardHolderLastName
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カード所有者の姓。
CardHolderName
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カード所有者の氏名。
CardLastFour
int
プロパティ
Create、Filter、Group、Nillable、Sort
説明
クレジットカードまたはデビットカードの下 4 桁。
CardPaymentMethodNumber
string
プロパティ
Autonumber、Defaulted on create、Filter、idLookup、Sort
説明
システムが定義したカード支払方法の一意の ID。
CardType
picklist
プロパティ
Create、Filter、Group、Nillable、Sort
説明
クレジットカード種別を識別します。
可能な値は次のとおりです。
  • American Express
  • Diners Club
  • JCB
  • Maestro
  • Master Card
  • Visa
CardTypeCategory
picklist
プロパティ
Filter、Group、Nillable、Restricted picklist、Sort
説明
クレジットカードをさらに識別します。内部の参照用です。
可能な値は次のとおりです。
  • AmericanExpress
  • DinersClub
  • Discover
  • Jcb
  • Maestro
  • MasterCard
  • UnionPay
  • Visa
Comments
textarea
プロパティ
Create、Nillable、Update
説明
支払管理者がレコードの詳細に関するコメントを追記できます。最大 1000 文字です。
CompanyName
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カード所有者の会社。
DisplayCardNumber
string
プロパティ
Filter、Group、Nillable、Sort
説明
クレジットカード番号全体の下 4 桁以外をマスクした数字。
Email
email
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払者のメールアドレス。
ExpiryMonth
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カードの有効期限 (月)。
ExpiryYear
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カードの有効期限 (年)。
GatewayDate
dateTime
プロパティ
Create、Filter、Nillable、Sort、Update
説明
支払ゲートウェイでカード活動を記録する日付。
GatewayResultCode
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
取引要求時のカード支払方法と支払ゲートウェイのインタラクションの結果。
GatewayResultCodeDescription
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ゲートウェイ結果コードに関する追加情報。説明は、支払ゲートウェイプロバイダーごとに異なります。
GatewayToken
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
取引の間に支払ゲートウェイが生成したカード支払方法を表す暗号化されていない一意のトークン ID。GatewayToken は、バージョン 52.0 より前の API で使用されます。バージョン 53.0 以降では、GatewayTokenEncrypted 項目を使用します。トークンの保護には、GatewayTokenEncrypted 項目を使用します。
GatewayToken の記録を試みたときに、カード支払方法に GatewayToken または GatewayTokenEncrypted の値がすでにあった場合は、エラーメッセージが表示されます。
GatewayTokenDetails
textarea
プロパティ
Create、Filter、Nillable、Sort、Update
説明
ゲートウェイトークンに関する追加情報。
GatewayTokenEncrypted
encryptedstring
プロパティ
Create、Nillable、Update
説明
取引の間に支払ゲートウェイが生成したカード支払方法を表す暗号化された一意のトークン ID。Salesforce Classic の暗号化を使用して暗号化されます。
API バージョン 52.0 以降で使用できます。
InputCardNumber
string
プロパティ
Create、Filter、Group、Nillable、Sort
説明
外部種別のカード支払方法を保存するときに支払者がクレジットカード番号を入力するために使用します。入力が終わった後、クレジットカード番号は保存されないため、InputCardNumber の値は常に空白で表示されます。DisplayCardNumber では、クレジットカード番号の値がマスクされ、下 4 桁のみが表示されます。
IpAddress
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カード支払方法の保有者の IP アドレス。
この項目は、API バージョン 49.0 以降で使用できます。バージョン 48.0 からアップグレードした Salesforce 組織では、デフォルトで UI に表示されません。ユーザーが自分で CardPaymentMethod ページレイアウトに追加する必要があります。
IsAutoPayEnabled
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
支払方法が定期的な支払で使用できるか (True)、否か (False) を示します。デフォルト値は False です。
この項目は、API バージョン 55.0 以降で使用できます。バージョン 54.0 からアップグレードした組織では、この項目を UI の [カード支払方法] ページレイアウトに追加する必要があります。自動的には追加されません。
LastReferencedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
現在のユーザーがこのレコードに関連するリストビューを最後に表示した (直接アクセスしていない) ときのタイムスタンプ。
LastViewedDate
dateTime
プロパティ
Filter、Nillable、Sort
説明
現在のユーザーがこのレコードを最後に表示したときのタイムスタンプ。この値が null の場合、ユーザーはこのレコードを参照しているが、直接表示していない可能性があります。
MacAddress
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カード支払方法の保有者の MAC アドレス。
この項目は、API バージョン 49.0 以降で使用できます。バージョン 48.0 からアップグレードした Salesforce 組織では、デフォルトで UI に表示されません。ユーザーが自分で CardPaymentMethod ページレイアウトに追加する必要があります。
NickName
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払者が定義したカード支払方法のニックネーム。
PaymentGatewayId
reference
プロパティ
Create、Filter、Group、Nillable、Sort
説明
ゲートウェイトークンの作成に使用する支払ゲートウェイ。Salesforce に保存されている支払方法を使用した取引の場合、取引に使用する支払ゲートウェイ ID がこの項目に保存されます。
この項目はリレーション項目です。
リレーション名
PaymentGateway
リレーション種別
Lookup
参照先
PaymentGateway
PaymentMethodAddress
address
プロパティ
Filter、Nillable
説明
カード支払方法に関連付けられた完全な住所。
PaymentMethodCity
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払方法の住所の市区郡。
PaymentMethodCountry
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払方法の住所の国。
PaymentMethodDetails
string
プロパティ
Create、Filter、Group、Nillable、Sort
説明
支払方法種別に関する省略可能な情報。この項目は、API バージョン 57.0 以降で使用できます。
PaymentMethodGeocodeAccuracy
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
支払方法の住所の地理コードの精度レベル。精度レベルには、位置の緯度と経度に関する詳細が含まれています。住所項目についての詳細は、「地理位置情報の複合項目」を参照してください。
可能な値は次のとおりです。
  • Address
  • Block
  • City
  • County
  • ExtendedZip
  • NearAddress
  • Neighborhood
  • State
  • Street
  • Unknown
  • Zip
PaymentMethodLatitude
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
支払方法の住所の緯度。PaymentMethodLongitude と一緒に使用して、住所の正確な地理位置情報を指定します。地理位置情報複合項目についての詳細は、「複合項目の考慮事項と制限」を参照してください。
PaymentMethodLongitude
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
支払方法の住所の緯度。PaymentMethodLatitude と一緒に使用して、住所の正確な地理位置情報を指定します。地理位置情報複合項目についての詳細は、「複合項目の考慮事項と制限」を参照してください。
PaymentMethodPostalCode
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払方法の住所の郵便番号。
PaymentMethodState
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払方法の住所の都道府県。
PaymentMethodStreet
textarea
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払方法の住所の町名・番地。
PaymentMethodSubType
string
プロパティ
Create、Filter、Group、Nillable、Sort
説明
支払方法種別のサブ種別として存在する支払方法。たとえば、Apple Pay や Google Pay などの支払方法種類のサブ種別として、Visa、Mastercard、American Express が存在します。この項目は、API バージョン 57.0 以降で使用できます。
PaymentMethodType
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
取引で使用される支払方法。この項目は、API バージョン 57.0 以降で使用できます。
可能な値は次のとおりです。
  • AfterpayClearpay
  • AmericanExpress
  • ApplePay
  • BanContact
  • DinersClub
  • Discover
  • EPS
  • GooglePay
  • Jcb
  • Klarna
  • Maestro
  • MasterCard
  • Other
  • PayPal
  • SepaDebit
  • UnionPay
  • Venmo
  • Visa
  • iDeal
Phone
phone
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
支払者の電話番号。
この項目は、API バージョン 49.0 以降で使用できます。バージョン 48.0 からアップグレードした Salesforce 組織では、デフォルトで UI に表示されません。ユーザーが自分で CardPaymentMethod ページレイアウトに追加する必要があります。
ProcessingMode
picklist
プロパティ
Create、Filter、Group、Restricted picklist、Sort
説明
カード支払方法が、Salesforce Payments と外部サードパーティ支払プロバイダーのどちらで行われた取引に使用されるのか定義します。
可能な値は次のとおりです。
  • External — トランザクションは、Salesforce 支払プラットフォームの外部で行われました。
  • Salesforce — Salesforce が支払プラットフォームに外部コールを実行して記録しました。
この項目は、API バージョン 49.0 以降で使用できます。バージョン 48.0 からアップグレードした Salesforce 組織では、デフォルトで UI に表示されません。ユーザーが自分で CardPaymentMethod ページレイアウトに追加する必要があります。
この項目の値を入力する必要があります。
SfResultCode
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
カード支払方法の支払ゲートウェイとのやりとりの結果を示します。
可能な値は次のとおりです。
  • Decline
  • Indeterminate
  • PermanentFail
  • RequiresReview
  • Success
  • SystemError
  • ValidationError
StartMonth
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カードが有効になる月。
StartYear
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
カードが有効になる年。
Status
picklist
プロパティ
Create、Filter、Group、Restricted picklist、Sort、Update
説明
支払方法の状況。
可能な値は次のとおりです。
  • Active
  • Canceled
  • InActive

使用方法

次の項目は、項目値の先頭にあるゼロを削除し、4 桁以上の値にはカンマを挿入します。
  • CardLastFour
  • CardBin
  • ExpiryYear
たとえば、CardLastFour0004112233445566 の値が入力されると、レコードには 4,112,233,445,566 と表示されます。
回避策として、置き換える項目と表示ラベルが同じ文字列型のカスタム数式項目を作成してから、元の項目を非表示にします。CardLastFourCardBin、および ExpiryYear を置き換える例を次に示します。
CardLastFour
IF(ISBLANK(CardLastFour), NULL,RIGHT("0000" & TEXT(CardLastFour) , 4))
CardBin
IF(ISBLANK(CardBin), NULL,RIGHT("000000" & TEXT(CardBin) , 6))
ExpiryYear
IF(ISBLANK(ExpiryYear), NULL,TEXT(ExpiryYear)))