Allwallex API ยท v1

Inspect recorded customer operations.

Owner, Finance, Operations and Security can inspect deposits, withdrawals, refunds and internal transfers using a separate admin session with current passkey verification. Merchant API keys and app sessions cannot access these routes.

Testnet environment. Transactions use test assets and do not settle real payments.

01Find an operation

GET /v1/admin/payments accepts kind, state, assetId, workspaceId, walletId, reference, txHash, from, until, before and limit. Reference and state filters are exact. Wallet filters match the source or internal-transfer counterparty. Transaction hashes accept 64 hex characters, optionally prefixed with 0x. Dates use UTC ISO8601 with milliseconds. The default window is seven days, with a maximum of 90 days. Pages default to 50 and allow at most 100 records.

02Continue the original filters

Send nextCursor as before using the same filters. The cursor retains the original time window. Results use descending creation time and operation ID; this live history is not a frozen statement. Refresh to retrieve later changes. Workspace and wallet names are explicitly current names. Money remains atomic-unit strings.

03Distinguish offered fees from posted charges

GET /v1/admin/payments/{id} returns the recorded principal and fees, plus feeStage. Posted means a matching original fee assessment exists. Offered means an original quote exists without an assessment: cancelled or pending withdrawals can retain these quote amounts without earning revenue. Unrecorded means no quote or assessment; review_required identifies missing or inconsistent records. Never treat every fee displayed in operations as earned revenue.

04Read final delivery separately

Outgoing operations retain their original requested principal even when the transaction definitively fails. Where a final settlement exists, inspect deliveredAtomic, actualDebitAtomic, refundedAtomic and actualNativeFeeAtomic. Native gas expense is denominated in nativeAssetId, separately from the customer network charge. A missing outgoing settlement is not evidence that a deposit or internal transfer failed.

05Follow original accounting

Detail includes original operation, assessment, reservation, release, settlement, native expense and deposit recognition journal references when available. The admin dashboard opens these in /ledger?journal={id}. No raw payloads, credentials, signing requests or financial mutation endpoints are exposed. Recovery quarantine and Cache-Control: private, no-store apply. Unrecognized chain events are investigated in Deposits, rather than treated as completed customer operations.

// Requires a current verified operator admin session.
GET /v1/admin/payments?kind=withdrawal&state=cancelled
GET /v1/admin/payments?assetId=ethereum%3Asepolia%3Ausdc&walletId={walletId}
GET /v1/admin/payments?kind=withdrawal&state=cancelled&before={nextCursor}
GET /v1/admin/payments/{operationId}

// Inspect feeStage before interpreting fee amounts.
// Requested principal and actual final delivery are separate values.
Open your workspace