API Reference

Transactions API

Query transaction details and track the status of split executions.

GET /api/v1/transactions/:id

Retrieves the full details of a single transaction by its internal ID.

Path Parameters
ParameterTypeDescription
idstringInternal Orchestrator transaction ID

Response

Transaction Object
{
  "_id": "transaction_id",
  "merchantId": "merchant_id",
  "routingRuleId": "rule_id",
  "externalId": "moolre_txn_ref",
  "amount": 10000,
  "currency": "GHS",
  "status": "COMPLETED",
  "orchestratorFeePesewas": 150,
  "tenantId": "tenant_id",
  "providerId": "moolre",
  "createdAt": 1715000000000
}

Transaction Statuses

StatusDescription
PENDINGTransaction received, awaiting processing
PROCESSINGSplit execution in progress
COMPLETEDAll disbursements successful
PARTIAL_FAILURESome disbursements succeeded, others failed
FAILEDTransaction processing failed entirely

Example Request

cURL
curl https://your-orchestrator-domain.com/api/v1/transactions/txn_id \
  -H "Authorization: Bearer mkr_your_api_key_here"