CRS Question » History » Version 4
prin methirattanasophon, 03/02/2026 07:29 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 | ``` |
||
| 23 | @startuml crs |
||
| 24 | title CRS Question Flow |
||
| 25 | |||
| 26 | actor "user" as u |
||
| 27 | participant "frontend" as f |
||
| 28 | participant "backend" as b |
||
| 29 | participant "appman" as a |
||
| 30 | database "database" as db |
||
| 31 | |||
| 32 | group "Appman result" |
||
| 33 | u -> f: access CRS question page |
||
| 34 | f -> b: POST: /onboarding/foreign/appman/idcard/result |
||
| 35 | b -> a: get appman result |
||
| 36 | a --> b: |
||
| 37 | b->db: save appman result |
||
| 38 | db-->b: |
||
| 39 | b --> f: appman result |
||
| 40 | end |
||
| 41 | |||
| 42 | group "CRS question submission" |
||
| 43 | u->f: submit CRS question form |
||
| 44 | f->b: POST: /onboarding/foreign/crs |
||
| 45 | b->db: save CRS question |
||
| 46 | db-->b: |
||
| 47 | b-->f: success |
||
| 48 | f-->u: redirect to basic info page |
||
| 49 | end |
||
| 50 | |||
| 51 | @enduml |
||
| 52 | |||
| 53 | ``` |
||
| 54 | |||
| 55 | --- |
||
| 56 | |||
| 57 | API Appman Result: |
||
| 58 | |||
| 59 | Objective: To retrieve verification result from appman |
||
| 60 | |||
| 61 | |||
| 62 | |header|value| |
||
| 63 | |--|--| |
||
| 64 | |endpoint|/onboarding/foreign/appman/idcard/result| |
||
| 65 | |method|POST| |
||
| 66 | |||
| 67 | Request: |
||
| 68 | |key|type|value| |
||
| 69 | |--|--|--| |
||
| 70 | |verify_id|string|appman verification id| |
||
| 71 | |verified|bool|appman fail status| |
||
| 72 | |||
| 73 | |||
| 74 | Response: 200 |
||
| 75 | |||
| 76 | --- |
||
| 77 | |||
| 78 | API Submission: |
||
| 79 | |||
| 80 | Objective: To save CRS question |
||
| 81 | |||
| 82 | |||
| 83 | |header|value| |
||
| 84 | |--|--| |
||
| 85 | |endpoint|/onboarding/foreign/crs| |
||
| 86 | |method|POST| |
||
| 87 | |||
| 88 | Request: |
||
| 89 | |key|type|value| |
||
| 90 | |--|--|--| |
||
| 91 | |member_id|string|member id| |
||
| 92 | |step|int|1120| |
||
| 93 | |crs|array|object| |
||
| 94 | 2 | prin methirattanasophon | |crs.country_tax_residence|string|tax residence country code| |
| 95 | 1 | prin methirattanasophon | |crs.is_tax_not_usa|bool|| |
| 96 | |crs.is_tin|bool|| |
||
| 97 | |crs.tin|string|Taxpayer Identification Number (TIN)| |
||
| 98 | |||
| 99 | |||
| 100 | Response: 200 |