Add support for passing level III data when creating a charge

src/Stripe.Tests.XUnit/charges/_fixture.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 
 namespace Stripe.Tests.Xunit
 {
@@ -13,6 +14,7 @@ public class charges_fixture : IDisposable
         public StripeCharge UpdatedCharge { get; set; }
         public StripeCharge UncapturedCharge { get; set; }
         public StripeCharge CapturedCharge { get; set; }
+        public StripeCharge Level3Charge { get; set; }
 
         public charges_fixture()
         {
@@ -46,6 +48,38 @@ public charges_fixture()
                 StatementDescriptor = "CapturedCharge"
             };
             CapturedCharge = service.Capture(UncapturedCharge.Id, ChargeCaptureOptions);
+
+            // Create a charge with Level 3 data
+            var chargeLevel3Options = Cache.GetStripeChargeCreateOptions();
+            chargeLevel3Options.Amount = 11700;
+            chargeLevel3Options.Level3 = new StripeChargeLevel3Options
+            {
+                MerchantReference = "1234",
+                ShippingAddressZip = "94110",
+                ShippingAmount = 700,
+                LineItems = new List<StripeChargeLevel3LineItemOptions>
+                {
+                    new StripeChargeLevel3LineItemOptions
+                    {
+                        DiscountAmount = 200,
+                        ProductCode = "1234",
+                        ProductDescription = "description 1",
+                        Quantity = 2,
+                        TaxAmount = 200,
+                        UnitCost = 1000,
+                    },
+                    new StripeChargeLevel3LineItemOptions
+                    {
+                        DiscountAmount = 300,
+                        ProductCode = "1235",
+                        ProductDescription = "description 2",
+                        Quantity = 3,
+                        TaxAmount = 300,
+                        UnitCost = 3000,
+                    },
+                },
+            };
+            Level3Charge = service.Create(chargeLevel3Options);
         }
 
         public void Dispose() { }

src/Stripe.Tests.XUnit/charges/creating_updating_and_capturing_charges.cs

@@ -106,5 +106,10 @@ public void captured_is_captured_with_right_settings()
             Assert.Equal(fixture.CapturedCharge.Amount - fixture.CapturedCharge.AmountRefunded, fixture.ChargeCaptureOptions.Amount);
         }
 
+        [Fact]
+        public void charge_level3_is_not_null()
+        {
+            fixture.Level3Charge.Should().NotBeNull();
+        }
     }
 }

src/Stripe.net/Entities/StripeCharge.cs

@@ -237,6 +237,13 @@ internal object InternalOrder
         }
         #endregion
 
+        /// <summary>
+        /// Details about the level III data associated with the Charge.
+        /// This is a gated property and most integrations can not access it.
+        /// </summary>
+        [JsonProperty("level3")]
+        public StripeChargeLevel3 Level3 { get; set; }
+
         /// <summary>
         /// Details about whether the payment was accepted, and why.
         /// </summary>

src/Stripe.net/Entities/StripeChargeLevel3.cs

@@ -0,0 +1,20 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Stripe
+{
+    public class StripeChargeLevel3 : StripeEntity
+    {
+        [JsonProperty("line_items")]
+        public List<StripeChargeLevel3LineItem> LineItems { get; set; }
+
+        [JsonProperty("merchant_reference")]
+        public string MerchantReference { get; set; }
+
+        [JsonProperty("shipping_address_zip")]
+        public string ShippingAddressZip { get; set; }
+
+        [JsonProperty("shipping_amount")]
+        public int ShippingAmount { get; set; }
+    }
+}

src/Stripe.net/Entities/StripeChargeLevel3LineItem.cs

@@ -0,0 +1,25 @@
+using Newtonsoft.Json;
+
+namespace Stripe
+{
+    public class StripeChargeLevel3LineItem : StripeEntity
+    {
+        [JsonProperty("discount_amount")]
+        public int? DiscountAmount { get; set; }
+
+        [JsonProperty("product_code")]
+        public string ProductCode { get; set; }
+
+        [JsonProperty("product_description")]
+        public string ProductDescription { get; set; }
+
+        [JsonProperty("quantity")]
+        public int? Quantity { get; set; }
+
+        [JsonProperty("tax_amount")]
+        public int? TaxAmount { get; set; }
+
+        [JsonProperty("unit_cost")]
+        public int? UnitCost { get; set; }
+    }
+}

