Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-248286406.8 KB
Tax

Submit Form 1099-K

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 reports payment card and third-party network transactions. Basic information (name, address, email, phone, TIN) is retrieved from the user's existing profile.

post/payout/{user_token}/tax/form1099k

Request body

tax_year'2023' | '2024' | '2025' required

Tax year of the Form 1099-K

supplemental_gross_amountnumber

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_amountnumber

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

merchant_category_codestring required

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

number_of_payment_transactionsinteger required

Box 3: Number of payment transactions processed

federal_tax_withheldnumber

Box 4: Federal income tax withheld (backup withholding)

account_numberstring

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

filer_indicator'PSE' | 'EPF'

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

transactions_reported_type'Payment_Card' | 'Third_Party_Network' required

Type of transactions being reported

is_postalboolean

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_addressstring email

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.

Response

OK

submission_idstring uuid

Unique identifier for the submission

form_type'1099-K'

Type of form submitted

tax_yearstring

Tax year of the submission

status'Created' | 'Pending' | 'Validated' | 'Error'

Current status of the submission

submitted_atstring date-time

Timestamp of submission

pdf_contentstring

Base64 encoded byte representing the content of the file

gross_amountstring

Total gross amount reported. This amount includes the total payouts through MassPay in addition to the supplemental gross amount provided.