Get Started

Set up environments, authentication, webhooks, and a basic Tax Filing integration flow.

Environment and authentication

EnvironmentRequest URLPurpose
Sandboxhttps://sandbox-api.onerway.com/taxTesting and integration
Productionhttps://api.onerway.com/taxLive business

Integration information

ItemPurpose
Merchant NoIdentifies the merchant
ApiKeyAuthenticates API requests
Webhook SecretValidates webhook signatures

Pass ApiKey in the request header. For complete authentication details, see the Authentication GuideTax API.

Unified response structure

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": { ... }
}

Webhook integration

See the Webhook Integration GuideTax API for the complete specification.

  • Signature rule: HMAC-SHA256(webhook_secret, x-timestamp + "." + rawBody)
  • Retry policy: 3 retries on failure after 1 minute, 5 minutes, and 15 minutes
  • Receipt rule: return any 2xx response after the webhook is successfully handled

Overview

Onerway's built-in tax compliance solution covering the complete 1099-NEC tax form collection, TIN verification, and IRS filing process.

Payee Tax Information Form Types

Understand which tax form applies to each payee type and when a payee enters the 1099 workflow.