### Get Started Locally with BIN Lookup Sample Code

Source: https://developer.mastercard.com/product/bin-lookup

Clone the repository, install dependencies, and run the Python example to get started locally. Ensure you configure the BASE_URL, CONSUMER_KEY, and .p12 certificate.

```bash
git clone https://github.com/Mastercard-Samples/bin-lookup-sample-code.git
cd bin-lookup-sample-code
pip install -r requirements.txt
cd Examples
# Configure BASE_URL, CONSUMER_KEY, and .p12 Cert
python single-lookup-example.py
```

--------------------------------

### GET Declined Installment Plan Response

Source: https://developer.mastercard.com/unified-installments/documentation/testing/mastercard-installments-payment-services/installments-plan-api

Example response for a GET request to the /plans/{planId} endpoint when a plan is declined. Includes reason codes and plan details.

```json
{
	"rejectReasonCode": "OTHER_REASON",
	"rejectReasonDetail": "Credit score is too low",
	"planId": "9eb01b62-e832-43bd-8ea8-7eca0e82bd49",
	"offerId": "21345723",
	"providerId": "29694e7a-b4a8-11ec-b909-0242ac120002",
	"status": "DECLINED",
	"merchant": {
		"name": "Decor shop",
		"acceptor": "409749",
		"mcc": "1711",
		"country": "USA"
	},
	"transaction": {
		"amount": 200,
		"currency": "USD"
	},
	"planInstallmentInformation": {
		"apr": 9.01,
		"totalAmount": 100,
		"currency": "USD",
		"installmentAmount": 17.49,
		"installmentFee": 0,
		"tenure": 12,
		"frequency": "MONTHLY"
	},
	"scheduledRepayments": [
		{
			"installmentNumber": 1,
			"amount": 17.49,
			"dueDate": "2022-10-20"
		},
		{
			"installmentNumber": 2,
			"amount": 17.49,
			"dueDate": "2022-11-20"
		},
		{
			"installmentNumber": 3,
			"amount": 17.49,
			"dueDate": "2022-12-20"
		},
		{
			"installmentNumber": 4,
			"amount": 17.49,
			"dueDate": "2023-01-20"
		},
		{
			"installmentNumber": 5,
			"amount": 17.49,
			"dueDate": "2023-02-20"
		},
		{
			"installmentNumber": 6,
			"amount": 17.49,
			"dueDate": "2023-03-20"
		},
		{
			"installmentNumber": 7,
			"amount": 17.49,
			"dueDate": "2023-04-20"
		},
		{
			"installmentNumber": 8,
			"amount": 17.49,
			"dueDate": "2023-05-20"
		},
		{
			"installmentNumber": 9,
			"amount": 17.49,
			"dueDate": "2023-06-20"
		},
		{
			"installmentNumber": 10,
			"amount": 17.49,
			"dueDate": "2023-07-20"
		},
		{
			"installmentNumber": 11,
			"amount": 17.49,
			"dueDate": "2023-08-20"
		},
		{
			"installmentNumber": 12,
			"amount": 17.49,
			"dueDate": "2023-09-20"
		}
	],
	"consumer": {
		"email": "john.doe@test.com",
		"mobile": "6360101010",
		"isdCode": "1"
	}
}
```

--------------------------------

### Initialize Connect Instance

Source: https://developer.mastercard.com/open-finance-au/documentation/connect/integrating-with-connect/web-sdk/sdk

Example of how to launch a Connect instance after installing the SDK. Ensure you provide the correct connectURL.

```javascript
import Connect from 'connect-web-sdk';

const connectURL = 'YOUR_CONNECT_URL';

const connectEventHandlers = {
  onSuccess: (data) => {
    console.log('Connect Success:', data);
  },
  onError: (error) => {
    console.error('Connect Error:', error);
  },
  onExit: () => {
    console.log('Connect Exited');
  }
};

const connectOptions = {
  // Optional: overlay color, selector, node, popup, popupOptions
};

new Connect(connectURL, connectEventHandlers, connectOptions);
```

--------------------------------

### Retrieve Recurring Donation Setups (Deprecated)

