Documentation Index
Fetch the complete documentation index at: https://docs.peere.network/llms.txt
Use this file to discover all available pages before exploring further.
Merchant Trust Management Schemas
API endpoints for establishing and managing merchant trust levels and capabilities.
Endpoints
| Method | Endpoint | Description |
|---|
| PATCH | /v1/provider/merchant/trust | Update merchant trust settings |
| GET | /v1/provider/merchant/trust | Verify merchant trust status |
| GET | /v1/provider/merchant/trust/multiple | List merchants with trust filters |
| GET | /v1/provider/merchant/trust/device-permission | Check device lookup permission |
| POST | /v1/provider/merchant/trust/validate | Validate trust level for operation |
PATCH /v1/provider/merchant/trust
Update trust settings for a merchant to enable advanced features.
Request Body
{
"entityId": "string",
"trusted": true,
"trustLevel": "basic | enhanced | premium",
"deviceLookupEnabled": true
}
Request Schema
| Field | Type | Required | Description |
|---|
entityId | string | Yes | Merchant entity identifier |
trusted | boolean | Yes | Whether merchant is trusted |
trustLevel | string | No | Trust level (basic, enhanced, premium) |
deviceLookupEnabled | boolean | No | Enable device lookup capability |
Response Schema
{
"statusCode": 200,
"success": true,
"message": "Merchant trust updated successfully",
"data": {
"trusted": true,
"trustLevel": "premium",
"deviceLookupEnabled": true
}
}
GET /v1/provider/merchant/trust
Verify current trust status for a merchant.
Query Parameters
| Parameter | Type | Required | Description |
|---|
entityId | string | Yes | Merchant entity identifier |
Response Schema
{
"statusCode": 200,
"success": true,
"data": {
"entityId": "string",
"trusted": true,
"trustLevel": "premium",
"deviceLookupEnabled": true,
"lastVerified": "string"
}
}
GET /v1/provider/merchant/trust/multiple
List merchants with trust level filters.
Query Parameters
| Parameter | Type | Required | Description |
|---|
trusted | boolean | No | Filter by trust status |
trustLevel | string | No | Filter by trust level |
deviceLookupEnabled | boolean | No | Filter by device lookup capability |
limit | number | No | Number of results to return |
offset | number | No | Number of results to skip |
Response Schema
{
"statusCode": 200,
"success": true,
"data": [
{
"entityId": "string",
"entityName": "string",
"trusted": true,
"trustLevel": "premium",
"deviceLookupEnabled": true,
"lastVerified": "string"
}
],
"total": 1
}
GET /v1/provider/merchant/trust/device-permission
Check if merchant has permission for device lookup operations.
Query Parameters
| Parameter | Type | Required | Description |
|---|
entityId | string | Yes | Merchant entity identifier |
Response Schema
{
"statusCode": 200,
"allowed": true,
"reason": "string",
"trustStatus": {
"trusted": true,
"trustLevel": "premium",
"deviceLookupEnabled": true,
"lastVerified": "string"
}
}
POST /v1/provider/merchant/trust/validate
Validate if merchant meets required trust level for specific operations.
Request Body
{
"entityId": "string",
"requiredTrustLevel": "basic | enhanced | premium"
}
Request Schema
| Field | Type | Required | Description |
|---|
entityId | string | Yes | Merchant entity identifier |
requiredTrustLevel | string | Yes | Required trust level for operation |
Response Schema
{
"statusCode": 200,
"success": true,
"data": {
"currentTrustLevel": "premium",
"valid": true
}
}
Trust Levels
| Level | Description | Capabilities |
|---|
basic | Standard payment processing | Basic billing operations |
enhanced | Additional capabilities | Device lookup, higher limits |
premium | Full feature access | Recurring billing, priority support |
Trust Status Schema
| Field | Type | Description |
|---|
entityId | string | Merchant identifier |
trusted | boolean | Whether merchant is trusted |
trustLevel | string | Current trust level |
deviceLookupEnabled | boolean | Device lookup capability |
lastVerified | string | Last verification timestamp |
Error Responses
400 Bad Request
{
"statusCode": 400,
"success": false,
"message": "Invalid trust level specified"
}
403 Forbidden
{
"statusCode": 403,
"success": false,
"message": "Insufficient permissions to modify trust level"
}
404 Not Found
{
"statusCode": 404,
"success": false,
"message": "Merchant not found"
}
