MAmasspay
Tax

Request Postal Mailing for Tax Form

Changed on

This POST endpoint is used to enable postal mailing for a tax form (1099-K, 1099-NEC, or 1099-MISC) that has already been transmitted to the IRS. The form is identified by its submission_id, and the form type is detected automatically. A $1.80 USD postal mailing fee is charged per successful request. Postal mailing can be requested multiple times for the same submission (e.g., for re-prints) — each request incurs the fee. <br><br> Note: Postal orders can only be created for forms that have been transmitted. For forms not yet transmitted, set is_postal: true on the PUT (update) endpoint instead.

post/payout/{user_token}/tax/postal

Request

Request body

submission_idstring required

The submission ID of the transmitted form (works for 1099-K, 1099-NEC, and 1099-MISC)

Example request

{
  "submission_id": "2bcaf185-199f-4827-b095-9cb4e64ad721"
}

Response

OK

submission_idstring

The submission ID the postal order was created for

record_idstring

The record ID

tax_form'1099K' | '1099NEC' | '1099MISC'

The form type detected from the submission

postal_statusstring

Status of the postal order (e.g., 'Order Created')

postal_status_tsstring

Timestamp when the postal order was created

infostring

Additional information about the postal order

feenumber

Postal mailing fee charged for this request

currencystring

Currency of the fee

is_reprintboolean

True when postal was already enabled for this submission and this request is a re-print

Example response

{
  "fee": 1.8,
  "currency": "USD"
}

Changes