Submit Form 1099-K

post

https://{environment}.masspay.io/{VERSION}/payout/{user_token}/tax/form1099k

This POST endpoint is used to submit a Form 1099-K (Payment Card and Third Party Network Transactions) for a specific user identified by their user_token. The 1099-K form is used to report payment card transactions and third-party network transactions to the IRS. Basic information (name, address, email, phone, TIN) is retrieved from the user's existing profile.
To use this endpoint, you need to provide the user_token as a parameter in the URL Path and the 1099-K form data in the request body.

Path Params

user_token

string

required

Body Params

tax_year

string

enum

required

Tax year of the Form 1099-K

Allowed:

supplemental_gross_amount

number

0 to 9999999999.99

Box 1a: Supplemental Gross amount of total reportable payment card/third party network transactions. When provided, this amount will be added to the total amount of payouts and loads (deducting spendbacks) that were initiated in the tax year Either this or gross_amount is required

gross_amount

number

0 to 9999999999.99

Box 1: Gross amount. When provided, this will be the total amount reported. Either this or supplemental_gross_amount is required

merchant_category_code

string

required

length between 4 and 4

Box 2: Four-digit merchant category code (MCC)

number_of_payment_transactions

integer

required

0 to 9999999

Box 3: Number of payment transactions processed

federal_tax_withheld

number

0 to 9999999999.99

Box 4: Federal income tax withheld (backup withholding)

monthly_amounts

object

Box 5a-5l: Monthly breakdown of gross amounts

account_number

string

length between 4 and 20

Account number for reference when multiple 1099-K forms are filed for the same recipient

filer_indicator

string

enum

Type of filer: PSE (Payment Settlement Entity) or EPF (Electronic Payment Facilitator)

Allowed:

transactions_reported_type

string

enum

required

Type of transactions being reported

Allowed:

pse_details

object

Payment Settlement Entity details

state_filing

array of objects

State filing information

state_filing

is_postal

boolean

Defaults to false

When set to true, once the return is transmitted, the 1099-K form copy will be mailed to the recipient's address via USPS.

Note: Postal Orders for Foreign Address will not be created.

email_address

string

Optional email address to receive the tax form link; if provided, the form link will be sent to this address, and if omitted, no email will be sent.

Responses

404

Not Found

200OK

400Bad request.

401Unauthorized.

403Forbidden.

405Method Not Allowed.

500Internal server error.

504Gateway Time-out.