---
updatedAt: 2026-05-06T19:26:56.000Z
agentTools:
  projectIndex: https://developers.bluesnap.com/v8976-XML/llms.txt
---

# surcharge-calculation

### Request

| Property             | Type        | Required                                                                                                         | Description                                                                                                                                                        |
| :------------------- | :---------- | :--------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency`           | *string*    | **Required**<br /> *Calculate Surcharge requests only*                                                           | The currency being used for the transaction.                                                                                                                       |
| `amount`             | *string*    | **Required**                                                                                                     | The amount of the transaction prior to surcharge.                                                                                                                  |
| `payment-method`     | *string*    | Optional                                                                                                         | The payment method of the transaction. If payment information such as `credit-card` is provided in the request, the payment method will be inferred automatically. |
| `pf-token`           | *string*    | **Required**<br /> *for Calculate Surcharge requests only if using Hosted Payment Fields*                        | A [Hosted Payment Fields token](https://developers.bluesnap.com/v8976-Tools/reference/hosted-payment-fields).                                                      |
| `wallet`             | *container* | **Required**<br /> *Only if using Apple Pay or Google Pay*                                                       | Refer to [wallet](https://developers.bluesnap.com/v8976-XML/reference/wallet).                                                                                     |
| `vaulted-shopper-id` | *integer*   | Optional<br /> *Calculate Surcharge requests only*                                                               | A [Vaulted Shopper ID](https://developers.bluesnap.com/v8976-XML/reference/returning-shopper-tutorial).                                                            |
| `credit-card`        | *container* | **Required**<br /> *for Calculate Surcharge requests only if not using Hosted Payment Fields or vaulted shopper* | Refer to [credit-card](https://developers.bluesnap.com/v8976-XML/reference/credit-card).                                                                           |
| `surcharge-info`     | *container* | **Required**<br /> *Calculate Prorated Surcharge requests only*                                                  | Refer to [surcharge-info](https://developers.bluesnap.com/v8976-XML/reference/surcharge-info).                                                                     |

### Response

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Property
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `currency`
      </td>

      <td>
        _string_
      </td>

      <td>
        The currency used for the surcharge calculation.
      </td>
    </tr>

    <tr>
      <td>
        `amount`
      </td>

      <td>
        _string_
      </td>

      <td>
        The calculated amount of the surcharge.
      </td>
    </tr>

    <tr>
      <td>
        `payment-method`
      </td>

      <td>
        _string_
      </td>

      <td>
        The payment method of the transaction.  
        _Calculate Surcharge response only_
      </td>
    </tr>

    <tr>
      <td>
        `payer-details`
      </td>

      <td>
        _container_
      </td>

      <td>
        Refer to [payer-info](https://developers.bluesnap.com/v8976-XML/reference/payer-info).<br /> _Calculate Surcharge response only_
      </td>
    </tr>

    <tr>
      <td>
        `credit-card`
      </td>

      <td>
        _container_
      </td>

      <td>
        Refer to [credit-card](https://developers.bluesnap.com/v8976-XML/reference/credit-card).
      </td>
    </tr>

    <tr>
      <td>
        `surcharge-info`
      </td>

      <td>
        _container_
      </td>

      <td>
        Refer to [surcharge-info](https://developers.bluesnap.com/v8976-XML/reference/surcharge-info).
      </td>
    </tr>
  </tbody>
</Table>