src/Stripe.net/Infrastructure/Middleware/ParserPlugin/ChargeLevel3Plugin.cs

@@ -0,0 +1,40 @@
+using System.Collections.Generic;
+using System.Linq;
+using System.Reflection;
+using Newtonsoft.Json;
+
+namespace Stripe.Infrastructure.Middleware
+{
+    internal class ChargeLevel3Plugin : IParserPlugin
+    {
+        public bool Parse(ref string requestString, JsonPropertyAttribute attribute, PropertyInfo property, object propertyValue, object propertyParent)
+        {
+            if (attribute.PropertyName != "charge_level3_line_items_array") return false;
+
+            var items = ((List<StripeChargeLevel3LineItemOptions>) property.GetValue(propertyParent, null));
+
+            var itemIndex = 0;
+            foreach (var item in items)
+            {
+                var properties = item.GetType().GetRuntimeProperties();
+
+                foreach (var prop in properties)
+                {
+                    var value = prop.GetValue(item, null);
+                    if (value == null) continue;
+
+                    // it must have a json attribute matching stripe's key, and only one
+                    var attr = prop.GetCustomAttributes<JsonPropertyAttribute>().SingleOrDefault();
+                    if (attr == null) continue;
+
+                    RequestStringBuilder.ApplyParameterToRequestString(ref requestString,
+                        $"level3[line_items][{itemIndex}][{attr.PropertyName}]", value.ToString());
+                }
+
+                itemIndex++;
+            }
+
+            return true;
+        }
+    }
+}

src/Stripe.net/Infrastructure/Middleware/RequestStringBuilder.cs

@@ -26,7 +26,8 @@ static RequestStringBuilder()
                 new PlanTiersPlugin(),
                 new SubscriptionItemPlugin(),
                 new SubscriptionItemUpdatedPlugin(),
-                new InvoiceSubscriptionItemPlugin()
+                new InvoiceSubscriptionItemPlugin(),
+                new ChargeLevel3Plugin()
             };
         }
 

src/Stripe.net/Services/Charges/StripeChargeCreateOptions.cs

@@ -51,6 +51,12 @@ public class StripeChargeCreateOptions : StripeBaseOptions, ISupportMetadata
         [JsonProperty("exchange_rate")]
         public decimal? ExchangeRate { get; set; }
 
+        /// <summary>
+        /// Extra information about the charge passing level III data to card networks
+        /// </summary>
+        [JsonProperty("level3")]
+        public StripeChargeLevel3Options Level3 { get; set; }
+
         /// <summary>
         /// A string that identifies this transaction as part of a group. See the Connect documentation for details.
         /// </summary>

src/Stripe.net/Services/Charges/StripeChargeLevel3LineItemOptions.cs

@@ -0,0 +1,25 @@
+using Newtonsoft.Json;
+
+namespace Stripe
+{
+    public class StripeChargeLevel3LineItemOptions : INestedOptions
+    {
+        [JsonProperty("discount_amount")]
+        public int? DiscountAmount { get; set; }
+
+        [JsonProperty("product_code")]
+        public string ProductCode { get; set; }
+
+        [JsonProperty("product_description")]
+        public string ProductDescription { get; set; }
+
+        [JsonProperty("quantity")]
+        public int? Quantity { get; set; }
+
+        [JsonProperty("tax_amount")]
+        public int? TaxAmount { get; set; }
+
+        [JsonProperty("unit_cost")]
+        public int? UnitCost { get; set; }
+    }
+}

src/Stripe.net/Services/Charges/StripeChargeLevel3Options.cs

@@ -0,0 +1,22 @@
+using Newtonsoft.Json;
+using System.Collections.Generic;
+
+namespace Stripe
+{
+    public class StripeChargeLevel3Options : INestedOptions
+    {
+        // this will actually send `line_items`. this is to flag it for the middleware
+        // to process it as a plugin
+        [JsonProperty("charge_level3_line_items_array")]
+        public List<StripeChargeLevel3LineItemOptions> LineItems { get; set; }
+
+        [JsonProperty("level3[merchant_reference]")]
+        public string MerchantReference { get; set; }
+
+        [JsonProperty("level3[shipping_address_zip]")]
+        public string ShippingAddressZip { get; set; }
+
+        [JsonProperty("level3[shipping_amount]")]
+        public int ShippingAmount { get; set; }
+    }
+}