Transaction Status

The answer to "I timed out — did the money move?". Requires inbound:read.

Returns the same data block as Credit, so one parser handles both.

Request

cURL
curl https://api.smartpay.sl/api/v1/inbound/transactions/UBA-20260819-0001 \
  -H "X-API-Key-ID: $SMARTPAY_API_KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIG"

Response

200 Found
{
  "success": true,
  "code": "COMPLETED",
  "message": "Transaction found",
  "data": {
    "inbound_id": "INB_7KP2M9XR4TQW",
    "reference": "UBA-20260819-0001",
    "transaction_id": "TXN_4M8XQ2VN7PLK",
    "status": "COMPLETED",
    "operation": "credit",
    "amount": 50000,
    "fee": 0,
    "net_credited": 50000,
    "currency": "SLE",
    "completed_at": "2026-08-19T14:22:01Z"
  }
}

404 Never seen
{
  "success": false,
  "code": "REFERENCE_NOT_FOUND",
  "message": "No transaction found for that reference"
}

What each answer means for you

Response	What to do
`COMPLETED`	The money moved. Settle with your customer
`REJECTED` / `FAILED`	Nothing moved. Refund your customer, or fix and resend
`REVERSED`	It moved, then was returned
`PROCESSING`	Still settling. Poll again shortly
`404 REFERENCE_NOT_FOUND`	We never received it. Safe to send the credit with that same reference

Warning

Do not treat a 404 as failure and mint a new reference for a later retry. Reuse the original one — that is what keeps the operation single-credit if the first attempt turns out to have landed after all.

What each answer means for you​

What each answer means for you