{"title":"Payment Method Object Reference","slug":"payment-method-object-reference","url":"https://support.storeconnect.com/articles/payment-method-object-reference","url_markdown":"https://support.storeconnect.com/articles/payment-method-object-reference.md","subtitle":null,"summary":"Stores saved payment methods (cards) for contacts. Created during checkout when a customer saves their card or when a subscription is created. Tokens are managed by the payment provider (Stripe, Square, etc.).","type":"Developer_Documentation","video_url":"","keywords":"salesforce, object reference, Payment Method, s_c__Payment_Method__c, api","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Overview\n\nStores saved payment methods (cards) for contacts. Created during checkout when a customer saves their card or when a subscription is created. Tokens are managed by the payment provider (Stripe, Square, etc.).\n\n| Property | Value |\n|----------|-------|\n| **API Name** | `s_c__Payment_Method__c` |\n| **Label** | Payment Method |\n| **Plural Label** | Payment Methods |\n| **Type** | Custom Object |\n\n## Fields\n\n| Field Label | API Name | Type | Required | Description |\n|-------------|----------|------|----------|-------------|\n| Account Holder Type | `s_c__Account_Holder_Type__c` | Picklist | No | Whether the bank account belongs to an individual or a company. Only applicable when Type is bank_account. |\n| Account Type | `s_c__Account_Type__c` | Picklist | No | Type of bank account: checking or savings. Only applicable when Type is bank_account. |\n| Active | `s_c__Active__c` | Checkbox | No | Whether this payment method is active. Set to false to soft-delete. |\n| Bank Identifier Type | `s_c__Bank_Identifier_Type__c` | Picklist | No | The format of the bank identifier stored in Bank_Identifier__c (e.g. routing number, BSB, sort code, BIC/SWIFT, IBAN). |\n| Bank Identifier | `s_c__Bank_Identifier__c` | Text(34) | No | Bank routing identifier for the account: routing number, BSB, sort code, BIC/SWIFT, or IBAN depending on Bank_Identifier_Type__c. |\n| Bank Name | `s_c__Bank_Name__c` | Text(255) | No | Name of the financial institution for bank account payment methods. |\n| Billing Email | `s_c__Billing_Email__c` | Email | No | Email address associated with this payment method. |\n| Billing Name | `s_c__Billing_Name__c` | Text(255) | No | The name on the payment method as provided to the payment gateway. |\n| BIN | `s_c__Bin__c` | Text(8) | No | Bank Identification Number: the first 6–8 digits of the card number used to identify the issuing institution. |\n| Card Brand | `s_c__Card_Brand__c` | Text(50) | No | Card brand (e.g., Visa, Mastercard, American Express). |\n| Contact | `s_c__Contact_Id__c` | Lookup ([Contact](contact-object-reference)) | No | The contact who owns this payment method. |\n| Country | `s_c__Country__c` | Text(2) | No | Issuing country of the payment method as an ISO 3166-1 alpha-2 code (e.g. US, AU). |\n| Expiry Month | `s_c__Exp_Month__c` | Number(2,0) | No | Card expiry month (1–12). Only applicable when Type is card. |\n| Expiry Year | `s_c__Exp_Year__c` | Number(4,0) | No | Card expiry year as a 4-digit number (e.g. 2028). Only applicable when Type is card. |\n| Expires At | `s_c__Expires_At__c` | Date | No | Expiration date of the payment method. |\n| Fingerprint | `s_c__Fingerprint__c` | Text(255) | No | Gateway-provided fingerprint used to detect duplicate payment methods across customers. |\n| Funding Type | `s_c__Funding_Type__c` | Picklist | No | Funding type of the card: credit, debit, or prepaid. Only applicable when Type is card. |\n| Is Default | `s_c__Is_Default__c` | Checkbox | No | Whether this is the default payment method for the contact. |\n| Last Four | `s_c__Last_Four__c` | Text(4) | No | Last four digits of the card number. |\n| Last Used At | `s_c__Last_Used_At__c` | DateTime | No | Timestamp of the most recent successful transaction with this payment method. Used for recency sorting. |\n| Mandate Reference | `s_c__Mandate_Reference__c` | Text(255) | No | Direct debit mandate ID issued by the payment gateway. Only applicable when Type is bank_account. |\n| Nickname | `s_c__Nickname__c` | Text(100) | No | Customer-editable label for this payment method (e.g. \"My Visa\"). |\n| Payment Provider | `s_c__Payment_Provider_Id__c` | Lookup ([s_c__Payment_Provider__c](payment-provider-object-reference)) | No | The payment provider that manages this token (e.g., Stripe, Square). |\n| Status | `s_c__Status__c` | Picklist | No | Lifecycle status of this payment method: active, expired, revoked, or failed verification. |\n| Token | `s_c__Token__c` | Text(255) | No | Reusable payment token from the provider. For Stripe this is a customer_id\\|pm_id. For Square this is JSON with customer_id and card_id. DO NOT DISPLAY OR EDIT. |\n| Type | `s_c__Type__c` | Picklist | No | The type of payment method: card, bank account, or digital wallet. |\n| Verified At | `s_c__Verified_At__c` | DateTime | No | Timestamp of when this payment method was verified with the payment gateway. |\n| Wallet Type | `s_c__Wallet_Type__c` | Picklist | No | The specific digital wallet provider: Apple Pay, Google Pay, or PayPal. Only applicable when Type is digital_wallet. |\n| StoreConnect External ID | `s_c__sC_Id__c` | Text(36) | No | StoreConnect External ID, do not modify in Salesforce |\n\n## Relationships\n\n| Field | Type | Related Object | Relationship Name |\n|-------|------|----------------|-------------------|\n| `s_c__Contact_Id__c` | Lookup | [Contact](contact-object-reference) | Payment_Methods_Contact |\n| `s_c__Payment_Provider_Id__c` | Lookup | [s_c__Payment_Provider__c](payment-provider-object-reference) | Payment_Methods_Payment_Provider |\n\n## Referenced by\n\nThese objects hold a lookup or master-detail relationship to **Payment Method** (`s_c__Payment_Method__c`). Where the referring record exists to join things together, **Also links to** shows what it connects this object to.\n\n| Object | Field | Type | Relationship Name | Also links to |\n|--------|-------|------|-------------------|---------------|\n| [s_c__Payment__c](payment-object-reference) | `s_c__Payment_Method_Id__c` | Lookup | Payments | — |\n| [s_c__Subscription__c](subscription-object-reference) | `s_c__Payment_Method_Id__c` | Lookup | Subscriptions_Payment_Method | — |"}