Development environment

The sandbox is an isolated environment for testing and development, without affecting production.

Testnet

UR provides a sandbox environment for integration development and testing.

Base URL: https://urapi2-qa.ur-inc.xyz

KYC data on testnet is mocked. Identity verification results are simulated and do not reflect real compliance outcomes. After completing the KYC flow on testnet, your test users will not be automatically approved — contact [email protected] or your dedicated integration channel to have test accounts manually moved to Live status.

Two API surfaces

UR exposes two API surfaces:

UR-OPEN-API (Partner Server → UR Server)

Server-to-server calls authenticated with your partner wallet signature. Use these for operations that apply to both integration modes:

• Minting URIDs

• Querying user profiles and balances

• Fetching transaction history

Base URL (production): https://openapi.ur.app

UR-API (mode-specific endpoints)

Endpoints specific to your chosen integration mode:

• Managed Custody Mode: Off-ramp, on-ramp, FX, payout, card — all via partner-signed REST calls

• External Wallet Access: User registration, KYC flow, card, off-ramp, on-ramp, FX, payouts

Base URLs (production):

Mode	URL
Managed Custody Mode	https://openapi.ur.app
External Wallet Access	https://api.ur.app

Response format

All endpoints return JSON with this structure:

{
  "code": 0,
  "message": "success",
  "data": { }
}

A code of 0 indicates success. Non-zero codes indicate errors.