Source: https://developer.mastercard.com/donations/tutorial/donation-api-details/monthlyapi

This is a deprecated GET request example for retrieving recurring monthly donation setup details. It shows how to specify the donor ID and optional query parameters for pagination.

```http
GET https://sandbox.api.mastercard.com/donations/donors/{donor_id}/setups?offset=0&limit=5
```

--------------------------------

### Install Node Modules from Starter Code

Source: https://developer.mastercard.com/open-finance-us/documentation/connect/integrating/sdk/web-sdk/sdk

After downloading the starter code, navigate to the project directory and run this command to install all necessary node modules, including the SDK.

```bash
npm i
```

--------------------------------

### Get Retrieval Documentation - C#

Source: https://developer.mastercard.com/mastercom/documentation/llms-full.txt

Placeholder for C# implementation of retrieving documentation. This snippet indicates the start of the setup for authentication and API client initialization.

```csharp
using Com.Mastercard.Api.Mastercom.Api;
using Com.Mastercard.Api.Mastercom.Client;
using Mastercard.Developer.OAuth1Signer.Core.Utils;
using System;
namespace Example
{
    public class Example
    {
        public static void Main()
        {
            var signingKey = AuthenticationUtils.LoadSigningKey(

```

--------------------------------

### Initialize SDK Example

Source: https://developer.mastercard.com/unified-checkout-solutions/documentation/ref-app/ref-app-ctp

Example of initializing the SDK. Modify the values as needed. This is often prepopulated in the reference application's forms.

```java
init();
```

--------------------------------

### Install Open Banking Reference Application

Source: https://developer.mastercard.com/open-finance-au/documentation/llms-full.txt

Clone the repository and install dependencies to set up the reference application locally.

```shell
git clone https://github.com/Mastercard/open-banking-reference-application-australia.git
cd open-banking-reference-application-australia
npm i
```

--------------------------------

### Get Retrieval Documentation - C#

Source: https://developer.mastercard.com/mastercom/documentation/test-cases/test-cases

This C# example demonstrates how to retrieve retrieval documentation. It shows the setup for the API client with OAuth signing and the subsequent API call.

```csharp
using Com.Mastercard.Api.Mastercom.Api;
using Com.Mastercard.Api.Mastercom.Client;
using Mastercard.Developer.OAuth1Signer.Core.Utils;
using System;
namespace Example
{
    public class Example
    {
        public static void Main()
        {
            var signingKey = AuthenticationUtils.LoadSigningKey(
                        @"#PATH TO YOUR P12 FILE HERE#", 
                        "#YOUR KEY ALIAS HERE#", 
                        "#YOUR KEY PASSWORD HERE#");
            var consumerKey = "#YOUR 97 CHARACTER CONSUMER KEY HERE#";
            var basePath = "https://sandbox.api.mastercard.com/mastercom";
            var client = new ApiClient(signingKey, basePath, consumerKey);
            var apiInstance = new RetrievalsApi
            {
                Client = client
            };
            var claimId = "200002020654";  // string | The Claim Id.   Length: 1-19   Valid Values/Format: Numeric
            var requestId = "300002296235";  // string | The Request Id.   Length: 1-19   Valid Values/Format: Numeric
            var format = "ORIGINAL";  // string | File Format.   Length: 8-11   Valid Values/Format: ORIGINAL, MERGED_TIFF, MERGED_PDF
            try
            {
                // This resource retrievals all documentation for a retrieval request
```

--------------------------------

### GET MP Response Example

Source: https://developer.mastercard.com/unified-installments/documentation/testing/merchant-participation-api/merchant-participation-api-positivesc

This is an example response from the GET Merchant Participation endpoint, showing the status of merchant participations.

