Stringify Application Selection Registered Proprietary Data (field 9F0A)

This field contains proprietary data identified by registered
identifiers. Even if the identifier is know, the data remains
proprietary.

Author: leonlynch

src/emv_fields.h

@@ -2,7 +2,7 @@
  * @file emv_fields.h
  * @brief EMV field definitions and helper functions
  *
- * Copyright (c) 2021, 2022, 2023 Leon Lynch
+ * Copyright (c) 2021-2024 Leon Lynch
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -152,6 +152,12 @@ __BEGIN_DECLS
 #define EMV_ADDL_TERM_CAPS_OUTPUT_CODE_TABLE_2                  (0x02) ///< Terminal Data Output Capability: Code table 2
 #define EMV_ADDL_TERM_CAPS_OUTPUT_CODE_TABLE_1                  (0x01) ///< Terminal Data Output Capability: Code table 1
 
+// Application Selection Registered Proprietary Data (field 9F0A)
+// See EMV 4.4 Book 1, 12.5
+// See https://www.emvco.com/registered-ids/
+#define EMV_ASRPD_ECSG                                          (0x0001) ///< European Cards Stakeholders Group
+#define EMV_ASRPD_TCEA                                          (0x0002) ///< Technical Cooperation ep2 Association
+
 // Application Interchange Profile (field 82) byte 1
 // See EMV 4.4 Book 3, Annex C1, Table 41
 // See EMV Contactless Book C-2 v2.10, Annex A.1.16

src/emv_strings.c

@@ -523,6 +523,18 @@ int emv_tlv_get_info(
 			info->format = EMV_FORMAT_B;
 			return 0;
 
+		case EMV_TAG_9F0A_ASRPD:
+			info->tag_name = "Application Selection Registered Proprietary Data (ASRPD)";
+			info->tag_desc =
+				"Proprietary data allowing for proprietary processing during "
+				"application selection. Proprietary data is identified using "
+				"Proprietary Data Identifiers that are managed by EMVCo and "
+				"their usage by the Application Selection processing is "
+				"according to their intended usage, as agreed by EMVCo during "
+				"registration.";
+			info->format = EMV_FORMAT_B;
+			return emv_asrpd_get_string_list(tlv->value, tlv->length, value_str, value_str_len);
+
 		case EMV_TAG_9F0D_ISSUER_ACTION_CODE_DEFAULT:
 			info->tag_name = "Issuer Action Code (IAC) - Default";
 			info->tag_desc =
@@ -2124,6 +2136,74 @@ int emv_aid_get_string(
 	return 0;
 }
 
+int emv_asrpd_get_string_list(
+	const uint8_t* asrpd,
+	size_t asrpd_len,
+	char* str,
+	size_t str_len
+)
+{
+	struct str_itr_t itr;
+
+
+	if (!asrpd || !asrpd_len) {
+		return -1;
+	}
+
+	if (!str || !str_len) {
+		// Caller didn't want the value string
+		return 0;
+	}
+
+	if (asrpd_len < 3) {
+		// Application Selection Registered Proprietary Data (ASRPD) must
+		// contain at least one ID and a length
+		return 1;
+	}
+
+	emv_str_list_init(&itr, str, str_len);
+
+	// Application Selection Registered Proprietary Data (ASRPD)
+	// See EMV 4.4 Book 1, 12.5
+	// See https://www.emvco.com/registered-ids/
+	while (asrpd_len) {
+		uint16_t asrpd_id;
+		size_t asrpd_entry_len;
+
+		if (asrpd_len < 3) {
+			// Incomplete ASRPD entry
+			return 2;
+		}
+
+		asrpd_id = (asrpd[0] << 8) + asrpd[1];
+		switch (asrpd_id) {
+			case EMV_ASRPD_ECSG:
+				emv_str_list_add(&itr, "European Cards Stakeholders Group");
+				break;
+
+			case EMV_ASRPD_TCEA:
+				emv_str_list_add(&itr, "Technical Cooperation ep2 Association");
+				break;
+
+			default:
+				emv_str_list_add(&itr, "Unknown ASRPD identifier");
+		}
+
+		// Validate entry length
+		asrpd_entry_len = 2 + 1 + asrpd[2];
+		if (asrpd_entry_len > asrpd_len) {
+			// Invalid ASRPD length
+			return 3;
+		}
+
+		// Advance
+		asrpd += asrpd_entry_len;
+		asrpd_len -= asrpd_entry_len;
+	}
+
+	return 0;
+}
+
 int emv_aip_get_string_list(
 	const uint8_t* aip,
 	size_t aip_len,

src/emv_strings.h

@@ -329,6 +329,22 @@ int emv_aid_get_string(
 	size_t str_len
 );
 
+/**
+ * Stringify Application Selection Registered Proprietary Data (field 9F0A)
+ * @note Strings in output buffer are delimited using "\n", including the last string
+ * @param asrpd Application Selection Registered Proprietary Data (ASRPD) field.
+ * @param asrpd_len Length of Application Selection Registered Proprietary Data (ASRPD) field.
+ * @param str String buffer output
+ * @param str_len Length of string buffer in bytes
+ * @return Zero for success. Less than zero for internal error. Greater than zero for parse error.
+ */
+int emv_asrpd_get_string_list(
+	const uint8_t* asrpd,
+	size_t asrpd_len,
+	char* str,
+	size_t str_len
+);
+
 /**
  * Stringify Application Interchange Profile (field 82)
  * @note Strings in output buffer are delimited using "\n", including the last string

src/emv_tags.h

@@ -5,7 +5,7 @@
  * @remark See EMV 4.4 Book 3, Annex A
  * @remark See ISO 7816-4:2005, 5.2.4
  *
- * Copyright (c) 2021, 2022, 2023 Leon Lynch
+ * Copyright (c) 2021-2024 Leon Lynch
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -196,6 +196,9 @@ __BEGIN_DECLS
 /// EMV tag 9F09 Application Version Number - terminal
 #define EMV_TAG_9F09_APPLICATION_VERSION_NUMBER_TERMINAL        (0x9F09)
 
+/// EMV tag 9F0A Application Selection Registered Proprietary Data (ASRPD)
+#define EMV_TAG_9F0A_ASRPD                                      (0x9F0A)
+
 /// EMV tag 9F0D Issuer Action Code (IAC) - Default. Template 70 or 77.
 #define EMV_TAG_9F0D_ISSUER_ACTION_CODE_DEFAULT                 (0x9F0D)