Payments

Agent User Transactions

List transactions for mobile users assigned to the authenticated agent.

List Agent User Transactions

GET /api/v1/agent/mobile-users/transactions

Returns a paginated list of transactions for all mobile users that belong to the authenticated agent.

Send the agent access token with the request:

Authorization: Bearer <access_token>

Query parameters

Name	Required	Notes
`card_id`	No	Exact local card database ID
`wallet_id`	No	Exact local wallet database ID
`transaction_type`	No	Exact transaction type, such as `TOP_UP`, `WITHDRAW`, `TRANSFER`, or `PURCHASE`
`transaction_status`	No	Exact status: `PENDING`, `SUCCESS`, or `FAILED`
`direction`	No	Exact direction: `IN` or `OUT`
`payment_number`	No	Exact payment number
`order_id`	No	Exact order ID
`start_date`	No	Start date in `YYYY-MM-DD` format (inclusive)
`end_date`	No	End date in `YYYY-MM-DD` format (inclusive)
`search`	No	Case-insensitive partial search across merchant, payment number, order ID, and the mobile user's name, phone, or email
`page`	No	Page number; defaults to `1` when omitted or less than `1`
`limit`	No	Items per page; defaults to `20` when omitted or less than `1`
`sort_by`	No	Transaction column used for sorting; defaults to `created_at`
`sort_order`	No	`asc` or `desc`; defaults to `desc`

If start_date is later than end_date, the API returns 400 Bad Request.

Success response shape

{
  "status_code": 200,
  "message": "Mobile user transactions retrieved successfully.",
  "data": [
    {
      "id": 91,
      "uuid": "0d65f58d-47f6-43d7-84b2-4bdc8d44e391",
      "title": "Card top up",
      "payment_number": "000000091",
      "order_id": "ORD-20261019-H3KZ",
      "card_id": 508,
      "transaction_type": "TOP_UP",
      "amount": "100.00",
      "fee_amount": "0.00",
      "direction": "IN",
      "transaction_status": "SUCCESS",
      "transaction_currency": "USD",
      "merchant": "",
      "created_at": "2026-10-19T10:00:00Z",
      "updated_at": "2026-10-19T10:00:00Z",
      "mobile_user": {
        "id": 42,
        "uuid": "915765a4-8d9d-45d6-b07d-5654dfec5b75",
        "full_name": "Example User"
      },
      "card": {
        "uuid": "afec39e3-063d-461a-9d43-490f0a990ee1",
        "card_number": "**** **** **** 1234",
        "card_type": "VIRTUAL"
      }
    }
  ],
  "metadata": {
    "has_next": false,
    "has_prev": false,
    "total_page": 1,
    "current_page": 1,
    "limit": 20,
    "total_count": 1,
    "total_wallet_topup_amount": ""
  }
}

Integration notes

Results are restricted to mobile users assigned to the authenticated agent.
amount, fee_amount, transaction_amount, and transaction_fee are formatted strings with 2 decimal places.
mobile_user is always present. card is omitted when the transaction has no associated card.
title and merchant are localized from the request language context.
An unauthenticated or non-agent token returns 401 Unauthorized.

Edit this pageorReport an issue

Agent Fund Balance

Get the current prepaid fund balance for the authenticated agent.

Pushy Notifications

Device token registration, topic subscriptions, and dev push sends.