Add Customer Requirement¶
Overview¶
Use the AddCustomerRequirement endpoint to add specific verification requirements for individual customers. This
allows
you to request additional data or attestations from a customer beyond what your policy rules automatically require.
Endpoint¶
POST https://api.brij.fi/brij.core.v1.partner.Service/AddCustomerRequirement
Request Body¶
{
"customerId": "cust_abc123xyz",
"maxAgeDays": 365,
"attestation": "VALIDATED_ID_DOCUMENT"
}
Or for data requirements:
{
"customerId": "cust_abc123xyz",
"maxAgeDays": 90,
"data": "RESIDENTIAL_ADDRESS"
}
Request Parameters¶
| Field | Type | Required | Description |
|---|---|---|---|
customerId |
string | Yes | Unique identifier for the customer |
maxAgeDays |
integer | No | Maximum age in days for the requirement to be considered valid |
data |
string | No1 | Type of data to request (see Data Types) |
attestation |
string | No1 | Type of attestation to request (see Attestation Types) |
Data Types¶
Request raw data from the customer. For the full list of supported data types, see Data Types.
Attestation Types¶
Request verified attestations from the customer. For the full list of supported attestation types, see Attestation Types.
Response¶
{
"requirementId": "req_xyz789abc"
}
| Field | Type | Description |
|---|---|---|
requirementId |
string | Unique identifier for the created requirement |
Error Responses¶
| Status Code | Description |
|---|---|
400 |
Invalid request parameters |
401 |
Invalid or missing API key |
404 |
Customer or partner not found |
500 |
Internal server error |
Examples¶
Example 1: Request ID Document Verification¶
Request a verified identity document from a customer:
{
"customerId": "cust_abc123xyz",
"maxAgeDays": 365,
"attestation": "VALIDATED_ID_DOCUMENT"
}
Example 2: Request Proof of Address¶
Request residential address data:
{
"customerId": "cust_abc123xyz",
"maxAgeDays": 90,
"data": "RESIDENTIAL_ADDRESS"
}
Example 3: Request AML Check¶
Request an anti-money laundering verification:
{
"customerId": "cust_abc123xyz",
"maxAgeDays": 30,
"attestation": "AML_CHECK"
}
Example 4: Request Source of Funds¶
Request source of funds documentation:
{
"customerId": "cust_abc123xyz",
"maxAgeDays": 180,
"data": "SOURCE_OF_FUNDS"
}
Example 5: Request Liveness Check¶
Request a liveness verification to confirm the customer is a real person:
{
"customerId": "cust_abc123xyz",
"maxAgeDays": 365,
"attestation": "LIVENESS_CHECK"
}