# Adjustment and Adjustment Search API
source: https://developer.mastercard.com/mastercard-send-funding/documentation/api-reference/adjustment/index.md

Note: This new API is in development and has been made available to special early adopters. **This API functionality is subject to change.** We will try to keep this API specification and information up to date. If you notice differences from API behavior, please ask your Mastercard contact for guidance.

Unless you have been asked to try this API, please do **not** start coding for it.

Currently, information specific to this API is only present on this page; we have not adjusted the other pages for it. The documentation set will be updated fully when the API is launched.

### Adjustment {#adjustment}

The Adjustment API creates an adjustment (refund) for an approved funding transfer (Funding Transaction), for example when you need to refund the sending account (Funding Account). You can request adjustments for Funding Transactions created by the [Funding API](https://developer.mastercard.com/mastercard-send-funding/documentation/api-reference/index.md).

Refund adjustments are different from [Funding Reversals](https://developer.mastercard.com/mastercard-send-funding/documentation/api-reference/index.md#funding-reversal), which can reverse an approved Funding Transaction within 30 minutes if the funds cannot be delivered. Refunds occur later, possibly after the funding transfer has been settled and the sending account is debited. The adjustment must be requested:

* Within 180 days for a Mastercard Funding Transaction.
* Within 30 days for a Visa Account Funding Transaction (AFT).

For each adjustment request, generate a unique Adjustment Reference ID (6-40 characters, alphanumeric and \* , - . _ \~ allowed) and provide it as the `adjustmentReference` in the POST request. Identify the funding transfer by providing one of these values:

* The Transfer Reference (`transfer_reference`) you provided when you created the transfer
* The system-generated Transfer ID (`id`) that was returned when you created the transfer

If the adjustment request is successful, the API response (HTTP 201) includes a unique system-generated Adjustment ID (`adjustmentId`). The status (`transactionStatus`) will indicate whether the adjustment was approved:

* 'APPROVED' = The adjustment is approved. The funding transfer's `status` changes to 'REFUNDED'.
* 'DECLINED' = The adjustment is declined. The funding transfer's `status` remains 'APPROVED'.
* 'PENDING' = Similar to the Funding API's 'UNKNOWN' status, see [this guidance](https://developer.mastercard.com/mastercard-send-funding/documentation/response-error-codes/status/index.md#unknown-or-pending-status).

Error responses are returned for API requests that fail Mastercard Send validation or transaction processing, for example, when a required field is missing, a value is incorrectly formatted, or the funding transfer cannot be found or adjusted; see [Error Codes](https://developer.mastercard.com/mastercard-send-funding/documentation/api-reference/adjustment/index.md#error-codes).

### Adjustment Search {#adjustment-search}

The Adjustment Search API retrieves details of an adjustment, including its latest status, by searching for its `adjustmentReference` or `adjustmentId`. Wait at least five seconds after creating the adjustment, otherwise your Search POST call might receive an error. The Search call is useful when a transaction is pending or declined and you need further details for troubleshooting or research purposes. You do not need to use it for approved transactions.

## Environment Domains {#environment-domains}

This API currently uses the non-RNTZ (Regional Network Transit Zone) domains shown below.
* Sandbox
* MTF
* Production

```Sandbox
https://sandbox.api.mastercard.com/send/partners
```

```MTF
https://mtf.api.mastercard.com/send/partners
```

```Production
https://api.mastercard.com/send/partners
```

To form the full endpoint URL, combine the appropriate domain portion (shown above) with the path portion shown by the OpenAPI specification (see below).
Note: In November 2026, we will introduce RNTZ domains for this API. Your Mastercard representative will tell you when they are available.   
Mastercard will end support of the non-RNTZ domains for this API service on 31 March 2027, so please be prepared to migrate to the RNTZ domains when they are available.
* Sandbox
* MTF
* Production

```Sandbox
https://sandbox.api.move.mastercard.com/send/partners
```

```MTF
https://mtf.api.move.mastercard.com/send/partners
```

```Production
https://api.move.mastercard.com/send/partners
```

## APIs {#apis}

This API supports JSON requests. In the expandable sections below, JSON example requests and responses are shown. We recommend you log the Correlation ID (correlation-id) response header value for tracking purposes. When seeking support, providing the relevant Correlation ID may help resolve your inquiry more quickly.

The `partner_id` portion of the URL makes the request unique to a specific Originating Institution or Transaction Initiator:

* Sandbox API: Use any ID of valid length (32-40 characters), e.g. `ptnr_BEeCrYJHh2BXTXPy_PEtp-8DBOo`.
* MTF and Production APIs: Use the Partner Reference ID you receive when you [onboard](https://developer.mastercard.com/mastercard-send-funding/documentation/tutorials-and-guides/onboarding-checklist/index.md) to Mastercard Send.

Note: The `adjustmentReference` value must be unique for each API request to create a transaction, so you must adjust that value for **every** Adjustment call. Otherwise you may get a 409 'Duplicate value' error response.  
The Sandbox server validation detects previously used values, including the default value in the expandable **Adjustment** section below, so we recommend you change it to a random value before clicking **Execute**.

The 'Required' indicator in the API specification relates to general API validation. Other fields may also be required depending on the payment type, region, program rules, or network rules.

API Specification: `https://static.developer.mastercard.com/content/mastercard-send-funding/swagger/send-adjustment-api-swagger.yaml`

## Testing {#testing}

You can make API calls to the Sandbox server from an API tool or your application code or the [tutorials](https://developer.mastercard.com/mastercard-send-funding/documentation/tutorials-and-guides/index.md), which involves creating a Mastercard Developers project and using the Sandbox keys to generate the required OAuth 1.0a Authorization Header.

The Sandbox server returns simulated responses.

For Sandbox and MTF testing guidance, please ask your Mastercard contact. (We will add that information to this documentation set for API launch.)

## Error Codes {#error-codes}

If your API request is unsuccessful, you should receive a service error response or a [gateway error response](https://developer.mastercard.com/mastercard-send-funding/documentation/response-error-codes/error-codes/index.md#gateway-error-codes).

Note that the service error response messages (4xx status code) for this API have a slightly different structure from the Funding API error response. An example error message is shown below. The `Error` array may contain multiple error items.
* JSON

```JSON
{
  "Errors": {
    "Error": [
      {
        "Source": "RESOURCE_UNKNOWN",
        "ReasonCode": "RESOURCE_ERROR",
        "Description": "Record not found",
        "Recoverable": false,
        "ErrorDetailCode": "110507",
        "Details": null
      }
    ]
  }
}
```

This API can return similar `ErrorDetailCode` values to the Funding API, see [service error codes](https://developer.mastercard.com/mastercard-send-funding/documentation/response-error-codes/error-codes/index.md) for that table of codes. For additonal error message codes and guidance, please ask your Mastercard contact. (We will add that additional guidance to this documentation set for API launch.)

## Reports and Customer Portal {#reports-and-customer-portal}

Depending on the Funding Account and network, Adjustment requests are sent to Funding Issuers as either:

* Mastercard Funding Refund Transactions, which have a processing code (Transaction Type Code) of 20
* Visa AFT Adjustments

These transactions will be shown in:

* [Mastercard Send reconciliation reports](https://developer.mastercard.com/mastercard-send/documentation/reports/)
* [Mastercard Send Customer Portal](https://developer.mastercard.com/mastercard-send/documentation/customer-site/): Transaction Research tab searches