Filing Forms via IRIS

How to File Form 1099-K Through IRIS

Recipient copies are due January 31 and your electronic file is due March 31 — and 1099-K carries reporting quirks, like a monthly payment breakdown, that quietly reject filings if you skip them. Here is the honest, end-to-end path.

At a glance

Form 1099-K reports payment-card and third-party-network transactions, and the entity that settles those payments — the payment settlement entity, or PSE — is the one that must file it. To send it through the IRS Information Returns Intake System (IRIS) you need an active Transmitter Control Code, the recipient amounts broken out month by month so the twelve monthly figures add up to the gross, and a clean payer and recipient TIN. Recipient copies are due January 31 and the electronic file is due March 31. If your deadline is close and you do not yet hold a TCC, a provider that is already authorized can transmit on your behalf today.

In this story

What a 1099-K Actually Reports — and Who Has to File It

Before you build a single record, be clear on who is on the hook, because 1099-K is one of the few information returns where the filer is almost never the business that earned the money. It is filed by the entity that moves the money, not the entity that receives it.

Form 1099-K, titled Payment Card and Third-Party Network Transactions, reports the gross amount of reportable payment transactions a recipient received during the year. There are two kinds of filer the form recognizes, and the schema forces you to declare which one you are. A payment settlement entity — a bank or processor that settles payment-card transactions — reports under the payment-card path, while a third-party settlement organization such as a marketplace or payment app reports under the third-party-network path. The recipient on the form is the merchant or participating payee who got paid; you, the settling entity, are the filer.

This article teaches the direct-to-IRS route in full, as though you were filing it yourself with your own TCC. If you are landing here from the overview of filing the 1099 series through IRIS, this is the form-specific deep dive that page points to. Everything below is grounded in the IRS A2A specification (Publication 5717) and the TY2025 IRIS business-rule catalog, and where a real XML element governs your data, it is named so you can find it.

Official source(s) Pub 5717

The IRIS A2A submission format, the transmission manifest, and the acknowledgement flow described here come from IRS Publication 5717. Who must file, the reporting threshold, and the recipient and filing due dates come from the General Instructions for Certain Information Returns and the form’s own instructions on IRS.gov.

The Reporting Threshold — and Why IRIS Does Not Enforce It

The first question every filer asks is which payees cross the reporting line, and it is worth separating two things that often get conflated. Whether a recipient meets the dollar threshold for the third-party-network path is a question the IRS answers in the General Instructions for Certain Information Returns, and the figure has been phased down in recent tax years, so you should confirm the current amount in the official instructions for the year you are filing rather than relying on a number you remember. The payment-card path has no such floor — card settlements are reportable regardless of amount.

Here is the part that trips people up. IRIS itself does not gate your submission on the threshold. The intake system validates structure and business rules; it does not decide for you who should have received a form. That means the responsibility for applying the threshold correctly sits entirely on your side of the line, before the data ever reaches the IRS. If you over-report, you have created paperwork the recipient must reconcile; if you under-report, the gap is yours to answer for. Decide eligibility against the current-year instructions first, then file only the records that belong on the return.

The Fields IRIS Insists On — Including the One Everyone Forgets

A 1099-K record carries more conditional structure than most 1099s, and the IRIS business rules enforce that structure strictly. The table below lists the core data the recipient detail (Form1099KDetail) requires, what each piece means, and the rule that fires if you get it wrong. Treat the monthly breakdown row as non-negotiable: it is the single most common reason an otherwise valid 1099-K is rejected.

Field (XML element)What it isRule that enforces it
GrossAmtGross amount of reportable transactions for the yearMust equal the sum of the twelve monthly amounts
JanuaryAmtDecemberAmtThe year’s gross split month by monthF1099K001 — the twelve months must sum to GrossAmt
PaymentCardInd / ThirdPartyNetworkIndWhich payment type this record reportsF1099K005 — exactly one must equal “1”
PSEInd / EPFOrOtherThirdPartyIndWhether you file as the PSE or an EPF/other third partyF1099K004 — exactly one must equal “1”
PaymentTransactionCntNumber of payment transactions reportedF1099K026 — a value is required
CardNotPresentTransAmtSubset of gross from card-not-present transactionsF1099K006 — if non-zero, cannot exceed GrossAmt

Two of these deserve a sentence of their own because their logic is easy to miss. The monthly split exists so the IRS can match seasonality and reconcile against the recipient’s records, and IRIS treats any month you leave out as zero — so reporting a gross amount without a complete twelve-month breakdown is not a rounding nuisance, it is a guaranteed failure of rule F1099K001. And if you declare yourself a third party rather than the settling entity by setting EPFOrOtherThirdPartyInd to “1”, the schema then demands the settlement organization’s name and phone under F1099K002, because the IRS needs to know who actually moved the money.

