Choice Bank Notification Callback (0003 Balance Change example) | SARE

curl -X POST http://localhost:8080/api/v3/waas/callbacks/choicebaas \
     -H "Content-Type: application/json" \
     -d '{
  "salt": "a1b2c3d4e5f6...",
  "locale": "en",
  "params": {
    "txId": "TX123",
    "amount": "500.00",
    "txType": "01",
    "userId": "f5c1d4e5-2a3b-4c5d-8e9f-0a1b2c3d4e5f",
    "balance": "1250.50",
    "extInfo": {
      "oppoPhoneNumber": "254712345678",
      "counterpartyName": "Jane Doe",
      "transactionNarrative": "Payment"
    },
    "currency": "KES",
    "accountId": "46012000068891",
    "feeAmount": "0.00",
    "accountName": "Sare Shop",
    "completeTime": 1758100000000,
    "externalTxId": "MPESA-XYZ",
    "oppoBankCode": "M-PESA",
    "oppoBankName": "M-PESA",
    "oppoAccountId": "254712345678",
    "paymentChannel": "MPESA",
    "oppoAccountName": "Jane Doe",
    "thirdPartyTxType": "Pay Bill",
    "mpesaBusinessPayType": 0
  },
  "sender": "choice-baas",
  "requestId": "req-abc123",
  "signature": "base64-signature-over-canonicalized-payload",
  "timestamp": 1758100000000,
  "notificationType": "0003"
}'

Public (waas/callbacks/choicebaas whitelisted) - inbound webhook from Choice Bank. Authenticated via a signature/salt pair EMBEDDED IN THE JSON BODY (verified against the canonicalized payload), not an HTTP header. notificationType dispatches to a different params shape: 0001 PERSONAL_ONBOARDING_RESULT, 0002 TRANSACTION_RESULT, 0003 BALANCE_CHANGE (shown here), 0005 UPGRADE_WALLET_TO_CURRENT_ACCOUNT, 0006 SME_ONBOARDING_RESULT, 0021 ACCOUNT_STATUS_CHANGE, 0022 MERCHANT_BALANCE_CHANGE (same shape as 0003, for B002 merchant accounts).

Public (waas/callbacks/choicebaas whitelisted) - inbound webhook from Choice Bank. Authenticated via a `signature`/`salt` pair EMBEDDED IN THE JSON BODY (verified against the canonicalized payload), not an HTTP header. `notificationType` dispatches to a different `params` shape: 0001 PERSONAL_ONBOARDING_RESULT, 0002 TRANSACTION_RESULT, 0003 BALANCE_CHANGE (shown here), 0005 UPGRADE_WALLET_TO_CURRENT_ACCOUNT, 0006 SME_ONBOARDING_RESULT, 0021 ACCOUNT_STATUS_CHANGE, 0022 MERCHANT_BALANCE_CHANGE (same shape as 0003, for B002 merchant accounts).

Request

This endpoint expects an object.

saltstringRequired

localestringRequired

paramsobjectRequired

senderstringRequired

requestIdstringRequired

signaturestringRequired

timestampintegerRequired

notificationTypestringRequired

Request

Response