Transactions

Transactions are created for funds that come into or flow out of your Speed account balance. This makes it easy to manage payments and reconcile your business transactions regularly. Overall, it provides insight into the payouts and payments of your business.

Types of transactions

The attribute type in the response body of the transaction object indicates the type of the balance. Let’s learn more about the different types of transactions.

Currently, there are three types of transactions, as mentioned below:

PaymentCreditPayment is when you receive funds from your merchant.
PayoutDebitPayout is when funds move from your Speed account to your chosen crypto wallet.
FeesDebitFees are when the transaction fees are debited from your account because of the on-chain fund transfer.

Retrieve transactions via web application

Log in to your account and follow the steps below to retrieve a list of all the transactions.

  1. On the left sidebar, click Transactions.
  2. This will take you to the transaction page, where you can see all the transactions moving through your Speed account.

Retrieve transactions via API

The /balance_transaction endpoint can be used to retrieve information about the transactions like target_currency (currently only SATS), source, type, and so on. You can use the pagination parameters: starting_after, limit, and ending_before to get the desired list of transactions if the has_more attribute is true.

Response

{
  "object": "list",
  "has_more": false,
  "data": [
   {
            "id": "txn_l8bew06lQiivPCGE",
            "object": "balance_transaction",
            "amount": 866.0000000000000000,
            "fee": 0.0000000000000000,
            "net": 866.0000000000000000,
            "target_currency": "SATS",
            "type": "Payment",
            "transaction_type": "credit",
            "source": "pi_l8bevp7cidnRAs8G",
            "created": 1663751840493
   },
  ]
}

Attributes

Your response contains the following attributes:

has_more boolean
If there are more transactions than returned in the response, it has the value true; otherwise, it has the value false.


id string
Unique identifier for the object.


object string
This indicates to which entity this response belongs.


amount BigDecimal
The total amount of this transaction.


fee BigDecimal
This specifies Speed fee applied during this transaction.


net BigDecimal
The net amount received/paid in this transaction after the deduction of fees.


target_currency string
The cryptocurrency in which the amount/fees/net is expressed. As of now, Speed only supports SATS.


type string
Categorizes the transactions based on activities like payment, payout, or others.


transaction_type string
Categorizes the transactions based on whether funds are credited or debited.


source string
Contains the ID of the related resource that initiated the transaction.


created timestamp
Time at which the transaction object was created.