MerchantTokenUsageMetadata

Metadata about where and how to retrieve the latest usage information.

Declaration

object MerchantTokenUsageMetadata

Properties

Name	Type	Description
`ciphersuite` Required	string	The cipher suite used for HPKE in authorization mode. Use the value sent as `supportedCiphersuite` in the `Retrieve MerchantToken PublicKey API` response.
`data` Required	string	Metadata encyrpted using the merchant token public key.
`ephemeralPublicKey` Required	string	The ephemeral public key in X9.63 representation, Base64-encoded.
`infoHash` Required	string	A SHA-256 digest of the `info`, hex-encoded.
`merchantPublicKey` Required	string	The `merchantPublicKey` in X9.63 representation, Base64-encoded.
`merchantTokenPublicKeyHash` Required	string	An SHA-256 digest of the `merchantTokenPublicKey`, hex-encoded.

Discussion

The merchantPublicKey includes encrypted metadata. When decrypted, you get a data JSON object that contains the webServiceURL of the merchant server, which hosts the usage information, and an opaque authenticationToken. The user’s devices present the authenticationToken when retrieving the latest usage information from the merchant server. This allows the merchant server to authenticate these requests.