/sendTransactionFromCashbox

1 min

POST

Call this endpoint to send a transaction from a Cashbox. This endpoint requires the Cashbox ID, the destination index, the fee index, and the passwords (if the destination is protected). Run /getCashboxes to get the values beforehand.

NOTE: Success or failure in this API call does not necessarily mean success or failure in the transaction itself. For example, the transaction may succeed, but the "success" response to the client can be lost if the internet is down for the client.

A discrepancy can also occur if the transaction is approved on the client but fails the signing process.

To verify the status of the transaction:

Call /getCurrentToken and store it in your DB.
Send your Cashbox transaction.
Call /getTransactionByToken using your token from /getCurrentToken to track the current status of the transaction you just sent (See https://docs.gk8.io/api/gettransactionbytoken for more details).

return: JSON object containing the status and details of the transaction.

example: sendTransactionFromCashbox(123, 1, 1, 0, ["password1", "password2"])

cashbox_idintegerInteger identifier for the Cashbox. Call /getCashboxes to get the value beforehand.

destination_indexintegerInteger identifier for the destination to send to. Call /getCashboxes to get the value beforehand.

fee_indexintegerInteger identifier for the fee to pay starting from 0. Call /getCashboxes to get the value details beforehand.

parts_countintegerThe number of parts to send in this transaction. See <a href="https://docs.gk8.io/guides/cashboxes#RU9aC" target="_blank">https://docs.gk8.io/guides/cashboxes#RU9aC</a> for information about Cashbox parts.

passwordsarrayList of passwords for the destination addresses. The passwords are not case sensitive, but must be provided in order. Required if the destination is protected. See <a href="https://docs.gk8.io/guides/cashboxes#DJ3UT" target="_blank">https://docs.gk8.io/guides/cashboxes#DJ3UT</a> for information about protected destinations.

descriptionstringText for describing the transaction in your records. This is not sent to the blockchain.

acceptstringGenerated from available response content types

bodyobjectRequest data for a transaction.

200success

curl --request POST \
     --url '/sendTransactionFromCashbox?cashbox_id=1&destination_index=1&fee_index=1&parts_count=1&passwords=LZ47MIRBQC&description=Text' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "CashboxId": 1,
     "DestinationIndex": 1,
     "FeeIndex": 1,
     "PartsCount": 1,
     "Meta": {
     "FunctionName": "sendTransactionFromCashbox",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'