POST /taxForm/v1/api/link — Full DocumentationTax API
| Field | Type | Required | Description |
|---|---|---|---|
merchantRefId | string | Yes | Payee identifier in the merchant's system |
taxType | string | Yes | Filing type, for example TAX1099NEC |
formType | string | No | Form type, default UNKNOWN |
deliveryMode | string | No | Delivery method, default LINK |
recipientEmail | string | No | Payee email, required in EMAIL mode |
GET /taxForm/v1/api/detail — Full DocumentationTax API
| Field | Type | Required | Description |
|---|---|---|---|
merchantRefId | string | Yes | Payee identifier in the merchant's system |
taxType | string | Yes | Filing type |
Triggered statuses: READY, FAILED, and EXPIRED. No notification is sent for PENDING_VERIFICATION.
{
"requestId": "1987654321123456789",
"eventType": "tax.form.status.change",
"createdAt": "2026-04-27 17:20:31",
"version": "v1.0",
"data": {
"merchantNo": "10001",
"merchantRefId": "user_12345",
"taxType": "TAX1099NEC",
"formType": "W9",
"formStatus": "READY",
"submitTime": "2026-04-27 17:18:01"
}
}