API Introduction

Review tax information collection endpoints, request fields, and webhook payloads.

POST /taxForm/v1/api/link — Full Documentation

FieldTypeRequiredDescription
merchantRefIdstringYesPayee identifier in the merchant's system
taxTypestringYesFiling type, for example TAX1099NEC
formTypestringNoForm type, default UNKNOWN
deliveryModestringNoDelivery method, default LINK
recipientEmailstringNoPayee email, required in EMAIL mode

Query Form Information

GET /taxForm/v1/api/detail — Full Documentation

FieldTypeRequiredDescription
merchantRefIdstringYesPayee identifier in the merchant's system
taxTypestringYesFiling type

Status Change Webhook

Full Documentation

Triggered statuses: READY, FAILED, and EXPIRED. No notification is sent for PENDING_VERIFICATION.

{
  "requestId": "REPLACE_WITH_YOUR_REQUEST_ID",
  "eventType": "tax.form.status.change",
  "createdAt": "2026-04-27 17:20:31",
  "version": "v1.0",
  "data": {
    "merchantNo": "REPLACE_WITH_YOUR_MERCHANT_NO",
    "merchantRefId": "user_12345",
    "taxType": "TAX1099NEC",
    "formType": "W9",
    "formStatus": "READY",
    "submitTime": "2026-04-27 17:18:01"
  }
}