Getting Started
Architecture
System Overview
EFRIX sits between client applications and URA's EFRIS infrastructure, providing a simplified REST API while handling all cryptographic operations and protocol complexities.
Request Flow
Security Architecture
Authentication
All API requests require:
X-EFRIX-API-Key: efrix_live_abc123
X-EFRIX-API-Secret: sk_live_xyz789
Encryption Layers
| Layer | Technology | Purpose |
|---|---|---|
| Transport | TLS 1.3 | Client ↔ EFRIX communication |
| Payload | AES-256 | EFRIX ↔ URA data encryption |
| Signing | RSA/PKI | URA request authentication |
Key Management
- API keys stored hashed (bcrypt)
- PKI certificates rotated per URA requirements
- AES keys refreshed daily (T104 interface)
Data Flow
Environments
| Environment | Base URL | Purpose |
|---|---|---|
| Production | gateway.tarifix.xtellar.app/efrix/v1 | Live transactions |
| Sandbox | gateway.tarifix.xtellar.app/efrix/v1/sandbox | Testing |
Sandbox uses URA's test environment and does not affect live tax records.