---
sourceDocument: Zurich Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/integrate-applications

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up Mastercard spoke

# Set up Mastercard spoke {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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.
{#set-up-mastercard-spoke__ul_agy_qxd_rlb}

## Attach a Mastercard certificate {#ariaid-title2}

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

### Before you begin

* Valid Mastercard certificate
* Role required: admin
{#attach-a-mastercard-certificate__ul_k2k_mph_gfaff}

### Procedure

1. Navigate to AllSystem DefinitionCertificates.
2. Select New.
3. On the form, fill in the fields:  
   {#attach-a-mastercard-certificate__table_wdd_xjx_zyb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Enter a name to identify the certificate. |
   | Type | Type of the certificate. Select <kbd class="ph userinput">PKCS12 Key Store</kbd>. |
   | 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. |
   [Table 1. X.509 Certificate form fields]

   {#attach-a-mastercard-certificate__table_wdd_xjx_zyb}
4. Select the manage attachments icon (![Manage attachments icon.]()) and attach a Mastercard certificate.
5. Select Validate Stores/Certificates to validate the certificate.
6. Select Submit.
{#attach-a-mastercard-certificate__steps_y3t_4vf_yyb}

## Create a credential record for Mastercard spoke {#ariaid-title3}

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

1. Navigate to AllConnections \& CredentialsCredentials.
2. Select New.  
   The system displays this message: What type of Credentials would you like to create?
3. Select Mastercard Credential.  
   A Mastercard Credential form displays.
4. Enter these values.  
   {#create-a-credential-record-for-mastercard-spoke__table_fvk_jds_xyb__entry__2}

   | Field | Value required |
   |-|-|
   | Name | Enter any name to uniquely identify the record. For example, <kbd class="ph userinput">Mastercard Credentials</kbd>. |
   | 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 algorithm. Note: You are cautioned against directly modifying the default authentication algorithm. |
   [ ]

   {#create-a-credential-record-for-mastercard-spoke__table_fvk_jds_xyb}
5. Select Submit.
{#create-a-credential-record-for-mastercard-spoke__steps_n1q_ylc_wyb}

## Create a connection record for Mastercard spoke {#ariaid-title4}

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

1. Navigate to AllConnections \& CredentialsConnections \& Credentials Aliases.
2. Open the record for Mastercard Connection.
3. On the Connections tab, select New.
4. On the form, fill these values.  
   {#create-a-connection-record-for-mastercard-spoke__table_f1b_mkr_ylb__entry__2}

   | Field | Value required |
   |-|-|
   | Connection URL | Base URL to connect to your Mastercard instance. For example, <kbd class="ph userinput">https://sandbox.api.mastercard.com</kbd>. |
   | Credential | Credential record you that created for Mastercard. |
   [ ]

   {#create-a-connection-record-for-mastercard-spoke__table_f1b_mkr_ylb}
5. Right-click the form header and select Save.
6. Ensure that api_version is set <kbd class="ph userinput">V6</kbd> in the Attributes related list.
{#create-a-connection-record-for-mastercard-spoke__steps_nbc_jvf_yyb}

*[\>]: and then