Inject Transaction

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

When using Watch, use this endpoint to inject a transaction into the service for real-time risk evaluation.

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.

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."
}

Start Here

Transactions

Instructions

Git sync

Body

Need help?

​Body

​Need help?

Body

Need help?