API Reference
Add transactions in batch
/transactions/batch https://transaction-api.cable.tech Authentication
- Bearer token in the Authorization header
Request body
An array of transaction payloads. Each payload must include all required fields except ‘amount_usd’.
-
timestampstring requiredWhen the transaction was processed in your system, in ISO 8601 format. For updates, use when the event occurred, not when you’re reporting it.
Format
date-time -
tx_idstring requiredUnique identifier for the transaction. This is the primary key for the transaction record and should be unique across all transactions. Updates to a transaction should be made using this identifier.
-
typestring requiredTransaction type. Required when creating new transactions, optional for updates.
Allowed values
DEPOSITWITHDRAWAL -
methodstring requiredPayment method used for the transaction. Required when creating new transactions, optional for updates. Each method may have different processing times, fees, and regulatory requirements.
Allowed values
WIREACHSWIFTSEPAAPPLE_PAYCHECK_DEPOSITINTERNAL_TRANSFERRTPPROV_X_TRANSFER -
amountnumber requiredTransaction amount. Required when creating new transactions, optional for updates.
Format
float -
currencystring requiredISO 4217 currency code. Required when creating new transactions, optional for updates.
Format
iso-4217 -
amount_usdnumberAmount in USD, if not provided will be calculated using the latest exchange rate using data from Open Exchange Rates (https://openexchangerates.org)
Format
float -
sender_idstring requiredIdentifier of the sender, this could be an account number, customer id, or any other unique identifier. If you are sending customer data to Cable, this ID should be able to be referenced in that dataset.
-
sender_countrystring requiredISO 3166-1 alpha-2 country code
Format
iso-3166-1 -
receiver_idstringIdentifier of the receiver, this could be an account number, customer id, or any other unique identifier.
-
receiver_countrystring requiredISO 3166-1 alpha-2 country code
Format
iso-3166-1 -
statusstring requiredTransaction status. Required when creating new transactions, optional for updates.
Allowed values
CREATEDPENDINGSETTLEDFAILEDREJECTEDREFUNDED
Responses
200 Batch processing result
-
successboolean requiredIndicates if the write operation was successful.
-
write_countinteger requiredThe number of records written to the database.
Format
int32 -
messagestring requiredProvides additional information about the operation result.
-
organization_idstring requiredThe organization ID for which the operation was performed.
Errors
- 400 Invalid transaction data in batch
- 401 Unauthorized request
- 429 Rate limit exceeded
- 500 Server error
- default General error
-
codeinteger requiredFormat
int32 -
messagestring required -
errorslist of objectsDetailed information about errors in specific fields.
-
fieldstring -
messagestring
-