Activate a feature
Activate a specific feature for a customer. You must provide the feature_id and any required provider_data as specified in the feature's requirements.
Headers
Required for POST requests. Reuse only for an identical retry.
Request Body
ID of the customer activating the feature
ID of the feature to activate
Possible values: crypto_wallet, virtual_cards, eur_account, usd_account, gbp_account, international_transfers
Additional data required by the feature provider
Request Examples
{
"customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
"feature_id": "virtual_cards",
"provider_data": {
"annual_remuneration": 12000,
"estimated_monthly_limit": 200,
"ip_address": "12.23.31.23",
"account_id": "5d9e677f-f071-4881-a861-7cdcebacd9d5"
}
}
{
"customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
"feature_id": "crypto_wallet"
}
{
"feature_id": "international_transfers",
"customer_id": "cust_123456",
"provider_data": {
"compliance_check": "approved",
"country_whitelist": [
"US",
"GB",
"CA"
]
}
}
Responses
| Status | Description |
|---|---|
200 |
Feature activated successfully |
401 |
Unauthorized - Invalid or missing API key |
403 |
Forbidden - Customer not eligible |
404 |
Feature or customer not found |
200 response
Timestamp when the feature was activated
ID of the customer for whom the feature was activated
ID of the activated feature
Possible values: crypto_wallet, virtual_cards, eur_account, usd_account, gbp_account, international_transfers
Current status of the feature
Error message, if any
{
"data": {
"activated_at": "2026-01-09T10:29:16.000Z",
"customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
"feature_id": "virtual_cards",
"status": "active"
},
"error": null
}
{
"data": {
"customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
"feature_id": "virtual_cards",
"status": "active",
"websdk_url": "https://verify.gravv.xyz/liveness/abc123xyz"
},
"error": null
}
401 response
Always null for error responses
Human-readable error message
{
"data": null,
"error": "Invalid or missing Api-Key header. Api-Key is required!"
}
403 response
Always null for error responses
Human-readable error message
{
"data": null,
"error": "Customer does not meet eligibility requirements"
}
404 response
Always null for error responses
Human-readable error message
{
"data": null,
"error": "Feature not found"
}
Authorization
- ApiKeyAuth