Activate a feature

Once you've verified that a customer is eligible for a feature, you can activate it for their account. Some features require additional provider data during activation.

Activate a feature

Use the Activate a feature endpoint to enable a feature for a customer. The request requires the customer_id, feature_id, and optionally provider_data:

curl --request POST \
     --url https://api.gravv.xyz/v1/risk/features/activate \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: 979879887678789_attempt_1' \
     --header 'content-type: application/json' \
     --data '
{
  "customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
  "feature_id": "USD Account",
  "provider_data": {
    "annual_remuneration": 120000,
    "estimated_monthly_limit": 5000,
    "ip_address": "192.168.1.100",
    "account_id": "5d9e677f-f071-4881-a861-7cdcebacd9d5"
  }
}
'

You will receive a confirmation response:

{
  "data": {
    "activated_at": "2026-01-09T10:29:16.000Z",
    "customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
    "feature_id": "USD Account",
    "status": "active"
  },
  "error": null
}

Provider data requirements

The provider_data object contains feature-specific information required for activation. The fields needed depend on the feature you're activating.

curl --request POST \
     --url https://api.gravv.xyz/v1/risk/features/activate \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: activate_001' \
     --header 'content-type: application/json' \
     --data '
{
  "customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
  "feature_id": "USD Account"
}
'

Liveness check requirement

When activating features, the system checks if the customer has completed their liveness verification. If they haven't completed the liveness check, the response includes a websdk_url field that directs them to complete the verification:

{
  "data": {
    "customer_id": "302dabcb-d4fd-4a00-a80b-afad70982614",
    "feature_id": "USD Account",
    "status": "active",
    "websdk_url": "https://verify.gravv.xyz/liveness/abc123xyz"
  },
  "error": null
}

Use this URL to redirect the customer to complete their liveness verification before they can activate the feature.