# Get the Trustap fee for an online transaction

This returns the Trustap fee, in the 's smallest unit,
for a transaction involving goods with the supplied . See
[the Stripe
documentation](https://stripe.com/docs/currencies#zero-decimal)
for more details.


Endpoint: GET /charge
Version: 0.1.0
Security: OAuth2, APIKey

## Query parameters:

  - `currency` (string, required)
    The currency that the  is specified in.

  - `price` (integer, required)
    The price of the goods being sold in this transaction, in
the 's smallest unit. For example, if a trading
card is being sold for $12.34 (with  as ),
then the request for the charge for this transaction would
be .

  - `quantity` (integer)
    When creating transactions from a multi-use listing, the
 parameter can be provided in order to generate a
charge for the given price multiplied by the given quantity.
See 
for more details.

  - `payment_method` (string)
    The payment method that will be used to pay for the
transaction. This is necessary because different payment
methods may result in different fees.

The default value is .

  - `use_hr_post` (boolean)

  - `postage_fee` (integer)
    The custom  for the transaction.

## Response 200 fields (application/json):

  - `charge` (integer, required)
    The Trustap fee that the buyer will pay, in the 's
smallest unit, for a queried amount. See [the Stripe
documentation](https://stripe.com/docs/currencies#zero-decimal)
for more details.
    Example: 78

  - `charge_calculator_version` (integer, required)
    The version of the Trustap charge calculator that was used
to calculate this charge.

This property is present for error-handling purposes. The
Trustap API allows apps and users to query how much Trustap
will charge for a transaction before creating a transaction.
Trustap then requires the queried charge to be provided when
creating a transaction or listing. At this point the charge
is calculated again and checked against the provided charge,
to ensure that the charge calculated for the new resource is
the same as the one shown to the user. In the unlikely event
that the Trustap charge calculator used to calculate the
charge has been updated, then the
 property will be used to return
an  to the API client, which will
indicate that the  endpoint should be queried again
to get the newest charge value.
    Example: 5

  - `charge_postage_buyer` (integer)
    When the transaction handles the generation of postage
labels, then  will be added to cover this
fee together with

  - `charge_postage_client` (integer)

  - `charge_seller` (integer, required)
    The Trustap fee that the seller will pay, in the
's smallest unit, for a queried amount. See [the
Stripe
documentation](https://stripe.com/docs/currencies#zero-decimal)
for more details.

  - `currency` (string, required)
    Example: "eur"

  - `price` (integer, required)

## Response 400 fields (application/json):

  - `code` (string, required)
    Example: "negative_price"

  - `error` (string, required)
    A contextual description of the error that occurred. When
handling errors the  field should be used to determine
the type of error that occurred, as the text in the 
field may change unexpectedly.
    Example: "`price` cannot be negative"