Class SaleToAcquirerDataParser


  • public final class SaleToAcquirerDataParser
    extends Object
    Parses and serializes SaleToAcquirerData objects from/to their wire formats.

    Supports two formats:

    • Base64-encoded JSON: a JSON object encoded as a Base64 string.
    • Key-value pairs: form-encoded pairs using & as separator (e.g. shopperEmail=foo@bar.com&tenderOption=AskGratuity).
    • Method Detail

      • parse

        public static SaleToAcquirerData parse​(String raw)
        Parses a raw SaleToAcquirerData string, auto-detecting the format.
        • If the string is valid Base64 and decodes to a JSON object, it is parsed as JSON.
        • Otherwise it is parsed as form-encoded key-value pairs.
        Parameters:
        raw - The raw SaleToAcquirerData string.
        Returns:
        Parsed SaleToAcquirerData.
      • fromKeyValuePairs

        public static SaleToAcquirerData fromKeyValuePairs​(String keyValuePairs)
        Parses a form-encoded key-value pair string (e.g. shopperEmail=foo@bar.com&tenderOption=AskGratuity) into a SaleToAcquirerData object. Metadata fields use dotted notation: metadata.key=value.
        Parameters:
        keyValuePairs - Form-encoded key-value string using & as separator.
        Returns:
        Parsed SaleToAcquirerData.
      • toBase64

        public static String toBase64​(SaleToAcquirerData data)
        Encodes a SaleToAcquirerData object to a Base64 JSON string.
        Parameters:
        data - The object to encode.
        Returns:
        Base64-encoded JSON representation.