Transaction Events

transaction_created

Triggered when a new transaction is created.

{
  "event": "transaction_created",
  "data": {
    "transactionId": "BeOfXV1NVIcZlsSVeQAF",
    "status": "pending",
    "type": "deposit",
    "externalReference": "unique-ref"
  },
  "timestamp": "2024-10-03T16:33:14.600Z"
}

transaction_updated

Triggered when a transaction's status changes.

{
  "event": "transaction_updated",
  "data": {
    "transactionId": "string",
    "status": "string",
    "type": "string",
    "externalReference": "string",
    "stepRequired": "string",
    "redirectUrl": "https://test-redirect.com",
    "method": "string",
    "thirdPartyReference": "string",
    "note": "string",
    "txId": "string"
  },
  "timestamp": "ISO-8601 timestamp"
}

With OTP Step Required

{
  "event": "transaction_updated",
  "data": {
    "transactionId": "test123",
    "status": "pending",
    "type": "deposit",
    "externalReference": "mnvmcvcmvlc",
    "stepRequired": "otp",
    "method": "momo"
  },
  "timestamp": "ISO-8601 timestamp"
}

With Redirect Step Required

{
  "event": "transaction_updated",
  "data": {
    "transactionId": "test123",
    "status": "pending",
    "type": "deposit",
    "externalReference": "mnvmcvcmvlc",
    "stepRequired": "redirect",
    "redirectUrl": "https://test-redirect.com",
    "method": "momo"
  },
  "timestamp": "ISO-8601 timestamp"
}

Status Values

pending: Transaction is being processed.
successful: Transaction successfully completed.
failed: Transaction failed.