Logo

mastercard auth

Version 1.1.5
Install in Core

Overview

Table of Contents

Overview

A plugin for handling Mastercard API authentication. This plugin computes and adds an Authorization header to requests sent from Insomnia REST Client.

Compatibility

Insomnia v5.15.0+

References

Usage

Prerequisites

Before using this library, you will need to set up a project in the Mastercard Developers Portal.

As part of this set up, you'll receive credentials for your app:

  • A consumer key (displayed on the Mastercard Developer Portal)
  • A private request signing key (matching the public certificate displayed on the Mastercard Developer Portal)

Installation

From the Plugins Tab

  1. Open Insomnia
  2. Go to Application > Preferences > Plugins
  3. Type "insomnia-plugin-mastercard-auth"
  4. Click "Install Plugin"

Manual Installation

  1. Download "insomnia-plugin-mastercard-auth.zip" from Releases > Assets
  2. Go to Application > Preferences > Plugins
  3. Click "Show Plugins Folder"
  4. Extract the zip from step 1 to the "plugins" folder
  5. Click "Reload Plugin List"

Configuration

One-Click Import

To import two ready to be used "sandbox" and "production" environments:

  1. Click
  2. Click "Run Import Mastercard Workspace"

Alternatively, you can:

  1. Go to Application > Preferences > Data
  2. Click "Import Data"
  3. Click "From URL"
  4. Type "https://github.com/Mastercard/insomnia-plugin-mastercard-auth/releases/latest/download/mastercard-apis-insomnia-workspace.json"
  5. Click "Fetch and Import"

Manual Configuration

Update your environment:

  1. Click "Manage Environments"
  2. Create a "mastercard" environment variable with your credentials:
{
  "mastercard": {
    "consumerKey": "000000000000000000000000000000000000000000000000!000000000000000000000000000000000000000000000000",
    "keyAlias": "keyalias",
    "keystoreP12Path": "/path/to/sandbox-signing-key.p12",
    "keystorePassword": "keystorepassword"
  }
}

Authenticated Requests

From now on, an Authorization header will be automatically added to every request sent to Mastercard:

Further Reading