> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adjusting partner fees

> Override preconfigured partner fee amounts on a per-transaction basis using the adjustedPartnerFeeAmount field.

**What is it?** The `adjustedPartnerFeeAmount` field allows partners to override their preconfigured partner fee amount on a per-transaction basis when using [authorizeCustomerInitiatedTransaction](/acquiring/reference/graphql/operations/authorizecustomerinitiatedtransaction),
[authorizeRecurring](/acquiring/reference/graphql/operations/authorizerecurring), or [initiateBankTransfer](/acquiring/reference/graphql/operations#initiate-bank-transfer) mutations.

<Tip type="when to use">
  **When to Use**

  <ul>
    <li>You want to override your standard partner fee for specific transactions.</li>
    <li>You need to waive or reduce fees for promotional purposes.</li>
    <li>You want to adjust fees based on transaction amount or merchant relationship.</li>
  </ul>
</Tip>

<Callout icon="clapperboard-play" color="#6938EF" type="scenario">
  **Scenario**

  The partner typically charges CoolTechGear.com a \$2.50 partner fee per transaction (which is configured in CoolTechGear.com's billing profile), but for a given transaction, the partner chooses to waive the fee and sets the `adjustedPartnerFeeAmount` to \$0, resulting in no partner fee for this specific transaction.
</Callout>

### Implementation rules

1. This must be enabled to use, please reach out to your Tesouro representative for more information
2. When provided, this field overrides any partner fee amount preconfigured in the billing profile for the specific transaction
3. Setting the value to `0` effectively waives the partner fee for the transaction
4. The adjusted fee cannot exceed the total transaction amount (e.g., for a \$5 transaction, the maximum adjustable fee is \$5) by default, however this setting can be reduced as needed by contacting your Tesouro representative
5. This fee is assessed to the acceptor and is not charged to the cardholder
6. The fee amount is not sent to the network or bank

### Usage notes

* This field provides flexibility to customize partner fees based on specific transaction scenarios, business relationships, or promotional activities
* Unlike convenience, service fees or surcharges, this adjustment only affects the partner fee structure and has no impact on the amount charged to the end customer

```json lines theme={null}
{
  "acceptorId": "05a39b14-f29f-443b-a107-da3e3e8969fb",
  "transactionReference": "68448abe-735b-4ee3-af14-d0f50a091c9b",
  "transactionAmountDetails": {
    "totalAmount": 100.0,
    "currency": "USD"
  },
  "adjustedPartnerFeeAmount": 1.5
}
```

<RequestExample>
  ```graphql Operation lines theme={null}
  mutation AuthorizeCIT($input: AuthorizeCustomerInitiatedTransactionInput!) {
    authorizeCustomerInitiatedTransaction(
      authorizeCustomerInitiatedTransactionInput: $input
    ) {
      authorizationResponse {
        status: __typename
        cardDetails {
          paymentBrand
          last4
        }
        tokenDetails {
          token
        }
        transactionId
        paymentId
      }
      errors {
        ... on Error {
          message
          __typename
        }
      }
    }
  }
  ```

  ```json Variables expandable lines theme={null}
  {
    "input": {
      "acceptorId": "05a39b14-f29f-443b-a107-da3e3e8969fb",
      "transactionReference": "68448abe-735b-4ee3-af14-d0f50a091c9b",
      "paymentMethodDetails": {
        "cardWithPanDetails": {
          "expirationMonth": "09",
          "expirationYear": "2051",
          "accountNumber": "5188690009946204",
          "paymentEntryMode": "PAYMENT_METHOD_ON_FILE",
          "paymentChannel": "ECOMM",
          "securityCode": {
            "omissionReason": "VERIFICATION_NOT_REQUESTED"
          }
        }
      },
      "transactionAmountDetails": {
        "totalAmount": 100.99,
        "currency": "USD"
      },
      "automaticCapture": "ON_APPROVAL",
      "adjustedPartnerFee": 1
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response expandable lines theme={null}
  {
    "data": {
      "authorizeCustomerInitiatedTransaction": {
        "authorizationResponse": {
          "status": "AuthorizationApproval",
          "networkApprovalCode": "808907",
          "authorizationAmountDetails": {
            "approvedAmount": 36,
            "requestedAmount": 36,
            "currency": "USD"
          },
          "cardDetails": {
            "paymentBrand": "VISA",
            "last4": "0005"
          },
          "tokenDetails": {
            "token": "ae1d0699-a5f3-4548-aaa8-068b57564118"
          },
          "transactionId": "c0b554b8-7819-11ee-acb0-7445f363cd81",
          "paymentId": "c0b554b8-7819-11ee-acb0-7445f363cd81",
          "systemTraceAuditNumber": "808040",
          "networkResponseDetails": {
            "processorResponseCode": "A0000",
            "networkResponseCode": "00"
          },
          "avsResponseDetails": {
            "networkCode": null
          }
        },
        "errors": null
      }
    }
  }
  ```
</ResponseExample>