Finansia Portal

Customer WebApp » Onboarding Foreign »

CRS Question » History » Revision 3

Revision 2 (prin methirattanasophon, 03/02/2026 07:27 AM) → Revision 3/5 (prin methirattanasophon, 03/02/2026 07:28 AM)

# CRS Question 

 Objective: To collect user's Taxpayer Identification Number (TIN) tax information 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