Authentication Data Set (Secure Add to Wallet)

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

Note:Some authentication values are logically structured (object/array) but may need to be transmitted as JSON serialized into a string depending on integration constraints.

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
Note:
  • After parsing, sim MUST be a JSON array of SIM objects.
  • sim array length SHOULD NOT exceed 8.
  • isPrimary SHOULD be true for at most one entry (recommended).

[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"}"
Note:The Auth Type identifies the authentication method, while the serialized JSON payload may contain method-specific keys (e.g., sa uses account, token uses x-access-token).

AltStyle によって変換されたページ (->オリジナル) /