From Clean Data to a Receipt ID, Step by Step

Filing through IRIS A2A is a sequence of discrete moves, and each one has to succeed before the next is meaningful. The goal of the whole exercise is a single artifact: a Receipt ID, which is the IRS’s proof that it accepted your transmission for processing. Treat anything short of a Receipt ID as “not filed yet.”

1

Confirm your TCC and software registration

You cannot transmit without an active Transmitter Control Code, and the form type you send must be authorized for it. The IRIS rules also check your software identifier — the first two digits of your SoftwareId must match the last two digits of the tax year, and a production transmission must use a production-status software ID.

before you start
2

Assemble the 1099-K records

Populate each Form1099KDetail with the recipient’s TIN and name, the gross amount, the complete twelve-month split, the transaction count, and the correct payment-type and filer indicators. Roll the records up into a submission and add a Form1099KTotalAmtGrp so the totals reconcile.

the bulk of the work
3

Pre-validate against the business rules

Run your data against the form rules before you transmit. Catching F1099K001 or a TIN issue on your own desk costs minutes; catching it in an IRS acknowledgement costs a resubmission cycle and, near a deadline, real risk.

5–15 min
4

Transmit and capture the Receipt ID and UTID

Send the transmission to the IRIS intake endpoint. A successful submit returns a Receipt ID; record it, and record the UTID alongside it, because under the TY2025 changes the UTID is the reliable way to re-query and recover a lost Receipt ID without calling the help desk.

minutes
5

Poll for the acknowledgement

Acceptance is asynchronous. Query the status endpoint until IRIS returns an acknowledgement that moves each record to Accepted, Accepted with Errors, or Rejected. Only then do you know the filing landed, and only then can you act on any per-record problems.

varies
Do the math backward from January 31

Recipient copies are due January 31 and your electronic file is due March 31, but those dates are the finish line, not the start. The acknowledgement is asynchronous and a single rejected batch buys you another correct-and-resubmit cycle, so a filer who starts on January 30 has no slack at all. Count backward and give yourself room for at least one round trip.

The State-Filing Catch That Is Specific to 1099-K

Many 1099-series forms can hand their state copies to the IRS through the Combined Federal/State Filing program, where electing CF/SF on the submission forwards the data to participating states for you. 1099-K is the exception you have to plan around: it is excluded from the CF/SF program, so electing it does not satisfy any state that wants the form. If a state requires 1099-K, you file with that state directly — the federal IRIS submission will not do it for you.

Official source(s) Pub 1220

The list of form types eligible for Combined Federal/State Filing — and the exclusions — is published by the IRS in Publication 1220, Part A. Confirm your specific states’ current requirements against their own revenue-department guidance, because direct-state thresholds and due dates are set by each state, not by the IRS.

Common Rejection Reasons (and How to Avoid Them)

Most 1099-K rejections are not exotic; they are the same handful of structural mistakes repeated at volume. Each one sends the record back and costs you a resubmission cycle, so it is worth knowing them by name before you transmit.

Monthly amounts don’t add up to the gross most common

Cause: you reported a GrossAmt but left one or more months blank or mistyped, so the twelve monthly figures do not sum to the gross — IRIS reads every absent month as zero. This trips rule F1099K001. Fix: populate all twelve monthly amounts and reconcile their sum to GrossAmt to the penny before you transmit.

Both payment-type indicators set, or neither

Cause: a record sets both PaymentCardInd and ThirdPartyNetworkInd, or leaves both empty, when the form requires exactly one — the violation of rule F1099K005. The same mutual-exclusivity applies to the filer indicators under F1099K004. Fix: set precisely one indicator in each pair to “1” based on whether you are reporting card settlements or network transactions, and whether you file as the PSE or a third party.

Recipient TIN and name don’t match IRS records

Cause: the recipient’s TIN and name in RecipientDetail do not match the IRS database, which surfaces against the shared name/TIN match rules (SHAREDIRFORM014 for an individual name, SHAREDIRFORM015 for a business name). Fix: run a TIN-matching check before filing and use the legal name exactly as the IRS holds it, not a doing-business-as variant.

Missing PSE name when filing as a third party

Cause: you set EPFOrOtherThirdPartyInd to “1” but did not supply the settlement organization’s name and phone, which rule F1099K002 then requires. Fix: when you file as an electronic payment facilitator or other third party, populate PSENm and PSEPhoneNum so the IRS can identify who settled the payments.

A correction sent without the original’s identifier

Cause: you flagged a record as corrected by setting CorrectedInd to “1” but omitted the UniqueRecordId that ties it to a previously accepted submission — the failure of rule SHAREDIRFORM006_002. Fix: carry the UniqueRecordId from the original accepted record into the correction; conversely, an original (CorrectedInd = “0”) must not carry one.

