Set up Mastercard spoke

Release version: Yokohama

Updated January 30, 2025

2 minutes to read

Integrate the ServiceNow instance with the Mastercard account using the OAuth protocol (version 1.0a) for secure authorization to authenticate ServiceNow requests.

Before you begin

Request an Integration Hub subscription.
Activate the Mastercard spoke.
Role required: admin.

Attach a Mastercard certificate

Use the certificate generated during the Mastercard account configuration to sign the request and payloads.

Before you begin

Valid Mastercard certificate
Role required: admin

Procedure

Navigate to All > System Definition > Certificates.
Select New.

On the form, fill in the fields:

Table 1. X.509 Certificate form fields
Field	Description
Name	Enter a name to identify the certificate.
Type	Type of the certificate. Select `PKCS12 Key Store`.
Notify on expiration	Select the list of users to be notified when the certificate expires.
Warn in days to expire	Enter the number of days when a notification is sent to users before a certificate expires.
Key store password	Password to access the certificate. Use the destination keystore password specified when creating the certificate.
Active	Option to make the client certificate active.
Short description	Short description of the user client certificate.

Select the manage attachments icon () and attach a Mastercard certificate.
Select Validate Stores/Certificates to validate the certificate.
Select Submit.

Create a connection record for Mastercard spoke

Create a connection record for your Mastercard account configuration. The Mastercard spoke connection and credential aliases use these connections to perform actions in Mastercard.

Before you begin

Role required: admin

Procedure

Navigate to All > Connections & Credentials > Connections & Credentials Aliases.
Open for the record for Mastercard.
On the Connections tab, select New.

On the form, fill these values.


Field	Value required
Connection URL	Base URL to connect to your Mastercard instance. For example: `https://sandbox.api.mastercard.com` for Mastercom `https://sandbox.dispute.mastercard.com` for Mastercom Extended
Credential	Credential record you that created for Mastercard.

Right-click the form header and select Save.
For Mastercom, ensure that api_version is set V6 in the Attributes related list.

Create a credential record for Mastercard spoke

Create a credential record for your Mastercard account configuration. The Mastercard spoke connection and the credential alias uses these credentials to authorize actions.

Before you begin

Role required: admin

Procedure

Navigate to All > Connections & Credentials > Credentials.
Select New.

The system displays this message: What type of Credentials would you like to create?
Select Mastercard Credential.
A Mastercard Credential form displays.

Enter these values.


Field	Value required
Name	Enter any name to uniquely identify the record. For example, `Mastercard Credentials`.
Active	Enable
Key alias	Key alias associated with the Mastercard account.
Keystore password	The password associated with the certificate.
Consumer key	Consumer key that you generated during the Mastercard configuration.
Certificate	Select the newly created Mastercard certificate.
Authentication Algorithm	Custom authentication algorithm for outbound signing requests. Select Mastercard. Note: You are cautioned against directly modifying the default authentication algorithm.

Select Submit.