Create bank transaction
curl --request POST \
--url https://staging-api.usetyms.com/v1/adam/bank-transactions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"bank": "f9e8d7c6b5a4438291f0e9d8c7b6a5948",
"amount": 45000,
"type": "debit",
"date": "2026-03-06",
"narration": "POS settlement — March 6",
"balance": 1250000,
"exchange_rate": 1,
"group_reference": "BATCH-20260306-01",
"apply_adam_rule": true,
"source": "manually_added"
}
'import requests
url = "https://staging-api.usetyms.com/v1/adam/bank-transactions"
payload = {
"bank": "f9e8d7c6b5a4438291f0e9d8c7b6a5948",
"amount": 45000,
"type": "debit",
"date": "2026-03-06",
"narration": "POS settlement — March 6",
"balance": 1250000,
"exchange_rate": 1,
"group_reference": "BATCH-20260306-01",
"apply_adam_rule": True,
"source": "manually_added"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bank: 'f9e8d7c6b5a4438291f0e9d8c7b6a5948',
amount: 45000,
type: 'debit',
date: '2026-03-06',
narration: 'POS settlement — March 6',
balance: 1250000,
exchange_rate: 1,
group_reference: 'BATCH-20260306-01',
apply_adam_rule: true,
source: 'manually_added'
})
};
fetch('https://staging-api.usetyms.com/v1/adam/bank-transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "success",
"message": "Bank transaction created successfully",
"data": {
"uuid": "f6a7b8c9d0e1428290a1b2c3d4e5f6b8",
"type": "debit"
}
}{
"status": "failed",
"message": "<string>"
}Bank transactions
Create bank transaction
Manual single transaction. Requires an existing bank on the business.
POST
/
bank-transactions
Create bank transaction
curl --request POST \
--url https://staging-api.usetyms.com/v1/adam/bank-transactions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"bank": "f9e8d7c6b5a4438291f0e9d8c7b6a5948",
"amount": 45000,
"type": "debit",
"date": "2026-03-06",
"narration": "POS settlement — March 6",
"balance": 1250000,
"exchange_rate": 1,
"group_reference": "BATCH-20260306-01",
"apply_adam_rule": true,
"source": "manually_added"
}
'import requests
url = "https://staging-api.usetyms.com/v1/adam/bank-transactions"
payload = {
"bank": "f9e8d7c6b5a4438291f0e9d8c7b6a5948",
"amount": 45000,
"type": "debit",
"date": "2026-03-06",
"narration": "POS settlement — March 6",
"balance": 1250000,
"exchange_rate": 1,
"group_reference": "BATCH-20260306-01",
"apply_adam_rule": True,
"source": "manually_added"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bank: 'f9e8d7c6b5a4438291f0e9d8c7b6a5948',
amount: 45000,
type: 'debit',
date: '2026-03-06',
narration: 'POS settlement — March 6',
balance: 1250000,
exchange_rate: 1,
group_reference: 'BATCH-20260306-01',
apply_adam_rule: true,
source: 'manually_added'
})
};
fetch('https://staging-api.usetyms.com/v1/adam/bank-transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "success",
"message": "Bank transaction created successfully",
"data": {
"uuid": "f6a7b8c9d0e1428290a1b2c3d4e5f6b8",
"type": "debit"
}
}{
"status": "failed",
"message": "<string>"
}Authorizations
Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.
Body
application/json
Bank uuid. Alias: bank_uuid.
Positive amount.
credit = money in, debit = money out.
Available options:
credit, debit Response
Created