```json
[
  {
    "merchantLegalName": "Example Mart",
    "countryCode": "USA",
    "acquirerICA": "019246",
    "submitterICA": "019246",
    "dbaNames": [
      "ACME2"
    ],
    "optIn": "N",
    "status": "COMPLETED",
    "duns": "879847426",
    "websiteUrl": "https://www.test123.com",
    "address": {
      "addressLine1": "600 WEST",
      "addressLine2": "SECTOR 5",
      "addressLine3": "SUITE 775",
      "city": "St Peters",
      "state": "QLD",
      "postalCode": "85001"
    }
  },
  {
    "merchantLegalName": "USA Merchant A",
    "countryCode": "USA",
    "acquirerICA": "019246",
    "submitterICA": "019246",
    "dbaNames": [
      "ACME1"
    ],
    "maids": [
      "123470"
    ],
    "maidType": "EXT",
    "optIn": "N",
    "status": "PENDING",
    "duns": "879847426",
    "websiteUrl": "https://www.test.com",
    "address": {
      "addressLine1": "Main Street",
      "addressLine2": "near Costco",
      "addressLine3": "near mastercard",
      "city": "O Fallon",
      "state": "MO",
      "postalCode": "63368"
    }
  }
]
```

--------------------------------

### Setup Virtual Environment and Install Dependencies

Source: https://developer.mastercard.com/consent-management/documentation/tutorials/project-setup/python-tutorial-setup

Create a virtual environment, activate it, upgrade pip, and install project dependencies. This ensures a clean and isolated environment for the project.

```bash
python3 -m venv venv
source venv/bin/activate
venv/bin/python3 -m ensurepip --upgrade
venv/bin/python3 -m pip install --upgrade pip
venv/bin/python3 -m pip install -r requirements.txt

```

--------------------------------

### GET MP Response Example

Source: https://developer.mastercard.com/unified-installments/documentation/testing/merchant-participation-api/merchant-participation-api-positivesc

This is an example of a successful GET request for merchant participation data, showing merchant details and status.

```json
[
  {
    "merchantLegalName": "USA Merchant C",
    "countryCode": "USA",
    "acquirerICA": "019246",
    "submitterICA": "019246",
    "dbaNames": [
      "ACME"
    ],
    "maids": [
      "123480"
    ],
    "maidType": "EXT",
    "optIn": "N",
    "status": "PENDING",
    "duns": "879847426",
    "websiteUrl": "https://www.example.com",
    "address": {
      "addressLine1": "Main Street",
      "addressLine2": "near Costco",
      "addressLine3": "near mastercard",
      "city": "O Fallon",
      "state": "MO",
      "postalCode": "63368"
    }
  },
  {
    "merchantLegalName": "USA Merchant C",
    "countryCode": "USA",
    "acquirerICA": "019246",
    "submitterICA": "019246",
    "dbaNames": [
      "ACME"
    ],
    "optIn": "N",
    "status": "PENDING",
    "duns": "879847426",
    "websiteUrl": "https://www.example.com",
    "address": {
      "addressLine1": "600 WEST",
      "addressLine2": "SECTOR 5",
      "addressLine3": "SUITE 775",
      "city": "St Peters",
      "state": "QLD",
      "postalCode": "85001"
    }
  }
]
```

--------------------------------

### Initialize SDK Example

Source: https://developer.mastercard.com/mastercard-checkout-solutions/documentation/ref-app/ref-app-ctp

Example of how to initialize the SDK. Modify the values as needed. Once initialized, the Call Logs display below the form to show the SDK request and associated response.

```java
sdk.init();
```

--------------------------------

### Main Java Application Setup

Source: https://developer.mastercard.com/mastercard-processing-core/tutorial/build-end-to-end-app/step5

This is the main entry point for the application. It configures API client credentials, sets up authentication and encryption interceptors, and demonstrates calling API endpoints for retrieving card contract details and activating a card.

