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.
Customer Decisions Schemas
API endpoints for monitoring customer authorization decisions and billing permissions.
Endpoints
| Method | Endpoint | Description |
|---|
| GET | /v1/merchant/customer-decisions | Get customer decisions with filters |
| GET | /v1/customer-decisions/:id | Get specific customer decision by ID |
GET /v1/merchant/customer-decisions
Retrieve customer decisions with optional filtering parameters.
Query Parameters
| Parameter | Type | Required | Description |
|---|
agreementPhrase | string | No | Filter by agreement phrase |
customerId | string | No | Filter by customer ID |
lookupPhrase | string | No | Filter by lookup phrase |
limit | number | No | Number of results to return |
skip | number | No | Number of results to skip |
Response Schema
{
"statusCode": 200,
"success": true,
"data": [
{
"id": "string",
"customerId": "string",
"entityId": "string",
"agreementPhrase": "string",
"decision": "approve_once | approve_recurring | deny | suspended",
"spendingLimits": {
"single": 5000,
"daily": 8000,
"weekly": 20000,
"monthly": 60000
},
"blockMerchant": false,
"createdAt": "string",
"lastUsed": "string"
}
],
"total": 1
}
Customer Decision Schema
| Field | Type | Description |
|---|
id | string | Decision identifier |
customerId | string | Customer identifier |
entityId | string | Merchant identifier |
agreementPhrase | string | Encrypted agreement phrase |
decision | string | Customer decision type |
spendingLimits | object | Customer spending limits |
spendingLimits.single | number | Single transaction limit |
spendingLimits.daily | number | Daily spending limit |
spendingLimits.weekly | number | Weekly spending limit |
spendingLimits.monthly | number | Monthly spending limit |
blockMerchant | boolean | Whether merchant is blocked |
createdAt | string | Decision creation timestamp |
lastUsed | string | Last usage timestamp |
GET /v1/customer-decisions/:id
Get detailed information about a specific customer decision.
Path Parameters
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Customer decision ID |
Response Schema
{
"statusCode": 200,
"success": true,
"data": {
"id": "string",
"customerId": "string",
"entityId": "string",
"agreementPhrase": "string",
"lookupPhrase": "string",
"decision": "approve_once | approve_recurring | deny | suspended",
"spendingLimits": {
"single": 5000,
"daily": 8000,
"weekly": 20000,
"monthly": 60000
},
"blockMerchant": false,
"createdAt": "string",
"lastUpdated": "string",
"lastUsed": "string"
}
}
Decision Types
| Decision | Description |
|---|
approve_once | Customer approves each transaction individually |
approve_recurring | Automatic approval for future transactions |
deny | Customer declined billing agreement |
suspended | Decision is temporarily suspended |
Error Responses
404 Not Found
{
"statusCode": 404,
"success": false,
"message": "Customer decision not found"
}
400 Bad Request
{
"statusCode": 400,
"success": false,
"message": "Invalid query parameters"
}
