Wallet transactions

Wallet transactions provide insight into funds that move in and out of an account’s wallet. For each Moov transfer, we create a corresponding transaction that represents how that initial source impacted a wallet. This granularity enables you to:

  • Reconcile a wallet’s balance on any given day
  • Create itemized reports leveraging transaction types (fees earned and paid, payouts, refunds, etc.)
  • Monitor your wallet activity to stay informed on the latest transactions

Each transaction is paired with a detailed memo that provides more context about the transaction. If you want even more insight into how the transaction was created, we link back to the transfer, dispute, or card issuing transaction with a sourceID so you can grab the necessary details.

Statuses

A wallet transaction can either have a status of pending or completed. Pending transactions will only apply to credits, or incoming funds. Any funds in a pending state will not affect the wallet balance or be available for use until that transaction is completed. If a pending transaction results in a failure, we’ll simply omit it from the transaction list - but you can still access the transaction by using the GET endpoint and supplying the walletID and transactionID.

tip
We recommend using the GET wallet endpoint to check the available balance.

Once a transaction moves to completed, the completedOn timestamp will be populated along with the availableBalance.

Wallet transaction types

We categorize wallet transactions by the following distinct types.

Type Description Source Memo
payment An ACH payment from a bank to the account’s wallet Transfer ACH payment from {displayName}
top-up Transfer of funds into a wallet from the account’s bank Transfer Top up from {bankAccountType} {lastFourAccountNumber}
payout A payment from a wallet to another accounts bank Transfer ACH payment to {displayName}
cash-out Transfer of funds out of a wallet to the account’s bank Transfer Cash out to {bankAccountType} {lastFourAccountNumber}
ach-reversal When an ach payment is returned, funds are either returned or taken from the wallet balance Transfer Returned ACH credit/debit
facilitator-fee Fee earned on a transfer Transfer Facilitator fee collected
card-payment A payment that was made from a card Transfer Card payment from {displayName}
refund When a refund is initiated, the requested refund amount is debited from the wallet Transfer Refund to {displayName}
refund-failure To account for refund failures, a credit will be made back into the wallet Transfer Failed refund to {displayName}
dispute When a customer disputes a charge, the disputed amount is debited from the wallet Dispute Cardholder dispute
dispute-reversal If a dispute is won by a merchant, funds will be credited back to their wallet Dispute Cardholder dispute reversed
issuing-transaction An authorized purchase from a Moov issued card* Issuing Transaction Payment to {Merchant Name}
issuing-auth-release Any funds that were not captured from an authorized purchase from a Moov issued card* will be released Issuing Transaction Authorization release for {Merchant Name}
issuing-transaction-adjustment If an authorized purchase is captured for more or less than the original authorization amount, an adjustment will be made to reflect the difference Issuing Transaction Payment adjustment for {Merchant Name}
issuing-refund A refund on a purchase from a Moov issued card* Issuing Transaction Refund from {Merchant Name}
wallet-transfer Funds that move between Moov wallets Transfer Wallet transfer to/from {displayName}
*Card issuing is currently in a closed beta — ask our Sales team for more information.

Running balance

The available balance at the time of transaction is included on each completed wallet transaction. Note that pending transactions omit the available balance field.

Webhooks

You can subscribe to the walletTransaction.updated webhook event to get real time updates on pending or completed transactions that are created. Below is an example of an event for a completed transaction:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
  "eventID": "14980a04-2e32-4921-a771-4959a36534a6",
  "type": "walletTranscation.updated", 
  "data": {
    "accountID": "51015d0d-8dca-49a0-ba70-abfed073f785",
    "walletID": "51015d0d-8dca-49a0-ba70-abfed073f785",
		"transactionID": "51015d0d-8dca-49a0-ba70-abfed073f785",
    "status": "completed",
		"availableBalance": {
      "currency": "USD", 
      "value": 1204 
    },
  },
  "createdOn": "2021-09-02T13:57:50.762679289Z"
}

Viewing wallet transactions via Moov Dashboard

To view wallet transactions in the Dashboard, you’ll navigate to the wallet for the account you’re interested in:

List view

When you select an individual transaction, you can see more detail as shown below:

Transaction view

Viewing wallet transactions via Moov API

To retrieve wallet transactions through Moov’s API you’ll want to use the following endpoints:

  • List for listing all transactions associated with a wallet
  • Get for accessing a particular wallet transaction.

You’ll need to provide the accountID and walletID of the account and wallet you’re viewing transactions for.

See the API reference for an example of what the listed wallet transactions will look like when you get them via API.