Overview

NRS Tax Compliance Gateway

Real-time tax assessment and settlement for blockchain transactions.

View API Reference

Overview

The NRS Tax Compliance Gateway (TCG) enables Virtual Asset Service Providers (VASPs) to calculate, manage, and settle tax liabilities for blockchain transactions. Built on jurisdiction-specific tax rules, TCG delivers real-time tax assessments across supported blockchain networks — automating compliance obligations so VASPs can focus on building.

Key Features

• Real-Time Tax Assessment: Instantly calculate applicable taxes (e.g., Levy, VAT) for individual transactions based on jurisdiction-specific rules.
• Batch Processing: Submit high-volume transaction files for bulk assessment creation — ideal for end-of-day or periodic reconciliation.
• Assessment Lifecycle Management: Track each assessment from creation through confirmation to full settlement.
• Acknowledgement Controls: Confirm or reject draft assessments — cancel transactions that fail before they become tax liabilities.
• Reference Data: Query supported blockchain networks and digital assets to ensure accurate assessment inputs.
• Secure Authentication: All endpoints are protected with JWT bearer tokens obtained via OAuth2 Client Credentials flow.

Assessment Lifecycle

Each tax assessment moves through a defined status lifecycle:

Status	Description
DRAFT	Newly created — awaiting VASP confirmation or rejection
DUE	Confirmed by the VASP; payment is expected
REJECTED	Cancelled by the VASP (e.g., the underlying transaction failed)
VOIDED	Cancelled by the system
PARTIALLY_PAID	Some payment received; a balance remains outstanding
PAID	Fully settled
EXPIRED	Payment window elapsed without settlement

Common Use Cases

• Exchange Transactions — Calculate levy and VAT on crypto-to-crypto or crypto-to-fiat exchanges.
• Transfers — Assess tax on outbound or inbound blockchain transfers.
• Batch Reconciliation — Upload end-of-period transaction files for bulk assessment processing.
• Compliance Automation — Automatically confirm assessments as part of your transaction approval workflow.

Getting Started

1. Authenticate — Obtain a bearer token using your clientId and clientSecret via POST /auth/v1/token.
2. Query Reference Data — Retrieve valid blockchain and asset codes from the Reference Data endpoints.
3. Create an Assessment — Submit transaction details to create a DRAFT assessment with calculated tax amounts.
4. Acknowledge — Confirm the assessment if the transaction proceeds, or reject it if cancelled.
5. Track Settlement — Monitor assessment status as payments progress toward PAID.