Reference

Enumerations

This page consolidates the business enumerations used by tax information collection APIs so they can be referenced consistently in request parameters, response fields, and status notifications.

Shared DefinitionsTax Info Collection

taxType

Value	Description
TAX1099NEC	1099-NEC reporting

formType

Value	Description
W9	W-9
W8BEN	W-8BEN
W8BENE	W-8BEN-E
W8ECI	W-8ECI
W8EXP	W-8EXP
W8IMY	W-8IMY
UNKNOWN	No form type is specified when the link is created. After visiting the link, the payee chooses from the supported real form types
UNION	Restrict payee form options. Set the available form types via availableFormTypes when creating the link. The payee can only choose from those types.

availableFormTypes

Field	Description
availableFormTypes	Used only when formType=UNION. The value is the list of form types the payee can choose from for this link

Constraints

• Each item must be a real form type from the formType enumeration
• UNKNOWN and UNION are not allowed in availableFormTypes

deliveryMode

Value	Description
LINK	Return the collection link directly and let the merchant distribute it
EMAIL	The platform sends the collection link to the specified email address

formStatus

Value	Description
MISSING	The payee has not submitted tax information yet
PENDING_VERIFICATION	The form has been submitted and verification is in progress
READY	Tax information collection and verification are complete, and downstream business processing can continue, such as allowing withdrawals
FAILED	Verification failed
EXPIRED	Expired