Create transactions
POST {{baseUrl}}/{{version}}/transaction
You can create transactions to send money to other Stark Bank accounts.
| Parameters | Value Type | Description |
|---|---|---|
| amount | REQUIRED | A positive integer that represents the amount in cents to be transferred. Example: amount=100 (R$1.00). |
| receiverId | REQUIRED | Id of the workspace that will receive the money. |
| description | REQUIRED | Statement description of this transaction. It will be displayed in the receiver and the sender statement. |
| externalId | REQUIRED | Unique ID you create for each transaction so we can block duplicate transactions. |
| tags | OPTIONAL | Array of strings to tag the entity for future queries. All tags will be converted to lowercase. |
Request Body
{"transactions"=>[{"amount"=>10000, "receiverId"=>"6341320293482496", "description"=>"Paying my debts", "externalId"=>"external_id1", "tags"=>["debts"]}, {"amount"=>20000, "receiverId"=>"6341320293482496", "description"=>"Paying other debts", "externalId"=>"external_id2", "tags"=>["debts", "other"]}]}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"message":"Transactions(s) successfully created","transactions":[{"description":"Paying my debts","tags":["debts"],"senderId":4888651368497152,"id":"6034481622286336","fee":0,"created":"2020-08-31T16:10:19.163070+00:00","receiverId":6341320293482496,"source":"self","amount":-10000,"externalId":"external_id1","balance":191966},{"description":"Paying other debts","tags":["debts","other"],"senderId":4888651368497152,"id":"5471531668865024","fee":0,"created":"2020-08-31T16:10:19.163071+00:00","receiverId":6341320293482496,"source":"self","amount":-20000,"externalId":"external_id2","balance":171966}]}