From bbb1c18aa3776a9bd5acc6a958bbb80fa47858a0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A1ssio=20Marcos=20Goulart?= <3228151+CassioMG@users.noreply.github.com> Date: Mon, 22 Apr 2024 15:29:01 -0300 Subject: [PATCH 1/4] SEP-9 : Add 'mobile_number_hash' field to Natural Person Fields --- ecosystem/sep-0009.md | 1 + 1 file changed, 1 insertion(+) diff --git a/ecosystem/sep-0009.md b/ecosystem/sep-0009.md index e50b61cb6..955563e29 100644 --- a/ecosystem/sep-0009.md +++ b/ecosystem/sep-0009.md @@ -65,6 +65,7 @@ top-level key. | `postal_code` | string | Postal or other code identifying user's locale | | `address` | string | Entire address (country, state, postal code, street address, etc...) as a multi-line string | | `mobile_number` | string | Mobile phone number with country code, in E.164 format | +| `mobile_number_hash` | string | Hashed version of a mobile phone number with country code, in E.164 format | | `email_address` | string | Email address | | `birth_date` | date | Date of birth, e.g. `1976-07-04` | | `birth_place` | string | Place of birth (city, state, country; as on passport) | From 20fc7f5b7fb5cd54077b8960e32250b64d1e464e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A1ssio=20Marcos=20Goulart?= <3228151+CassioMG@users.noreply.github.com> Date: Mon, 22 Apr 2024 15:32:02 -0300 Subject: [PATCH 2/4] Update changelog --- ecosystem/sep-0009.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/ecosystem/sep-0009.md b/ecosystem/sep-0009.md index 955563e29..bad4d8f40 100644 --- a/ecosystem/sep-0009.md +++ b/ecosystem/sep-0009.md @@ -6,8 +6,8 @@ Title: Standard KYC Fields Author: stellar.org Status: Active Created: 2018-07-27 -Updated: 2024-03-16 -Version 1.16.0 +Updated: 2024-04-22 +Version 1.17.0 ``` ## Simple Summary @@ -176,6 +176,8 @@ receive. Usually, application would require either `token`, or set of: `number`, ## Changelog +- `v1.17.0`: Add `mobile_number_hash` field to Natural Person Fields + ([#1481](https://github.com/stellar/stellar-protocol/pull/1481)). - `v1.16.0`: Add `external_transfer_memo` field to Financial Account Fields ([#1452](https://github.com/stellar/stellar-protocol/pull/1452)). - `v1.15.0`: Add fields for card details ([#1430](https://github.com/stellar/stellar-protocol/pull/1430)). From 21a20ac82f4f567f35179fa56615cb308906884f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A1ssio=20Marcos=20Goulart?= <3228151+CassioMG@users.noreply.github.com> Date: Tue, 23 Apr 2024 09:22:52 -0300 Subject: [PATCH 3/4] Replace `mobile_number_hash` with `mobile_number_format` --- ecosystem/sep-0009.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ecosystem/sep-0009.md b/ecosystem/sep-0009.md index bad4d8f40..a29125786 100644 --- a/ecosystem/sep-0009.md +++ b/ecosystem/sep-0009.md @@ -64,8 +64,8 @@ top-level key. | `city` | string | name of city/town | | `postal_code` | string | Postal or other code identifying user's locale | | `address` | string | Entire address (country, state, postal code, street address, etc...) as a multi-line string | -| `mobile_number` | string | Mobile phone number with country code, in E.164 format | -| `mobile_number_hash` | string | Hashed version of a mobile phone number with country code, in E.164 format | +| `mobile_number` | string | Mobile phone number with country code, in `E.164` format unless specified differently on `mobile_number_format` field. It could be hashed in case `mobile_number_format` is defined as `hash` | +| `mobile_number_format` | string | Expected format of the `mobile_number` field. E.g.: `E.164`, `hash`, etc... In case this field is not specified, receiver should assume it's in `E.164` format | | `email_address` | string | Email address | | `birth_date` | date | Date of birth, e.g. `1976-07-04` | | `birth_place` | string | Place of birth (city, state, country; as on passport) | @@ -176,7 +176,7 @@ receive. Usually, application would require either `token`, or set of: `number`, ## Changelog -- `v1.17.0`: Add `mobile_number_hash` field to Natural Person Fields +- `v1.17.0`: Add `mobile_number_format` field to Natural Person Fields ([#1481](https://github.com/stellar/stellar-protocol/pull/1481)). - `v1.16.0`: Add `external_transfer_memo` field to Financial Account Fields ([#1452](https://github.com/stellar/stellar-protocol/pull/1452)). From a7c6d7d9e65d202e1c568eabb594b6db10af6a13 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A1ssio=20Marcos=20Goulart?= <3228151+CassioMG@users.noreply.github.com> Date: Tue, 23 Apr 2024 09:35:44 -0300 Subject: [PATCH 4/4] prettier --- ecosystem/sep-0009.md | 70 +++++++++++++++++++++---------------------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/ecosystem/sep-0009.md b/ecosystem/sep-0009.md index a29125786..493415655 100644 --- a/ecosystem/sep-0009.md +++ b/ecosystem/sep-0009.md @@ -54,42 +54,42 @@ top-level key. ## Natural Person Fields -| Name | Type | Description | -| ----------------------------- | ------ | ------------------------------------------------------------------------------------------- | -| `family_name` or `last_name` | string | Family or last name | -| `given_name` or `first_name` | string | Given or first name | -| `additional_name` | string | Middle name or other additional name | -| `address_country_code` | string | country code for current address | -| `state_or_province` | string | name of state/province/region/prefecture | -| `city` | string | name of city/town | -| `postal_code` | string | Postal or other code identifying user's locale | -| `address` | string | Entire address (country, state, postal code, street address, etc...) as a multi-line string | +| Name | Type | Description | +| ----------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `family_name` or `last_name` | string | Family or last name | +| `given_name` or `first_name` | string | Given or first name | +| `additional_name` | string | Middle name or other additional name | +| `address_country_code` | string | country code for current address | +| `state_or_province` | string | name of state/province/region/prefecture | +| `city` | string | name of city/town | +| `postal_code` | string | Postal or other code identifying user's locale | +| `address` | string | Entire address (country, state, postal code, street address, etc...) as a multi-line string | | `mobile_number` | string | Mobile phone number with country code, in `E.164` format unless specified differently on `mobile_number_format` field. It could be hashed in case `mobile_number_format` is defined as `hash` | -| `mobile_number_format` | string | Expected format of the `mobile_number` field. E.g.: `E.164`, `hash`, etc... In case this field is not specified, receiver should assume it's in `E.164` format | -| `email_address` | string | Email address | -| `birth_date` | date | Date of birth, e.g. `1976-07-04` | -| `birth_place` | string | Place of birth (city, state, country; as on passport) | -| `birth_country_code` | string | ISO Code of country of birth | -| `tax_id` | string | Tax identifier of user in their country (social security number in US) | -| `tax_id_name` | string | Name of the tax ID (`SSN` or `ITIN` in the US) | -| `occupation` | number | Occupation ISCO code | -| `employer_name` | string | Name of employer | -| `employer_address` | string | Address of employer | -| `language_code` | string | primary language | -| `id_type` | string | `passport`, `drivers_license`, `id_card`, etc... | -| `id_country_code` | string | country issuing passport or photo ID as ISO 3166-1 alpha-3 code | -| `id_issue_date` | date | ID issue date | -| `id_expiration_date` | date | ID expiration date | -| `id_number` | string | Passport or ID number | -| `photo_id_front` | binary | Image of front of user's photo ID or passport | -| `photo_id_back` | binary | Image of back of user's photo ID or passport | -| `notary_approval_of_photo_id` | binary | Image of notary's approval of photo ID or passport | -| `ip_address` | string | IP address of customer's computer | -| `photo_proof_residence` | binary | Image of a utility bill, bank statement or similar with the user's name and address | -| `sex` | string | `male`, `female`, or `other` | -| `proof_of_income` | binary | Image of user's proof of income document | -| `proof_of_liveness` | binary | video or image file of user as a liveness proof | -| `referral_id` | string | User's origin (such as an id in another application) or a referral code | +| `mobile_number_format` | string | Expected format of the `mobile_number` field. E.g.: `E.164`, `hash`, etc... In case this field is not specified, receiver should assume it's in `E.164` format | +| `email_address` | string | Email address | +| `birth_date` | date | Date of birth, e.g. `1976-07-04` | +| `birth_place` | string | Place of birth (city, state, country; as on passport) | +| `birth_country_code` | string | ISO Code of country of birth | +| `tax_id` | string | Tax identifier of user in their country (social security number in US) | +| `tax_id_name` | string | Name of the tax ID (`SSN` or `ITIN` in the US) | +| `occupation` | number | Occupation ISCO code | +| `employer_name` | string | Name of employer | +| `employer_address` | string | Address of employer | +| `language_code` | string | primary language | +| `id_type` | string | `passport`, `drivers_license`, `id_card`, etc... | +| `id_country_code` | string | country issuing passport or photo ID as ISO 3166-1 alpha-3 code | +| `id_issue_date` | date | ID issue date | +| `id_expiration_date` | date | ID expiration date | +| `id_number` | string | Passport or ID number | +| `photo_id_front` | binary | Image of front of user's photo ID or passport | +| `photo_id_back` | binary | Image of back of user's photo ID or passport | +| `notary_approval_of_photo_id` | binary | Image of notary's approval of photo ID or passport | +| `ip_address` | string | IP address of customer's computer | +| `photo_proof_residence` | binary | Image of a utility bill, bank statement or similar with the user's name and address | +| `sex` | string | `male`, `female`, or `other` | +| `proof_of_income` | binary | Image of user's proof of income document | +| `proof_of_liveness` | binary | video or image file of user as a liveness proof | +| `referral_id` | string | User's origin (such as an id in another application) or a referral code | ## Financial Account Fields