API Reference
Update an existing transaction
/transaction https://transaction-api.cable.tech Authentication
- Bearer token in the Authorization header
Request body
Transaction data to update, referenced by ‘tx_id’. The ‘timestamp’ field represents the update time. Only the fields to be updated need to be included.
-
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.
-
typestringTransaction type. Required when creating new transactions, optional for updates.
Allowed values
DEPOSITWITHDRAWAL -
methodstringPayment 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 -
amountnumberTransaction amount. Required when creating new transactions, optional for updates.
Format
float -
currencystringISO 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_idstringIdentifier 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_countrystringISO 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_countrystringISO 3166-1 alpha-2 country code
Format
iso-3166-1 -
statusstringTransaction status. Required when creating new transactions, optional for updates.
Allowed values
CREATEDPENDINGSETTLEDFAILEDREJECTEDREFUNDED
Responses
200 Transaction updated successfully
-
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
- 401 Unauthorized request
- 404 Transaction not found
- 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
-