Sending Payment Transactions

Taxbit accepts transaction data (like payment income) through the API, or through a pre-existing CSV template (available upon request). This page will document how to send transactions to Taxbit through the API.

Send payment transactions to Taxbit using POST /transactions. A transaction should represent a single income event to the seller from the buyer. The seller’s transaction can be represented in the following way:

  • type = income
  • subtype = nec payment-goods payment-services reward referral-bonus other
  • Any fees and commissions charged on a payment to the user should be included on the transaction under the fees object

Example Income Payment

  "user_id": "48a66f26-ac15-456d-8372-3f37d48ba0f6", // Seller's Account/User ID
  "id": "204255-13141",
  "datetime": "2023-10-10T14:13:51.000Z",
  "type": "income",
  "subtype": "payment-services",  // payment-services or payment-goods
  "received": [
    {
      "asset_amount": {
        "asset": {
          "type": "fiat",
          "code": "usd"
        },
        "amount": "904.10"
      },
      "rates": [
        {
          "asset": {
            "type": "fiat",
            "code": "usd"
          },
          "amount": "1"
        }
      ]
    }
  ],
  "fees": [
    {
      "asset_amount": {
        "asset": {
          "type": "fiat",
          "code": "usd"
        },
        "amount": "100"
      },
      "rates": [
        {
          "asset": {
            "type": "fiat",
            "code": "usd"
          },
          "amount": "1"
        },
        {
          "asset": {
            "type": "fiat"
          }
        }
      ]
    }
  ],
  "version": "1.0"
}