Transactions

Obtener Fees de una Transaction

Changed on

Devuelve el fee que Toku cobró sobre una Transaction, con su desglose.

Se usa para auditar cuánto cobró Toku por un pago y de dónde sale ese monto: el fee se calcula por cada Payment Intent que participó del pago, así que la respuesta trae el total de la Transaction junto al detalle por Payment Intent y los componentes de cada uno.

El fee se calcula en el momento de la consulta a partir de la configuración de fees de la Account; no se lee un valor almacenado en la Transaction.

Solo se responden Transactions de la organización autenticada: una Transaction que existe pero pertenece a otra organización devuelve HTTP 404, igual que una inexistente.

get/transactions/{transaction_id}/fees

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/transactions/{transaction_id}/fees
  • Auth
    API key in header x-api-key

Path parameters

transaction_idstring required

Identificador público de la Transaction cuyo fee se quiere consultar.

Example:trs_6nPCOByYPc9SGhKiLzAJ-IS2QtV-OvbN

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Response

Desglose del fee cobrado sobre la Transaction.

fee_amountstring required

Fee total cobrado sobre la Transaction, sin decimales.

transaction_amountstring required

Monto total de la Transaction, con cuatro decimales.

transaction_idstring required

Transaction consultada.

Example response

{
  "fees": [
    {
      "account_id": "acc_OG3xW2_w3ml04Ju42ZYbmkGtTQoWVGWt",
      "invoice_id": "in_fdhEJEKhbRra1sYlyEIx5LGvCzn6HoFI",
      "payment_intent_id": "pi_N-nfKV4QtYbJBaGHPC9xUAvE3meikZRY"
    }
  ],
  "transaction_id": "trs_6nPCOByYPc9SGhKiLzAJ-IS2QtV-OvbN"
}

Changes

    • breaking

      removed the request body

    • breaking

      the //// response's property type changed from string to no type for status

    • info

      api operation id transaction-fee removed and replaced with get_transaction_fees_public

    • info

      api tag Transactions added

    • info

      added the new optional header request parameter x-account-key

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      added to the //// response property allOf list for the response status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status