```java
package org.example; // change accordingly

import com.mastercard.developer.encryption.JweConfig;
import com.mastercard.developer.encryption.JweConfigBuilder;
import com.mastercard.developer.interceptors.OkHttpEncryptionInterceptor;
import com.mastercard.developer.interceptors.OkHttpOAuth1Interceptor;
import com.mastercard.developer.utils.AuthenticationUtils;
import com.mastercard.developer.utils.EncryptionUtils;
import java.security.*;
import java.security.cert.Certificate;
import org.openapitools.client.ApiClient;
import org.openapitools.client.api.CardContractApi;
import org.openapitools.client.api.CardPlasticApi;
import org.openapitools.client.model.CardContractActivation;
import org.openapitools.client.model.CardContractWithEncryptedCardContractNumber;

public class Main {

  public static void main(String[] args) throws Exception {
    // change these values accordingly
    String consumerKey =
        "J8nQPn_Ovh1BQQTR_zKSKev2HmEHGCwdJmzDaRTOdb00fa6c!8f2d9d40a22b4869bc57161daaeed7e00000000000000000";
    String signingKeyFilePath =
        "src/main/resources/core-prod-sandbox-oauth-signing-certificate.p12";
    String signingKeyAlias = "keyalias";
    String signingKeyPass = "keystorepassword";
    String clientEncryptionCertPath =
        "src/main/resources/core-prod-sandbox-request-encryption-public-key.pem";
    String mastercardEncryptionKeyFilePath =
        "src/main/resources/core-prod-sandbox-response-decryption-private-key.p12";
    String mastercardEncryptionAlias = "sandbox-key";
    String mastercardEncryptionPass = "Sandbox@123";

    // Create generic apiClient with required configurations
    ApiClient apiClient =
        getApiClient(
            consumerKey,
            signingKeyFilePath,
            signingKeyAlias,
            signingKeyPass,
            clientEncryptionCertPath,
            mastercardEncryptionKeyFilePath,
            mastercardEncryptionAlias,
            mastercardEncryptionPass);

    // Example 1 - Get Card Contract details
    CardContractWithEncryptedCardContractNumber response = getCardContract(apiClient);

    if (response != null) {
      System.out.println(response.toJson().toString());
    }
    // Example 2 - Activate Card
    activateCard(apiClient);

    System.exit(0);
  }

  public static ApiClient getApiClient(
      String consumerKey,
      String signingKeyFilePath,
      String signingKeyAlias,
      String signingKeyPass,
      String clientEncryptionCertPath,
      String mastercardEncryptionKeyFilePath,
      String mastercardEncryptionAlias,
      String mastercardEncryptionPass)
      throws Exception {

    // Step 1.1 - Load the signing key - Provided by the OAuth1 Signer lib
    PrivateKey signingKey =
        AuthenticationUtils.loadSigningKey(signingKeyFilePath, signingKeyAlias, signingKeyPass);

    // Step 1.2 – Inject OAuth signing key and consumer key to interceptor
    OkHttpOAuth1Interceptor authInterceptor = new OkHttpOAuth1Interceptor(consumerKey, signingKey);

    // Step 2.1 - This will be the certificate used to encrypt the payload before sending
    Certificate encryptionCertificate =
        EncryptionUtils.loadEncryptionCertificate(clientEncryptionCertPath);

    // Step 2.2 - The response received from the call will need to be decrypted using this key
    PrivateKey decryptionKey =
        EncryptionUtils.loadDecryptionKey(
            mastercardEncryptionKeyFilePath, mastercardEncryptionAlias, mastercardEncryptionPass);

    // Step 2.3 – Prepare JweConfig
    JweConfig config =
        JweConfigBuilder.aJweEncryptionConfig()
            .withEncryptionCertificate(encryptionCertificate)
            .withDecryptionKey(decryptionKey)
            .withEncryptionPath("$", "$")
            .withDecryptionPath("$.encryptedValue", "$")
            .withEncryptedValueFieldName("encryptedValue")
            .build();

    // Step 2.4 – Inject JweConfig to interceptor
    OkHttpEncryptionInterceptor encryptionInterceptor = OkHttpEncryptionInterceptor.from(config);

    // Step 3 – Create ApiClient
    ApiClient client = new ApiClient();

    // Step 3.1 – Configure the Mastercard service URL
    client.setBasePath("https://sandbox.api.mastercard.com/global-processing/core");

    // Step 3.2 – Add the interceptors responsible for signing, encrypting, and decrypting HTTP
    // requests/responses
    client.setHttpClient(
        client
            .getHttpClient()
            .newBuilder()
            .addInterceptor(encryptionInterceptor)
            .addInterceptor(authInterceptor)
            .build());

    // Step 3.3 - Enable or disable OK Http debugging - disable on UAT/PROD env.
    client.setDebugging(true);

    return client;
  }

  private static CardContractWithEncryptedCardContractNumber getCardContract(ApiClient apiClient) {
    // Example 1: get Card Contract information

```

