How to record a USDC payment in QuickBooks Online

What has to happen in the books

A customer was invoiced in US dollars and paid by sending USDC to the business's own wallet. Two things have to be true afterwards: the invoice shows as Paid, and the stablecoin the business now holds appears on the balance sheet at a documented USD value. QuickBooks does not see the blockchain, so both have to be recorded by hand or by an integration.

The revenue itself was already recorded when the invoice was raised. The receipt only settles the receivable. Under ASC 606 the consideration on a USD-priced invoice is dollars, so the payment does not change revenue.

Step 1: an account that represents the wallet

QuickBooks needs an account to deposit the payment into. The Payment API accepts a Bank or Other Current Asset account as the deposit account. Two practical points decide between them:

• A Bank type account supports transfers and QuickBooks' own reconciliation screen, and it is the only type (with credit cards) that can carry a foreign currency. A company whose home currency is not USD needs a USD Bank account for the wallet.
• An Other Current Asset account also accepts payments, but it is always carried in the home currency.
• One account per wallet (or per wallet and token) keeps the month-end balance check simple: the ledger balance can be compared with the on-chain balance line by line.

The account name is where the classification shows. Whether the balance is a financial asset, an intangible asset or, in narrow cases, a cash equivalent is a policy the accountant sets. See Is USDC cash? for the views and their sources.

Step 2: record a Payment, not a journal entry

1. 01

   Open Receive payment

   Choose the customer. QuickBooks lists their open invoices.

2. 02

   Tick the invoice it settles

   Enter the USD amount received against INV-101. A partial amount leaves the rest open; an amount above the invoice leaves an unapplied credit on the customer.

3. 03

   Deposit to the wallet account

   Pick the wallet account from Step 1 in Deposit to. Leaving it on Undeposited Funds creates a second step to sweep later.

4. 04

   Date it at the block time

   Use the date of the block that confirmed the transfer. That is when control of the asset passed.

5. 05

   Record the evidence

   Put the full transaction hash in the memo and attach an explorer printout or payment proof PDF.

Through the API the same object is a Payment with a Line.LinkedTxn pointing at the Invoice and DepositToAccountRef set to the wallet account.

Step 3: where the transaction hash goes

Step 4: fees and small differences

When the customer pays the network fee, the payee has nothing to record for it. When the amount received is a few cents short, or the market price at the block was slightly off $1.00, the difference needs a home. Those amounts go in a journal entry with no AR lines, because journals in QuickBooks can post to Bank and Other Current Asset accounts.

In practice the Payment closes the invoice for $10,000 and a separate journal moves $15 from the wallet account to the loss account. Network fees paid by the business itself are covered in Stablecoin network fees.

Step 5: check the closing date first

If the books are closed through a date, QuickBooks refuses entries dated on or before it (through the API the error is 6200 or 6210, "Account Period Closed"). The closing date lives in company settings, BookCloseDate in the API. A receipt that belongs to a closed month is usually recorded in the first open period with a note in both months' workpapers; whether to reopen instead is the reviewer's call.

Doing this for every payment

For one payment, the steps above take a few minutes. The free record a USDC payment tool takes a transaction hash and shows the entries under each treatment. Gladpaid does the same for every receipt: it watches the wallet read-only, matches each transfer to its invoice, and posts the Payment with the hash and proof attached. See Connecting QuickBooks.

This guide describes how published standards and guidance treat these transactions, and where that guidance is unsettled. It is not accounting, tax or legal advice. The treatment for your business is your accountant's decision.