Contents

GetMerchantTokenUsageInformationPackageResponse

The encrypted merchant token usage information package.

Declaration

object GetMerchantTokenUsageInformationPackageResponse

Properties

NameTypeDescription
ciphersuite Requiredstring

The cipher suite used for HPKE in authorization mode. Use the value sent as supportedCiphersuite in the Retrieve MerchantToken PublicKey API response.

data Requiredstring

The encrypted merchant token usage information package.

ephemeralPublicKey Requiredstring

The ephemeral public key in X9.63 representation, Base64-encoded.

infoHash Requiredstring

A SHA-256 digest of the info, hex-encoded.

merchantPublicKeyHash Requiredstring

An SHA-256 digest of the merchantPublicKey, hex-encoded.

merchantTokenPublicKeyHash Requiredstring

An SHA-256 digest of the merchantTokenPublicKey, hex-encoded.

Mentioned in

Discussion

The data needs to be a merchant token usage information package encrypted to the merchantTokenPublicKey using HPKE in authorization mode with merchantPrivateKey and the following options:

Option

Value

KEM

DHKEM(P-384, HKDF-SHA384)

KDF

HKDF-SHA384

AEAD

AES-256-GCM

The merchantPrivateKey needs to correspond to the merchantPublicKey provided in the merchant token usage information availability notification. The info parameter needs to be the UTF-8 bytes of ApplePayMerchantTokenUsageInformation_1.0 concatenated with the SHA-256 digest (in bytes) of the merchantTokenIdentifier (encoded using UTF-8). For the ciphersuite, use the supportedCiphersuite returned by Apple in the Retrieve Merchant Token Public Key.

See Also

Merchant token usage information