--------------------------------

### Get Transaction Status Request Example

Source: https://developer.mastercard.com/india-online-dispute-resolution/documentation/llms-full.txt

Example of a request body for the Get Transaction Status API, including the tracking number.

```json
{
    "trackingNumber": "P4AXV1XZPJH4"
}
```

--------------------------------

### Setup Virtualenv and Install Dependencies

Source: https://developer.mastercard.com/consent-management/documentation/llms-full.txt

Set up a Python virtual environment, upgrade pip, and install project dependencies.

```bash
python3 -m venv venv
source venv/bin/activate
virtualenv/bin/python3 -m ensurepip --upgrade
virtualenv/bin/python3 -m pip install --upgrade pip
virtualenv/bin/python3 -m pip install -r requirements.txt
```

--------------------------------

### Get Retrieval Documentation (Node.js)

Source: https://developer.mastercard.com/mastercom/documentation/test-cases/test-cases

This Node.js example shows how to fetch retrieval documentation using the MasterCom API. It requires the `master_com`, `node-forge`, and `mastercard-oauth1-signer` libraries. The code snippet is incomplete, showing only the setup for authentication and client instantiation.

```javascript
const MasterCom = require('master_com');
const forge = require("node-forge");
const fs = require("fs");
const oauth = require("mastercard-oauth1-signer");
const p12Content = fs.readFileSync("#PATH TO YOUR P12 FILE HERE#", 'binary');
const p12Asn1 = forge.asn1.fromDer(p12Content, false);
const p12 = forge.pkcs12.pkcs12FromAsn1(p12Asn1, false, "#YOUR KEY PASSWORD HERE#");
const keyObj = p12.getBags({
    friendlyName: "#YOUR KEY ALIAS HERE#",
    bagType: forge.pki.oids.pkcs8ShroudedKeyBag
}).friendlyName[0];
const signingKey = forge.pki.privateKeyToPem(keyObj.key);
const client = MasterCom.ApiClient.instance;
client.basePath = "https://sandbox.api.mastercard.com/mastercom";
const consumerKey = "#YOUR 97 CHARACTER CONSUMER KEY HERE#";
client.applyAuthToRequest = function(request) {
    const _end = request._end;
    request._end = function() {

```

--------------------------------

### Get Possible Values for Fee Collection Event (PHP)

Source: https://developer.mastercard.com/mastercom/documentation/test-cases/test-cases

This PHP example demonstrates how to retrieve possible values for creating a fee using the Mastercom API. It utilizes Guzzle for HTTP requests and requires proper authentication setup.

```php
<?php
require_once(__DIR__ . '/vendor/autoload.php');
use Mastercard\Developer\OAuth\Utils\AuthenticationUtils;
use Mastercard\Developer\OAuth\Signers\PsrHttpMessageSigner;
$signingKey = AuthenticationUtils::loadSigningKey(
                '#PATH TO YOUR P12 FILE HERE#',
                '#YOUR KEY ALIAS HERE#', 
                '#YOUR KEY PASSWORD HERE#');
$consumerKey = '#YOUR 97 CHARACTER CONSUMER KEY HERE#';
$stack = new GuzzleHttp\HandlerStack();
$stack->setHandler(new GuzzleHttp\Handler\CurlHandler());
$stack->push(GuzzleHttp\Middleware::mapRequest([new PsrHttpMessageSigner($consumerKey, $signingKey), 'sign']));
$options = ['handler' => $stack];
$client = new GuzzleHttp\Client($options);
$config = new OpenAPI\Client\Configuration();
$config->setHost('https://sandbox.api.mastercard.com/mastercom');
$apiInstance = new OpenAPI\Client\Api\FeesApi($client, $config);
$claim_id = '200002020654'; // string | Claim Id for the Fee.   Length: 1-19   Valid Values/Format: Numeric
$body = new \OpenAPI\Client\Model\LoadDataForFeesRequest(); // \OpenAPI\Client\Model\LoadDataForFeesRequest | Load Data For Fee Request
try {
    $result = $apiInstance->getDataForCreateFee($claim_id, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling Get Data for Fee API: ', $e->getMessage(), PHP_EOL;
}
?>
```

