Skip to main content
What is it? The adjustedPartnerFeeAmount field allows partners to override their preconfigured partner fee amount on a per-transaction basis when using authorizeCustomerInitiatedTransaction, authorizeRecurring, or initiateBankTransfer mutations.
When to Use
  • You want to override your standard partner fee for specific transactions.
  • You need to waive or reduce fees for promotional purposes.
  • You want to adjust fees based on transaction amount or merchant relationship.
ScenarioThe 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.

​
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
{
    "acceptorId": "05a39b14-f29f-443b-a107-da3e3e8969fb",
    "transactionReference": "68448abe-735b-4ee3-af14-d0f50a091c9b",
    "transactionAmountDetails": {
        "totalAmount": 100.00,
        "currency": "USD"
    },
    "adjustedPartnerFeeAmount": 1.50
}

mutation AuthorizeCIT($input: AuthorizeCustomerInitiatedTransactionInput!) {
  authorizeCustomerInitiatedTransaction(
    authorizeCustomerInitiatedTransactionInput: $input
  ) {
    authorizationResponse {
      status: __typename
      cardDetails {
        paymentBrand
        last4
      }
      tokenDetails {
        token
      }
      transactionId
      paymentId
    }
    errors {
      ... on Error {
        message
        __typename
      }
    }
  }
}

{
  "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
    }
  }
}