Transactions
Inject Transaction
Inject a transaction into the watch system for real-time risk evaluation.
POST
/
inject
curl -X POST http://localhost:8081/inject \
-H "Content-Type: application/json" \
-d '{
"amount": 5000.00,
"currency": "USD",
"transaction_id": "txn_ref_001",
"source": "balance_123",
"destination": "balance_456",
"description": "High-value transfer",
"created_at": "2026-03-16T09:00:00Z",
"meta_data": {
"merchant_category": "finance",
"country": "US"
}
}'
{
"transaction_id": "0f81a4e1-2b8d-496b-8d5d-a4e1e980f1a6",
"message": "Call GET /transactions/{id} to fetch the processed transaction or set ALERT_WEBHOOK_URL to get webhooks when a rule triggers for the transaction."
}
Blnk Watch is currently in beta. Send us a message
Any extra Blnk attributes you want rules to use should be sent inside
meta_data.The field names match Blnk transaction naming -
transaction_id, amount, currency, source, destination, created_at, meta_data - so mapping from Blnk Core stays predictable. Body
number
The transaction amount to evaluate.
string
The three-letter ISO currency code. For example,
USD.string
A unique identifier for the transaction. If not provided, Watch generates a UUID.
string
The source balance identifier.
string
The destination balance identifier.
string
A free-form description of the transaction.
string
The transaction timestamp in ISO 8601 format. If not provided, Watch uses the current server time.
object
Additional metadata as key-value pairs. Use this to pass Blnk attributes needed by your rules.
curl -X POST http://localhost:8081/inject \
-H "Content-Type: application/json" \
-d '{
"amount": 5000.00,
"currency": "USD",
"transaction_id": "txn_ref_001",
"source": "balance_123",
"destination": "balance_456",
"description": "High-value transfer",
"created_at": "2026-03-16T09:00:00Z",
"meta_data": {
"merchant_category": "finance",
"country": "US"
}
}'
{
"transaction_id": "0f81a4e1-2b8d-496b-8d5d-a4e1e980f1a6",
"message": "Call GET /transactions/{id} to fetch the processed transaction or set ALERT_WEBHOOK_URL to get webhooks when a rule triggers for the transaction."
}
Need help?
We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.Was this page helpful?
⌘I
curl -X POST http://localhost:8081/inject \
-H "Content-Type: application/json" \
-d '{
"amount": 5000.00,
"currency": "USD",
"transaction_id": "txn_ref_001",
"source": "balance_123",
"destination": "balance_456",
"description": "High-value transfer",
"created_at": "2026-03-16T09:00:00Z",
"meta_data": {
"merchant_category": "finance",
"country": "US"
}
}'
{
"transaction_id": "0f81a4e1-2b8d-496b-8d5d-a4e1e980f1a6",
"message": "Call GET /transactions/{id} to fetch the processed transaction or set ALERT_WEBHOOK_URL to get webhooks when a rule triggers for the transaction."
}