--------------------------------

### Build and Run Reference Application

Source: https://developer.mastercard.com/account-validation/documentation/reference-app

Use this command to build and run the reference application with Maven. Ensure Maven is installed.

```bash
mvn spring-boot:run

```

--------------------------------

### init() Code Sample

Source: https://developer.mastercard.com/mastercard-checkout-solutions/documentation/sdk-reference/init

Example code demonstrating how to use the init method with promise-based and async/await patterns.

```javascript
// window.SRCSDK_MASTERCARD.init returns a promise which will:
// Resolve to indicate success. init does not return a payload.
// Reject to indicate an error was encountered.
// The reject payload might include one of the reason codes listed below:
// SRCI_ID_MISSING: The identifier for the SRC Initiator is missing.
// DPA_ID_MISSING: The identifier for the DPA is missing.
// SRCI_TXID_MISSING The SRC Initiator transaction identifier is missing.
// DPA_TXOPT_MISSING: The DPA Transaction Options structure is missing.
// Or one of the standard errors included in the Standard Errors and Business Errors section

const sampleInitParams = {
  srcInitiatorId: String, // required
  // SRCI identifier. This is generated by the Click to Pay System during onboarding.

  srciDpaId: String, // required
  // DPA Identifier. This is generated by the SRCI during registration.

  srciTransactionId: String, // required
  // A unique id used to track the user journey. This is used for analytics to
  // be able to correlate a single user "session" from button impression to the
  // end of the transaction.
  // This field may be created on the merchant page by the SRC Initiator and
  // need to be passed-through to all the networks (Click to Pay Systems). It is passed
  // all the way to the DCFs as well.


  dpaTransactionOptions: DpaTransactionOptions, // required
  // dpaTransactionOptions
  // DPA-specific preferences and transaction configuration parameters
  // Optionality note: Must be provided to init or checkout. The checkout DpaTransactionOptions
  // will override the DpaTransactionOptions provided to init
}

// Define response handlers
function promiseResolvedHandler (payload) {
  // add success handler logic here
}
function promiseRejectedHandler (payload) {
  // add error handler logic here
}

// Promise-based approach
const initPromise = window.SRCSDK_MASTERCARD.init(sampleInitParams) //  returns a promise
initPromise
  .then(promiseResolvedHandler) // No other SDK methods should be invoked until `init` resolves
  .catch(promiseRejectedHandler)

// Async/await approach
async function initHandler () { // this method will return a promise
  try {
    const promiseResolvedPayload = await window.SRCSDK_MASTERCARD.init(sampleInitParams) // No other SDK methods should be invoked until `init` resolves
    // add success handler logic here
    // or
    // promiseResolvedHandler(promiseResolvedPayload)
  } catch (promiseRejectedPayload) {
    // add error handler logic here
    // or
    // promiseRejectedHandler(promiseRejectedPayload)
  }
}

```

--------------------------------

### Get Customers by Search - cURL

Source: https://developer.mastercard.com/open-finance-us/documentation/customer-records

Example cURL request to retrieve customer records. Use the `search` parameter to find customers by name and `limit` to control the number of results per page. The `start` parameter is used for pagination.

```curl
GET 'https://api.finicity.com/aggregation/v1/customers?search=John&start=1&limit=25'
```

--------------------------------

### Get Available Balance Response Example

Source: https://developer.mastercard.com/open-finance-us/documentation/participant-model/partner-linked/processor/processor-steps

This is an example of the response structure for the Get Available Balance API, providing details about the account balance and status.

```json
{
  "id": 5047759451,
  "realAccountNumberLast4": "2222",
  "availableBalance": 228.33,
  "availableBalanceDate": 1646076805,
  "cleared Balance": 228.33,
  "clearedBalanceDate": 1646076805,
  "aggregationStatusCode": 0,
  "currency": "USD"
}
```

--------------------------------

### Build and Package the Application

