# Payment Method Object Reference

Source: https://support.storeconnect.com/articles/payment-method-object-reference · Last modified 21 August 2026

## Overview

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.).

| Property | Value |
|----------|-------|
| **API Name** | `s_c__Payment_Method__c` |
| **Label** | Payment Method |
| **Plural Label** | Payment Methods |
| **Type** | Custom Object |

## Fields

| Field Label | API Name | Type | Required | Description |
|-------------|----------|------|----------|-------------|
| 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. |
| Account Type | `s_c__Account_Type__c` | Picklist | No | Type of bank account: checking or savings. Only applicable when Type is bank_account. |
| Active | `s_c__Active__c` | Checkbox | No | Whether this payment method is active. Set to false to soft-delete. |
| 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). |
| 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. |
| Bank Name | `s_c__Bank_Name__c` | Text(255) | No | Name of the financial institution for bank account payment methods. |
| Billing Email | `s_c__Billing_Email__c` | Email | No | Email address associated with this payment method. |
| Billing Name | `s_c__Billing_Name__c` | Text(255) | No | The name on the payment method as provided to the payment gateway. |
| 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. |
| Card Brand | `s_c__Card_Brand__c` | Text(50) | No | Card brand (e.g., Visa, Mastercard, American Express). |
| Contact | `s_c__Contact_Id__c` | Lookup ([Contact](contact-object-reference)) | No | The contact who owns this payment method. |
| 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). |
| Expiry Month | `s_c__Exp_Month__c` | Number(2,0) | No | Card expiry month (1–12). Only applicable when Type is card. |
| 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. |
| Expires At | `s_c__Expires_At__c` | Date | No | Expiration date of the payment method. |
| Fingerprint | `s_c__Fingerprint__c` | Text(255) | No | Gateway-provided fingerprint used to detect duplicate payment methods across customers. |
| Funding Type | `s_c__Funding_Type__c` | Picklist | No | Funding type of the card: credit, debit, or prepaid. Only applicable when Type is card. |
| Is Default | `s_c__Is_Default__c` | Checkbox | No | Whether this is the default payment method for the contact. |
| Last Four | `s_c__Last_Four__c` | Text(4) | No | Last four digits of the card number. |
| 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. |
| 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. |
| Nickname | `s_c__Nickname__c` | Text(100) | No | Customer-editable label for this payment method (e.g. "My Visa"). |
| 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). |
| Status | `s_c__Status__c` | Picklist | No | Lifecycle status of this payment method: active, expired, revoked, or failed verification. |
| 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. |
| Type | `s_c__Type__c` | Picklist | No | The type of payment method: card, bank account, or digital wallet. |
| Verified At | `s_c__Verified_At__c` | DateTime | No | Timestamp of when this payment method was verified with the payment gateway. |
| 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. |
| StoreConnect External ID | `s_c__sC_Id__c` | Text(36) | No | StoreConnect External ID, do not modify in Salesforce |

## Relationships

| Field | Type | Related Object | Relationship Name |
|-------|------|----------------|-------------------|
| `s_c__Contact_Id__c` | Lookup | [Contact](contact-object-reference) | Payment_Methods_Contact |
| `s_c__Payment_Provider_Id__c` | Lookup | [s_c__Payment_Provider__c](payment-provider-object-reference) | Payment_Methods_Payment_Provider |

## Referenced by

These 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.

| Object | Field | Type | Relationship Name | Also links to |
|--------|-------|------|-------------------|---------------|
| [s_c__Payment__c](payment-object-reference) | `s_c__Payment_Method_Id__c` | Lookup | Payments | — |
| [s_c__Subscription__c](subscription-object-reference) | `s_c__Payment_Method_Id__c` | Lookup | Subscriptions_Payment_Method | — |

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/payment-method-object-reference