j1.4.0
API Overview
Use the Shopper Payments API to:
- Retrieve payment configuration information for storefronts when Salesforce Payments is enabled.
The API returns the available payment methods, merchant account details, and payment gateway configurations for a specific payment zone site assignment.
The response includes:
- Zone ID: The unique identifier for the Payments zone.
- Payment Method Set Accounts: List of configured payment processor accounts with API keys, vendor information (Stripe, Adyen, PayPal, etc.), and live/test mode indicators.
- Payment Methods: List of available payment methods with their associated accounts, payment method types, and supported payment modes.
Authentication & Authorization
The client requesting payment configuration must have access to the /payment-configuration resource. The Shopper Payments API requires a shopper access token from the Shopper Login and API Access Service (SLAS).
For details on how to request a shopper access token from SLAS, see the guest user flows for public clients and private clients in the SLAS guides.
You must include sfcc.shopper-baskets-orders, sfcc.shopper-baskets-orders.rw, or sfcc.shopper-standard in the client ID used to generate the SLAS token. For a full list of permissions, see the Authorization Scopes Catalog.
Use Cases
Retrieve Payment Configuration
Retrieve payment configuration settings for Stripe, PayPal, and Adyen based on the payment methods enabled in the merchant's payment zone site. This includes API keys, vendor details, and live/test mode status. Specify a zone via zoneId or use currency and countryCode for automatic resolution.
Let us know so we can improve!