wallet15 عملية

Wallet API

Customer and driver wallets, balances, holds, and ledger transactions.

Queries

QUERY

accountTransactions

#

Get transactions for a specific account (admin only)

الوسائط

  • input!
يُرجع!
QUERY

accountWallets

#

Get wallets for a specific account (admin only)

الوسائط

  • input!
يُرجع!
QUERY

adminListWallets

#

List all wallets with filtering, sorting, and pagination. # Authorization Requires TenantAdmin or PlatformAdmin role. # Filters - kinds: Filter by wallet kind(s) (Customer, Driver, Merchant, etc.) - statuses: Filter by wallet status(es) (Active, Suspended, Closed) - currencies: Filter by currency/currencies - accountId: Filter by specific account ID - minBalanceMinor: Minimum balance filter - maxBalanceMinor: Maximum balance filter - minAvailableMinor: Minimum available balance filter - search: Search by account ID prefix # Sorting Available fields: CreatedAt, UpdatedAt, Balance, AvailableBalance, Kind, Status

الوسائط

  • input!
يُرجع!
QUERY

adminWalletStats

#

Get wallet statistics grouped by kind. Supports filtering using the same filters as adminListWallets.

الوسائط

  • filters
يُرجع!
QUERY

exportAccountTransactions

#

Export account transactions in CSV, JSON, or PDF format. # Authorization Requires TenantAdmin or PlatformAdmin role. # Arguments * input - Export parameters including account ID, date range, and format # Returns Export data with content type and suggested filename. For PDF format, the data is base64-encoded.

الوسائط

  • input!
يُرجع!
QUERY

exportPlatformTransactions

#

Export platform transactions in CSV, JSON, or PDF format. # Authorization Requires TenantAdmin or PlatformAdmin role. # Arguments * input - Export parameters including optional wallet ID, date range, and format # Returns Export data with content type and suggested filename. For PDF format, the data is base64-encoded.

الوسائط

  • input!
يُرجع!
QUERY

myTransactions

#

الوسائط

  • input
يُرجع!
QUERY

myWallet

#

الوسائط

  • input
يُرجع!
QUERY

myWallets

#

الوسائط

  • input
يُرجع!
QUERY

orderTransactions

#

Fetch all wallet transactions for a specific order. # Authorization Requires TenantAdmin or PlatformAdmin role. # Arguments * order_id - The order ID to fetch transactions for # Returns List of wallet transactions associated with the order.

الوسائط

  • orderId!
يُرجع[!]!
QUERY

orderTransactionsByRole

#

Fetch all wallet transactions for an order, grouped by participant role. This query returns the same data as orderTransactions but organizes transactions by role (customer, driver, vendor, provider, partner, platform) for easier display in admin interfaces. # Authorization Requires TenantAdmin or PlatformAdmin role. # Arguments * order_id - The order ID to fetch transactions for # Returns Transactions grouped by participant role, with totals per role.

الوسائط

  • orderId!
يُرجع!
QUERY

partnershipWallets

#

Get wallets for a specific partnership. Returns all wallets (across currencies) belonging to the partnership. Requires either partnership admin access or tenant/platform admin role.

الوسائط

  • input!
يُرجع!
QUERY

platformTransactions

#

List platform wallet transactions (admin only). Returns transactions that affect platform wallets with filtering and pagination.

الوسائط

  • input!

    افتراضي

    {
  "pagination": {
    "limit": 10,
    "page": 1,
    "after": null
  },
  "filters": null
}
يُرجع!
QUERY

platformWallets

#

List platform wallets (admin only).

الوسائط

  • input!

    افتراضي

    {
  "pagination": {
    "limit": 10,
    "page": 1,
    "after": null
  }
}
يُرجع!

Mutations

MUTATION

adjustWallet

#

Manually adjust a wallet balance (admin only). Used for corrections, gifts, manual payments, manual payouts, etc. Only TenantAdmin and PlatformAdmin roles can call this mutation. The adjustment creates a ledger transaction with the appropriate purpose and updates the wallet balance atomically.

الوسائط

  • input!
يُرجع!