NRI Flagging

The NRI (Non-Resident Indian) flag is a user-level attribute that helps Saber Money correctly apply operational logic such as TDS handling. This flag must be explicitly set after user onboarding and KYC completion, and only if the user's KYC country is not India.


When to Flag a User as NRI

Flagging a user as NRI should be done at the appropriate point in the user lifecycle:

StepActionis_nri Flag
1User creatednull or false by default
2KYC initiatedCannot flag as NRI
3KYC completed
4If kyc_country ≠ IndiaSet is_nri = true
5If kyc_country = IndiaNRI flagging not allowed

Important Rules:

  • You cannot flag a user as NRI before KYC is completed.
  • You cannot flag a user as NRI if their KYC country is India.

How to Flag a User as NRI

Once the user has completed KYC and their KYC country is not India, you can flag them as NRI using the following API call.

Sample Request (cURL)

curl --location --request PUT 'https://mudrex.com/api/v1/user/client_user' \
--header 'X-Timestamp: 1747292173' \
--header 'X-Client-Id: xxxxx' \
--header 'X-Secret-Key: xxxxx' \
--header 'X-Request-Id: 123456789876' \
--header 'X-User-Id: xxxx' \
--header 'Content-Type: application/json' \
--data '{
    "is_nri":true
}'

Why NRI Flagging Matters

Flagging users as NRI enables Saber Money to apply different compliance and taxation rules and other operations, such as TDS calculations, and ensures appropriate reporting based on the user's residency status.