Finansia Portal

# CRS Question

Objective: To collect user's Taxpayer Identification Number (TIN) for non US person.

Page Route: /authentication/signup/foreign/crs

Data soure: Query prarams

```

/authentication/signup/foreign/crs?verifyid={verifyid}&fail={fail}

```

|key|type|value|

|--|--|--|

|verifyid|string|uuid|

|fail|string|true\|false|

Sequence diagram:

```

@startuml crs

title CRS Question Flow

actor "user" as u

participant "frontend" as f

participant "backend" as b

participant "appman" as a

database "database" as db

group "Appman result"

u -> f: access CRS question page

f -> b: POST: /onboarding/foreign/appman/idcard/result

b -> a: get appman result

a --> b:

b->db: save appman result

db-->b:

b --> f: appman result

end

group "CRS question submission"

u->f: submit CRS question form

f->b: POST: /onboarding/foreign/crs

b->db: save CRS question

db-->b:

b-->f: success

f-->u: redirect to basic info page

end

@enduml

```

---

API Appman Result:

Objective: To retrieve verification result from appman

|header|value|

|--|--|

|endpoint|/onboarding/foreign/appman/idcard/result|

|method|POST|

Request:

|key|type|value|

|--|--|--|

|verify_id|string|appman verification id|

|verified|bool|appman fail status|

Response: 200

---

API Submission:

Objective: To save CRS question

|header|value|

|--|--|

|endpoint|/onboarding/foreign/crs|

|method|POST|

Request:

|key|type|value|

|--|--|--|

|member_id|string|member id|

|step|int|1120|

|crs|array|object|

|crs.country_tax_residence|string|tax residence country code|

|crs.is_tax_not_usa|bool||

|crs.is_tin|bool||

|crs.tin|string|Taxpayer Identification Number (TIN)|

Response: 200