# Test cryptographic authentication

**POST /auth/test-auth**

Test endpoint to verify that a user's cryptographic authentication is working correctly.
This endpoint validates the user's signature and public key.



## Servers
- Production API: https://pay-api.aiic.nz/v1 (Production API)
- Staging API: https://pay-api-staging.aiic.nz/v1 (Staging API)
- Development API: https://pay-api-dev.aiic.nz/v1 (Development API)


## Authentication methods
- Api key auth


## Parameters



### Body: application/json (object)

- **data** (object)
  The actual request data to be processed
- **signature** (string)
  ed25519 signature of the data, signed with user's private key
- **publicKey** (string)
  User's derived public key for signature verification
- **timestamp** (integer)
  Unix timestamp when the request was created (milliseconds)
- **nonce** (string)
  Unique nonce to prevent replay attacks


## Responses
### 200
Authentication test successful

#### Body: application/json (object)
- **success** (boolean)

- **message** (string)

- **userId** (string(uuid))
  ID of the authenticated user
- **publicKey** (string)
  The public key used for authentication

### 401
Authentication failed

#### Body: application/json (object)
- **success** (boolean)

- **error** (string)
  Error message
- **errorCode** (string)
  Machine-readable error code
- **details** (object)
  Additional error details
- **timestamp** (string(date-time))
  When the error occurred

### 429
Rate limit exceeded

### 500
Internal server error


[Powered by Bump.sh](https://bump.sh)