CRS Question » History » Version 5
prin methirattanasophon, 03/04/2026 02:05 AM
| 1 | 1 | prin methirattanasophon | # CRS Question |
|---|---|---|---|
| 2 | |||
| 3 | 4 | prin methirattanasophon | Objective: To collect Taxpayer Identification Number (TIN) for non US person. |
| 4 | 1 | prin methirattanasophon | |
| 5 | Page Route: /authentication/signup/foreign/crs |
||
| 6 | |||
| 7 | Data soure: Query prarams |
||
| 8 | |||
| 9 | ``` |
||
| 10 | /authentication/signup/foreign/crs?verifyid={verifyid}&fail={fail} |
||
| 11 | |||
| 12 | ``` |
||
| 13 | |||
| 14 | |key|type|value| |
||
| 15 | |--|--|--| |
||
| 16 | |verifyid|string|uuid| |
||
| 17 | |fail|string|true\|false| |
||
| 18 | |||
| 19 | |||
| 20 | Sequence diagram: |
||
| 21 | |||
| 22 | 5 | prin methirattanasophon | <img style="width: 602px;" src="clipboard-202603040904-weqvc.png"><br> |
| 23 | |||
| 24 | 1 | prin methirattanasophon | ``` |
| 25 | @startuml crs |
||
| 26 | title CRS Question Flow |
||
| 27 | |||
| 28 | actor "user" as u |
||
| 29 | participant "frontend" as f |
||
| 30 | participant "backend" as b |
||
| 31 | participant "appman" as a |
||
| 32 | database "database" as db |
||
| 33 | |||
| 34 | group "Appman result" |
||
| 35 | u -> f: access CRS question page |
||
| 36 | f -> b: POST: /onboarding/foreign/appman/idcard/result |
||
| 37 | b -> a: get appman result |
||
| 38 | a --> b: |
||
| 39 | b->db: save appman result |
||
| 40 | db-->b: |
||
| 41 | b --> f: appman result |
||
| 42 | end |
||
| 43 | |||
| 44 | group "CRS question submission" |
||
| 45 | u->f: submit CRS question form |
||
| 46 | f->b: POST: /onboarding/foreign/crs |
||
| 47 | b->db: save CRS question |
||
| 48 | db-->b: |
||
| 49 | b-->f: success |
||
| 50 | f-->u: redirect to basic info page |
||
| 51 | end |
||
| 52 | |||
| 53 | @enduml |
||
| 54 | |||
| 55 | ``` |
||
| 56 | |||
| 57 | --- |
||
| 58 | |||
| 59 | API Appman Result: |
||
| 60 | |||
| 61 | Objective: To retrieve verification result from appman |
||
| 62 | |||
| 63 | |||
| 64 | |header|value| |
||
| 65 | |--|--| |
||
| 66 | |endpoint|/onboarding/foreign/appman/idcard/result| |
||
| 67 | |method|POST| |
||
| 68 | |||
| 69 | Request: |
||
| 70 | |key|type|value| |
||
| 71 | |--|--|--| |
||
| 72 | |verify_id|string|appman verification id| |
||
| 73 | |verified|bool|appman fail status| |
||
| 74 | |||
| 75 | |||
| 76 | Response: 200 |
||
| 77 | |||
| 78 | --- |
||
| 79 | |||
| 80 | API Submission: |
||
| 81 | |||
| 82 | Objective: To save CRS question |
||
| 83 | |||
| 84 | |||
| 85 | |header|value| |
||
| 86 | |--|--| |
||
| 87 | |endpoint|/onboarding/foreign/crs| |
||
| 88 | |method|POST| |
||
| 89 | |||
| 90 | Request: |
||
| 91 | |key|type|value| |
||
| 92 | |--|--|--| |
||
| 93 | |member_id|string|member id| |
||
| 94 | |step|int|1120| |
||
| 95 | |crs|array|object| |
||
| 96 | 2 | prin methirattanasophon | |crs.country_tax_residence|string|tax residence country code| |
| 97 | 1 | prin methirattanasophon | |crs.is_tax_not_usa|bool|| |
| 98 | |crs.is_tin|bool|| |
||
| 99 | |crs.tin|string|Taxpayer Identification Number (TIN)| |
||
| 100 | |||
| 101 | |||
| 102 | Response: 200 |