Configure the Endpoint for Mastercom®
Create external credentials and named credentials with details of how Salesforce is authenticated with Mastercom.
Required Editions
| Available in: Lightning Experience |
| Available in: Professional, Enterprise, and Unlimited Editions |
| User Permissions Needed | |
|---|---|
| To view named credentials and external credentials: | View Setup and Configuration |
| To create, edit, or delete named credentials and external credentials: | Manage Named Credentials OR Customize Applications |
Before you begin, make sure that you enabled user access to the User External Credentials object. See Enable User Access to User External Credentials Object.
-
To specify the URL of the Mastercom endpoint, create a custom authentication external
credential.
- From Setup, in the Quick Find box, enter Named Credentials, and then select Named Credentials.
- Go to External Credentials, and then click New.
- Enter a label and a name for the external credential.
- Select Custom as the authentication protocol.
- Save your changes.
- To create a named credential to reference the external credential that you created, go to Named Credentials, and then click New.
-
Enter a label and a name for the named credential.
Tip Copy the named credential name. Use it to update the integration definitions used for authenticating Salesforce with Mastercom for chargebacks and second presentment. -
Enter the base URL or hostname of the callout endpoint.
An example of the base URL of the Mastercard callout endpoint can be in a format https://sandbox.api.mastercard.com.
- Select the external credential that you created.
-
Save your changes.
The Named Credentials page opens.
-
Create a principal for the custom authentication external credential.
Important After you create an external credential that uses custom authentication, create a principal for it. Principals link an external credential to permission sets or user profiles so that users can make callouts using the named credential. At run time, Salesforce ensures that the user has the permission set before accessing the external system.- On the Named Credentials page, go to External Credentials.
- Select the external credential that you created.
- Scroll to Principals.
- To create a principal for the external credential, click New.
-
Enter a parameter name and a sequence number.
The parameter name is the name of the principal, such as Admin or Dispute Team. A sequence number specifies the order of principals to apply when a user participates in more than one principal. For example, a user could be part of multiple permission sets that are applicable for a credential provider. Priority is from lower to higher numbers.
- Select Named Principal as the identity type.
- Enter a username and a password.
- Save your changes.
-
Enable the external credential principal for users.
Note To make callouts to Mastercom®, give profiles access to the principal of the external credential that you created. See Enable External Credential Principals.
Did this article solve your issue?
Let us know so we can improve!

