Authentication Data Set (Secure Add to Wallet)

This section defines the authentication data format used to authenticate the user during card registration/update flows.


Authentication Types

This subsection enumerates supported authentication types and the required payload format for each type.

Authentication Types (JSON serialized as String)

Type

 Description
ci
String(128)

 Connecting Information
Identifier of identity verification agency.
sa
String(254)

 Samsung Account
Verifies that the signed-in Samsung account on the device matches.
sim
String(1024)

 Subscriber Identity Module
Verifies SIM information used on the device.
otp
String(16)

 One-Time Password
Verifies partner-provided OTP by user input during Secure Add.
token
String(512)

 Access Token
Key used when querying a partner server; may be reissued on updates.

Encoding rule (normative)

  • Each authentication value SHALL be provided as a string containing a JSON document (UTF-8), due to integration constraints (“string-only” input).
  • The serialized JSON string MUST be valid JSON after unescaping.
  • Producers SHOULD minify JSON to reduce length.
  • Consumers SHOULD parse and validate the JSON schema prior to use.
  • Producers MUST NOT double-escape manually; the enclosing JSON serializer will escape as needed.

[Logical schema after parsing sim JSON string]

Type

 Description
uiccid
String(32)

 (Required)
ICCID.
telno
String(32)

 (Required)
Phone number
isPrimary
Boolean

 (Required)
Primary SIM indicator

[Examples]

Auth Type

 Sample Value (escaped JSON string)
ci

 "authentication":"{"ci":"HSD0IUF9BEW8UGB7WQEU6I"}"
sa

 "authentication":"{"account":"samsungwallet@samsung.com"}"
sim

 "authentication":"[{"uiccid":"ABCDERWYT","telno":"821012345678","isPrimary":true},"uiccid":"ABCDERWYS","telno":"01012345679","isPrimary":false}]"
otp

 "authentication":"{"otp":"947253"}"
token

 "authentication":"{"x-access-token":"7C8D38690D0E3B6AA077198ABD2554A3A7940B52CF86BD690C1"}"