Source: https://developer.mastercard.com/ethoca-alerts-for-merchants/documentation/tutorials-and-guides/reference-app-tutorial

Run this command in the project's base directory to build the application and package it into an executable JAR file.

```bash
mvn clean package spring-boot:repackage
```

--------------------------------

### Clone and Run BIN Lookup API Sample Code

Source: https://developer.mastercard.com/bin-lookup/documentation/developer-tools/sample-code

Instructions to clone the sample code repository, install dependencies, and run the single lookup example script.

```bash
git clone https://github.com/Mastercard-Samples/BIN-Lookup-API-Sample-Code.git
cd BIN-Lookup-API-Sample-Code
pip install -r requirements.txt
cd Examples
python single-lookup-example.py
```

--------------------------------

### Get Logo by Merchant GUID Request

Source: https://developer.mastercard.com/merchant-self-services/documentation/llms-full.txt

This is a GET request to the getLogoByMerchantGuid endpoint. The merchant GUID must be provided in the URL as a parameter, and there is no request body.

```text
Merchant GUID of an existing merchant, such as JkaGSDZ30yMckrtZ
```

--------------------------------

### GET /merchants/participations Response Example (Error)

Source: https://developer.mastercard.com/unified-installments/documentation/testing/merchant-participation-api/merchant-participation-api-negativesc

This example shows an error response from the GET /merchants/participations endpoint, detailing validation failures for submitted merchant data.

```APIDOC
## GET /merchants/participations

### Description
Retrieves the processing status and details of merchant participation requests.

### Method
GET

### Endpoint
`/merchants/participations`

### Parameters
#### Query Parameters
- **requestId** (string) - Required - The ID of the request to check status for. Available after calling `POST /merchants/participations`.
- **limit** (integer) - Optional - The maximum number of results to return.
- **offset** (integer) - Optional - The number of results to skip.

### Response
#### Error Response (400)
- **requestEndpoint** (string) - The endpoint that was called.
- **requestId** (string) - The ID of the request.
- **httpErrorStatusCode** (integer) - The HTTP status code of the error.
- **errors** (array of objects) - A list of errors encountered during processing.
  - **Source** (string) - The source of the error.
  - **ReasonCode** (string) - A code indicating the reason for the error.
  - **Description** (string) - A description of the error, including the field and value that failed validation.
  - **Recoverable** (boolean) - Indicates if the error is recoverable.
  - **Details** (string) - Additional details about the error and how to resolve it.

### Response Example
```json
[
  {
    "requestEndpoint": "/merchants/participations",
    "requestId": "405013477384519700",
    "httpErrorStatusCode": 400,
    "errors": [
      {
        "Source": "merchant-participation-api",
        "ReasonCode": "invalid data: acquirerICA",
        "Description": "Example Mid Merchant 01 at index 0 verification for field acquirerICA value as '111111' failed.",
        "Recoverable": false,
        "Details": "The Acquirer's Interbank Card Association (ICA) number you provided is either invalid or not recognized by Mastercard. For further clarification, please contact the Product Operations team at installments.product.support@mastercard.com"
      },
      {
        "Source": "merchant-participation-api",
        "ReasonCode": "invalid data: dbaNames",
        "Description": "Example Maid Merchant 02 at 1 field dbaNames must not be null or empty.",
        "Recoverable": false,
        "Details": "For further clarification, please contact the Product Operations team at installments.product.support@mastercard.com"
      }
    ]
  }
]
```
```

--------------------------------

### Windows Path Configuration Example

Source: https://developer.mastercard.com/mastercard-benefits-and-experiences-portal/documentation/llms-full.txt

Illustrates the correct format for the keystore path on Windows systems, using double backslashes to escape path separators.

```properties
mastercard.benefitsportal.ref.app.keystore.path = C:\\path\\SandboxKey.p12
```

--------------------------------

### Install Dependencies for Reference Application

Source: https://developer.mastercard.com/open-finance-us/documentation/llms-full.txt

Installs the necessary dependencies for the Open Banking Reference Application after cloning the repository.

```shell
git clone https://github.com/Mastercard/open-banking-reference-application.git
cd open-banking-reference-application
npm i
```