When a 1099-K Is Wrong After You’ve Filed

Even a clean filing sometimes needs to be amended — a gross figure was overstated, a TIN was wrong, a recipient was reported who should not have been. A correction in IRIS is not a fresh original; it is a record that points back at the one you already filed. You set CorrectedInd to “1” and supply the UniqueRecordId of the accepted original, and the tax year and form type on the correction must match the original or the rules reject it. For the full mechanics across forms, see the dedicated walkthrough on filing corrections through IRIS.

Tired of reconciling twelve monthly amounts by hand?

e1099f builds the 1099-K monthly split, checks every rule from F1099K001 to the TIN match, and transmits through IRIS A2A — so you get a Receipt ID, not a rejection.

See how it works

Skip the Schema Wrangling: The e1099f Advantage

Monthly split, reconciled

The twelve monthly amounts are derived and balanced to the gross automatically, so F1099K001 never fires.

Rules checked first

Every record runs against the IRIS form and shared rules — indicators, TIN match, corrections — before it leaves your account.

Transmit on our TCC

Already authorized for IRIS A2A, so there is no TCC wait between you and a Receipt ID.

A Receipt ID, not a rejection — even for 1099-K’s monthly-split quirks.

Frequently Asked Questions

Who actually files the 1099-K — the business or the payment processor?
The payment settlement entity files it: the bank or processor that settles card transactions, or the third-party settlement organization (like a marketplace or payment app) that settles network transactions. The merchant who got paid is the recipient on the form, not the filer.
What is the reporting threshold for 1099-K?
The dollar threshold for the third-party-network path has been phased down in recent years, so confirm the current figure in the IRS General Instructions for Certain Information Returns for the tax year you are filing. Payment-card settlements have no threshold and are reportable regardless of amount.
Does IRIS enforce the threshold for me?
No. IRIS validates structure and business rules, not eligibility. Deciding which recipients cross the threshold is your responsibility before you file; IRIS will accept whatever records you send.
Why does my 1099-K need a month-by-month breakdown?
The schema collects gross by month so the IRS can reconcile seasonality, and rule F1099K001 requires the twelve monthly amounts to sum to GrossAmt. IRIS treats any missing month as zero, so an incomplete split is a guaranteed rejection.
What are the 1099-K deadlines?
Recipient copies are due January 31 and the electronic file through IRIS is due March 31. Because acceptance is asynchronous and a rejected batch costs another cycle, start well before March 31. See the full 1099 deadline calendar for the surrounding dates.
Can I use Combined Federal/State Filing for 1099-K?
No. 1099-K is excluded from the CF/SF program (Publication 1220, Part A). If a state requires the form, you must file with that state directly; the federal IRIS submission will not forward it.
What does the Receipt ID mean, and what if I lose it?
A Receipt ID is the IRS's confirmation that it accepted your transmission for processing. Under the TY2025 changes, you can re-query by UTID to recover a lost Receipt ID, so capture both when you transmit.
Is a Receipt ID the same as acceptance of every record?
No. A Receipt ID confirms the transmission was received; acceptance of each record arrives later in the asynchronous acknowledgement as Accepted, Accepted with Errors, or Rejected. Poll the status endpoint until you have it.
How do I correct a 1099-K after it's accepted?
Set CorrectedInd to "1" and supply the UniqueRecordId of the accepted original, keeping the same tax year and form type. Omitting the UniqueRecordId on a correction trips rule SHAREDIRFORM006_002.
What's the difference between the PSE and third-party indicators?
Exactly one of PaymentCardInd and ThirdPartyNetworkInd identifies the payment type, and exactly one of PSEInd and EPFOrOtherThirdPartyInd identifies your filer role. Setting both or neither in either pair violates rules F1099K005 and F1099K004.
Do I need to understand any of this XML to file with e1099f?
No. e1099f collects your 1099-K data in plain fields, builds the IRIS XML and the monthly split, runs the business rules, and transmits on its own TCC. The elements and rule IDs in this article are what it handles for you.
DM
Dariel Montesino
Founder, e1099f · Reviewed by a licensed CPA

Dariel writes e1099f’s coverage of the FIRE→IRIS migration and the 1099 series, drawing on IRS Publications 5717–5719, the General Instructions for Certain Information Returns, and hands-on IRIS A2A integration work.

Not tax advice. This is general information about IRS procedures and the IRIS system, which the IRS may change. Reporting thresholds and due dates can vary by tax year; the official IRS publications and instructions are authoritative. Consult a tax professional about your specific situation.

File 1099-K on IRIS — without the rejections. Start free, no credit card.

Monthly split reconciled, every rule checked, transmitted on our TCC. You get a Receipt ID, not a rule code.

An unhandled error has occurred. Reload ×

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.