Payment Provider Object Reference
On this page
Overview
Configures a payment provider to be offered as part of the checkout process. Mainly contains the necessary credentials for the provider’s API.
| Property | Value |
|---|---|
| API Name | s_c__Payment_Provider__c |
| Label | Payment Provider |
| Plural Label | Payment Providers |
| Type | Custom Object |
Fields
| Field Label | API Name | Type | Required | Description |
|---|---|---|---|---|
| Active | s_c__Active__c |
Checkbox | No | If enabled this Payment Provider will appear as an option in the Store checkout. If disabled it will not appear in the checkout. |
| API Key | s_c__Api_Key__c |
Text(255) | No | The API key for the payment provider’s API that you will have received from the payment provider. This is the public part of your credentials, akin to a username. It may also be referred to as a “Client ID” (such as with PayPal), or simply a “key”. This should not be confused with the “secret” or “private” key. |
| API Mode | s_c__Api_Mode__c |
Text(255) | Yes | The mode of the payment provider’s API to use. This is determined by the terminology of the API is question, and will likely be a word similar to the following: “test”, “sandbox”, “live”, etc. |
| API Options | s_c__Api_Options__c |
LongTextArea(25000) | No | This allows you to provide other options that are required for this API connection to work. The required format of this field depends on the payment provider being used. Please reference the relevant StoreConnect Payment Gateway provider documentation for details on what is supported for your gateway. |
| API Secret | s_c__Api_Secret__c |
Text(255) | Yes | The API secret key for the payment provider’s API that you will have received from the payment provider. This is the private/secret part of your credentials, and could also be referred to as a “Password” or “Private Key”. |
| [DEPRECATED] Channel | s_c__Channel__c |
MultiselectPicklist | No | The channel supported by this payment provider provider. |
| Channels | s_c__Channels__c |
MultiselectPicklist | No | The channels this payment provider applies to (e.g. web, pos). |
| Description | s_c__Description__c |
LongTextArea(500) | No | Description to show on the checkout payment selection page when this payment provider is selected. |
| Display Name | s_c__Display_Name__c |
Text(255) | No | The name of the payment provider that you want to show up on the available payment providers list on the website. |
| Payment Instructions Markdown | s_c__Payment_Instructions_Markdown__c |
LongTextArea(1000) | No | Payment Instruction to show on the order summary page when this payment provider is used. Use Markdown or HTML to format your text. Find out more at https://help.getstoreconnect.com/documentation/how-to-use-markdown. |
| Position | s_c__Position__c |
Number(18,0) | No | The position of this payment provider on the store checkout page. Lower numbers are shown first, payment providers without a position are then ordered by name |
| Provider | s_c__Provider__c |
Picklist | Yes | The payment provider, e.g. Stripe, PayPal, etc. |
| Store | s_c__Store_Id__c |
Lookup (s_c__Store__c) | Yes | The store that this payment provider belongs to. |
| Surcharge Product | s_c__Surcharge_Product_Id__c |
Lookup (Product2) | No | This product contains the price to surcharge on the order total when using this payment method |
| 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__Store_Id__c |
Lookup | s_c__Store__c | Store_Payment_Providers |
s_c__Surcharge_Product_Id__c |
Lookup | Product2 | Payment_Provider_Surcharge_Products |
Referenced by
These objects hold a lookup or master-detail relationship to Payment Provider (s_c__Payment_Provider__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 | s_c__Payment_Provider_Id__c |
Lookup | Payment_Payment_Providers | — |
| s_c__Payment_Method__c | s_c__Payment_Provider_Id__c |
Lookup | Payment_Methods_Payment_Provider | Contact |
| s_c__Subscription__c | s_c__Payment_Provider_Id__c |
Lookup | Payment_Provider | — |
On the storefront
Storefront templates read this object through the PaymentProvider Liquid object, written as payment_provider in a theme.
| Salesforce field | Liquid attribute |
|---|---|
s_c__Display_Name__c |
payment_provider.name |
s_c__Position__c |
payment_provider.position |
Fields you add yourself are not listed above. Expose one with a Custom Data Mapping record, then read it from payment_provider.data. See custom data fields in Liquid.
Was this article helpful?
Thanks for your feedback! It helps us improve our docs.