feat(api): add merchant location/service fields, SERVICE_LOCATION authorization attributes

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 190
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-5f3c4878ed085a0e8925abdf14ed250ba25b04d5a128e3edd81f28be5fd79b69.yml
-openapi_spec_hash: f2cc51f780daf0454712a4f73b9c8302
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-7fb459122adaf544433c3d5acd17566e642289b3eccb7ee25d7b7ce418967e32.yml
+openapi_spec_hash: fe69fbb129fa5b7d7b1e71d4f2a908f1
 config_hash: 400b9afe0f7f7b7d96177d05950775f9

lithic-java-core/src/main/kotlin/com/lithic/api/models/AccountActivityListResponse.kt

@@ -1780,14 +1780,15 @@ private constructor(
         private val cardholderAuthentication: JsonField<CardholderAuthentication>,
         private val created: JsonField<OffsetDateTime>,
         private val financialAccountToken: JsonField<String>,
-        private val merchant: JsonField<Merchant>,
+        private val merchant: JsonField<Transaction.TransactionMerchant>,
         private val merchantAmount: JsonField<Long>,
         private val merchantAuthorizationAmount: JsonField<Long>,
         private val merchantCurrency: JsonField<String>,
         private val network: JsonField<Transaction.Network>,
         private val networkRiskScore: JsonField<Long>,
         private val pos: JsonField<Transaction.Pos>,
         private val result: JsonField<Transaction.DeclineResult>,
+        private val serviceLocation: JsonField<Transaction.ServiceLocation>,
         private val settledAmount: JsonField<Long>,
         private val status: JsonField<Transaction.Status>,
         private val tags: JsonField<Transaction.Tags>,
@@ -1835,7 +1836,7 @@ private constructor(
             financialAccountToken: JsonField<String> = JsonMissing.of(),
             @JsonProperty("merchant")
             @ExcludeMissing
-            merchant: JsonField<Merchant> = JsonMissing.of(),
+            merchant: JsonField<Transaction.TransactionMerchant> = JsonMissing.of(),
             @JsonProperty("merchant_amount")
             @ExcludeMissing
             merchantAmount: JsonField<Long> = JsonMissing.of(),
@@ -1855,6 +1856,9 @@ private constructor(
             @JsonProperty("result")
             @ExcludeMissing
             result: JsonField<Transaction.DeclineResult> = JsonMissing.of(),
+            @JsonProperty("service_location")
+            @ExcludeMissing
+            serviceLocation: JsonField<Transaction.ServiceLocation> = JsonMissing.of(),
             @JsonProperty("settled_amount")
             @ExcludeMissing
             settledAmount: JsonField<Long> = JsonMissing.of(),
@@ -1896,6 +1900,7 @@ private constructor(
             networkRiskScore,
             pos,
             result,
+            serviceLocation,
             settledAmount,
             status,
             tags,
@@ -1929,6 +1934,7 @@ private constructor(
                 .networkRiskScore(networkRiskScore)
                 .pos(pos)
                 .result(result)
+                .serviceLocation(serviceLocation)
                 .settledAmount(settledAmount)
                 .status(status)
                 .tags(tags)
@@ -2048,10 +2054,12 @@ private constructor(
             financialAccountToken.getOptional("financial_account_token")
 
         /**
+         * Merchant information including full location details.
+         *
          * @throws LithicInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun merchant(): Merchant = merchant.getRequired("merchant")
+        fun merchant(): Transaction.TransactionMerchant = merchant.getRequired("merchant")
 
         /**
          * Analogous to the 'amount', but in the merchant currency.
@@ -2113,6 +2121,17 @@ private constructor(
          */
         fun result(): Transaction.DeclineResult = result.getRequired("result")
 
+        /**
+         * Where the cardholder received the service, when different from the card acceptor
+         * location. This is populated from network data elements such as Mastercard DE-122 SE1
+         * SF9-14 and Visa F34 DS02.
+         *
+         * @throws LithicInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun serviceLocation(): Optional<Transaction.ServiceLocation> =
+            serviceLocation.getOptional("service_location")
+
         /**
          * The settled amount of the transaction in the settlement currency.
          *
@@ -2291,7 +2310,9 @@ private constructor(
          *
          * Unlike [merchant], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("merchant") @ExcludeMissing fun _merchant(): JsonField<Merchant> = merchant
+        @JsonProperty("merchant")
+        @ExcludeMissing
+        fun _merchant(): JsonField<Transaction.TransactionMerchant> = merchant
 
         /**
          * Returns the raw JSON value of [merchantAmount].
@@ -2361,6 +2382,16 @@ private constructor(
         @ExcludeMissing
         fun _result(): JsonField<Transaction.DeclineResult> = result
 
+        /**
+         * Returns the raw JSON value of [serviceLocation].
+         *
+         * Unlike [serviceLocation], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("service_location")
+        @ExcludeMissing
+        fun _serviceLocation(): JsonField<Transaction.ServiceLocation> = serviceLocation
+
         /**
          * Returns the raw JSON value of [settledAmount].
          *
@@ -2460,6 +2491,7 @@ private constructor(
              * .networkRiskScore()
              * .pos()
              * .result()
+             * .serviceLocation()
              * .settledAmount()
              * .status()
              * .tags()
@@ -2487,14 +2519,15 @@ private constructor(
             private var cardholderAuthentication: JsonField<CardholderAuthentication>? = null
             private var created: JsonField<OffsetDateTime>? = null
             private var financialAccountToken: JsonField<String>? = null
-            private var merchant: JsonField<Merchant>? = null
+            private var merchant: JsonField<Transaction.TransactionMerchant>? = null
             private var merchantAmount: JsonField<Long>? = null
             private var merchantAuthorizationAmount: JsonField<Long>? = null
             private var merchantCurrency: JsonField<String>? = null
             private var network: JsonField<Transaction.Network>? = null
             private var networkRiskScore: JsonField<Long>? = null
             private var pos: JsonField<Transaction.Pos>? = null
             private var result: JsonField<Transaction.DeclineResult>? = null
+            private var serviceLocation: JsonField<Transaction.ServiceLocation>? = null
             private var settledAmount: JsonField<Long>? = null
             private var status: JsonField<Transaction.Status>? = null
             private var tags: JsonField<Transaction.Tags>? = null
@@ -2527,6 +2560,7 @@ private constructor(
                 networkRiskScore = cardTransaction.networkRiskScore
                 pos = cardTransaction.pos
                 result = cardTransaction.result
+                serviceLocation = cardTransaction.serviceLocation
                 settledAmount = cardTransaction.settledAmount
                 status = cardTransaction.status
                 tags = cardTransaction.tags
@@ -2789,16 +2823,20 @@ private constructor(
                 this.financialAccountToken = financialAccountToken
             }
 
-            fun merchant(merchant: Merchant) = merchant(JsonField.of(merchant))
+            /** Merchant information including full location details. */
+            fun merchant(merchant: Transaction.TransactionMerchant) =
+                merchant(JsonField.of(merchant))
 
             /**
              * Sets [Builder.merchant] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.merchant] with a well-typed [Merchant] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
+             * You should usually call [Builder.merchant] with a well-typed
+             * [Transaction.TransactionMerchant] value instead. This method is primarily for setting
+             * the field to an undocumented or not yet supported value.
              */
-            fun merchant(merchant: JsonField<Merchant>) = apply { this.merchant = merchant }
+            fun merchant(merchant: JsonField<Transaction.TransactionMerchant>) = apply {
+                this.merchant = merchant
+            }
 
             /** Analogous to the 'amount', but in the merchant currency. */
             @Deprecated("deprecated")
@@ -2957,6 +2995,29 @@ private constructor(
                 this.result = result
             }
 
+            /**
+             * Where the cardholder received the service, when different from the card acceptor
+             * location. This is populated from network data elements such as Mastercard DE-122 SE1
+             * SF9-14 and Visa F34 DS02.
+             */
+            fun serviceLocation(serviceLocation: Transaction.ServiceLocation?) =
+                serviceLocation(JsonField.ofNullable(serviceLocation))
+
+            /** Alias for calling [Builder.serviceLocation] with `serviceLocation.orElse(null)`. */
+            fun serviceLocation(serviceLocation: Optional<Transaction.ServiceLocation>) =
+                serviceLocation(serviceLocation.getOrNull())
+
+            /**
+             * Sets [Builder.serviceLocation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serviceLocation] with a well-typed
+             * [Transaction.ServiceLocation] value instead. This method is primarily for setting the
+             * field to an undocumented or not yet supported value.
+             */
+            fun serviceLocation(serviceLocation: JsonField<Transaction.ServiceLocation>) = apply {
+                this.serviceLocation = serviceLocation
+            }
+
             /** The settled amount of the transaction in the settlement currency. */
             @Deprecated("deprecated")
             fun settledAmount(settledAmount: Long) = settledAmount(JsonField.of(settledAmount))
@@ -3110,6 +3171,7 @@ private constructor(
              * .networkRiskScore()
              * .pos()
              * .result()
+             * .serviceLocation()
              * .settledAmount()
              * .status()
              * .tags()
@@ -3143,6 +3205,7 @@ private constructor(
                     checkRequired("networkRiskScore", networkRiskScore),
                     checkRequired("pos", pos),
                     checkRequired("result", result),
+                    checkRequired("serviceLocation", serviceLocation),
                     checkRequired("settledAmount", settledAmount),
                     checkRequired("status", status),
                     checkRequired("tags", tags),
@@ -3182,6 +3245,7 @@ private constructor(
             networkRiskScore()
             pos().validate()
             result().validate()
+            serviceLocation().ifPresent { it.validate() }
             settledAmount()
             status().validate()
             tags().validate()
@@ -3229,6 +3293,7 @@ private constructor(
                 (if (networkRiskScore.asKnown().isPresent) 1 else 0) +
                 (pos.asKnown().getOrNull()?.validity() ?: 0) +
                 (result.asKnown().getOrNull()?.validity() ?: 0) +
+                (serviceLocation.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (settledAmount.asKnown().isPresent) 1 else 0) +
                 (status.asKnown().getOrNull()?.validity() ?: 0) +
                 (tags.asKnown().getOrNull()?.validity() ?: 0) +
@@ -3546,6 +3611,7 @@ private constructor(
                 networkRiskScore == other.networkRiskScore &&
                 pos == other.pos &&
                 result == other.result &&
+                serviceLocation == other.serviceLocation &&
                 settledAmount == other.settledAmount &&
                 status == other.status &&
                 tags == other.tags &&
@@ -3579,6 +3645,7 @@ private constructor(
                 networkRiskScore,
                 pos,
                 result,
+                serviceLocation,
                 settledAmount,
                 status,
                 tags,
@@ -3593,6 +3660,6 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "CardTransaction{token=$token, accountToken=$accountToken, acquirerFee=$acquirerFee, acquirerReferenceNumber=$acquirerReferenceNumber, amount=$amount, amounts=$amounts, authorizationAmount=$authorizationAmount, authorizationCode=$authorizationCode, avs=$avs, cardToken=$cardToken, cardholderAuthentication=$cardholderAuthentication, created=$created, financialAccountToken=$financialAccountToken, merchant=$merchant, merchantAmount=$merchantAmount, merchantAuthorizationAmount=$merchantAuthorizationAmount, merchantCurrency=$merchantCurrency, network=$network, networkRiskScore=$networkRiskScore, pos=$pos, result=$result, settledAmount=$settledAmount, status=$status, tags=$tags, tokenInfo=$tokenInfo, updated=$updated, events=$events, family=$family, additionalProperties=$additionalProperties}"
+            "CardTransaction{token=$token, accountToken=$accountToken, acquirerFee=$acquirerFee, acquirerReferenceNumber=$acquirerReferenceNumber, amount=$amount, amounts=$amounts, authorizationAmount=$authorizationAmount, authorizationCode=$authorizationCode, avs=$avs, cardToken=$cardToken, cardholderAuthentication=$cardholderAuthentication, created=$created, financialAccountToken=$financialAccountToken, merchant=$merchant, merchantAmount=$merchantAmount, merchantAuthorizationAmount=$merchantAuthorizationAmount, merchantCurrency=$merchantCurrency, network=$network, networkRiskScore=$networkRiskScore, pos=$pos, result=$result, serviceLocation=$serviceLocation, settledAmount=$settledAmount, status=$status, tags=$tags, tokenInfo=$tokenInfo, updated=$updated, events=$events, family=$family, additionalProperties=$additionalProperties}"
     }
 }