From 30077870a6c2e40ec17608c6d484da3be0293739 Mon Sep 17 00:00:00 2001
From: Sebastian Gil <sgilrodriguez@recurly.com>
Date: Fri, 21 Nov 2025 15:10:31 -0500
Subject: [PATCH] Accept vertex_transaction_type

---
 .../ning/billing/recurly/model/Purchase.java  | 18 +++-
 .../billing/recurly/model/TestPurchase.java   | 89 ++++++++++++++++++-
 2 files changed, 105 insertions(+), 2 deletions(-)

diff --git a/src/main/java/com/ning/billing/recurly/model/Purchase.java b/src/main/java/com/ning/billing/recurly/model/Purchase.java
index a58692f6..18078ba6 100644
--- a/src/main/java/com/ning/billing/recurly/model/Purchase.java
+++ b/src/main/java/com/ning/billing/recurly/model/Purchase.java
@@ -88,6 +88,9 @@ public class Purchase extends RecurlyObject {
     @XmlElement(name = "transaction_type")
     private String transactionType;
 
+    @XmlElement(name = "vertex_transaction_type")
+    private String vertexTransactionType;
+
     @XmlList
     @XmlElementWrapper(name = "coupon_codes")
     @XmlElement(name = "coupon_code")
@@ -245,6 +248,14 @@ public void setTransactionType(final Object transactionType) {
         this.transactionType = stringOrNull(transactionType);
     }
 
+    public String getVertexTransactionType() {
+        return vertexTransactionType;
+    }
+
+    public void setVertexTransactionType(final Object vertexTransactionType) {
+        this.vertexTransactionType = stringOrNull(vertexTransactionType);
+    }
+
     @Override
     public String toString() {
         final StringBuilder sb = new StringBuilder();
@@ -268,6 +279,7 @@ public String toString() {
         sb.append(", shippingAddressId='").append(shippingAddressId).append('\'');
         sb.append(", gatewayCode='").append(gatewayCode).append('\'');
         sb.append(", transactionType='").append(transactionType).append('\'');
+        sb.append(", vertexTransactionType='").append(vertexTransactionType).append('\'');
         sb.append('}');
         return sb.toString();
     }
@@ -333,6 +345,9 @@ public boolean equals(final Object o) {
         if (transactionType != null ? !transactionType.equals(purchase.transactionType) : purchase.transactionType != null) {
             return false;
         }
+        if (vertexTransactionType != null ? !vertexTransactionType.equals(purchase.vertexTransactionType) : purchase.vertexTransactionType != null) {
+            return false;
+        }
         if (vatReverseChargeNotes != null ? !vatReverseChargeNotes.equals(purchase.vatReverseChargeNotes) : purchase.vatReverseChargeNotes != null) {
             return false;
         }
@@ -361,7 +376,8 @@ public int hashCode() {
                 billingInfoUuid,
                 shippingAddressId,
                 gatewayCode,
-                transactionType
+                transactionType,
+                vertexTransactionType
         );
     }
 
diff --git a/src/test/java/com/ning/billing/recurly/model/TestPurchase.java b/src/test/java/com/ning/billing/recurly/model/TestPurchase.java
index afd99ce3..20d0134c 100644
--- a/src/test/java/com/ning/billing/recurly/model/TestPurchase.java
+++ b/src/test/java/com/ning/billing/recurly/model/TestPurchase.java
@@ -207,7 +207,94 @@ public void testSerializationWithBillingInfoUuid() throws Exception {
 
     public void verifyPurchaseWithBillingInfoUuid(final Purchase purchase) {
         assertEquals(purchase.getBillingInfoUuid(), "iiznlrvdt8py");
-  }
+    }
+
+    @Test(groups = "fast")
+    public void testSerializationWithVertexTransactionType() throws Exception {
+        final String purchaseData = "<purchase xmlns=\"\">" +
+                "<currency>USD</currency>" +
+                "  <collection_method>automatic</collection_method>" +
+                "  <vertex_transaction_type>rental</vertex_transaction_type>" +
+                "  <account>" +
+                "    <account_code>test</account_code>" +
+                "    <billing_info>" +
+                "      <first_name>Benjamin</first_name>" +
+                "      <last_name>Du Monde</last_name>" +
+                "      <address1>400 Alabama St</address1>" +
+                "      <city>San Francisco</city>" +
+                "      <state>CA</state>" +
+                "      <zip>94110</zip>" +
+                "      <country>US</country>" +
+                "      <year type=\"integer\">2019</year>" +
+                "      <month type=\"integer\">12</month>" +
+                "      <number>4000-0000-0000-0000</number>" +
+                "    </billing_info>" +
+                "  </account>" +
+                "  <adjustments>" +
+                "    <adjustment>" +
+                "      <unit_amount_in_cents type=\"integer\">1000</unit_amount_in_cents>" +
+                "      <quantity type=\"integer\">1</quantity>" +
+                "      <currency>USD</currency>" +
+                "      <product_code>product-code</product_code>" +
+                "    </adjustment>" +
+                "  </adjustments>" +
+                "</purchase>";
+
+        // test serialization
+        final Purchase purchase = xmlMapper.readValue(purchaseData, Purchase.class);
+        verifyPurchaseWithVertexTransactionType(purchase);
+
+        // test deseralization
+        final Purchase purchaseExpected = xmlMapper.readValue(purchaseData, Purchase.class);
+        assertEquals(purchase, purchaseExpected);
+    }
+
+    public void verifyPurchaseWithVertexTransactionType(final Purchase purchase) {
+        assertEquals(purchase.getVertexTransactionType(), "rental");
+        assertEquals(purchase.getCurrency(), "USD");
+        assertEquals(purchase.getCollectionMethod(), "automatic");
+    }
+
+    @Test(groups = "fast")
+    public void testSerializationToXmlWithVertexTransactionType() throws Exception {
+        // Create purchase object programmatically and verify it serializes correctly to XML
+        final Purchase purchase = new Purchase();
+        purchase.setCurrency("USD");
+        purchase.setCollectionMethod("automatic");
+        purchase.setVertexTransactionType("lease");
+
+        final Account account = new Account();
+        account.setAccountCode("test-account");
+        purchase.setAccount(account);
+
+        // Serialize to XML string
+        final String xml = xmlMapper.writeValueAsString(purchase);
+
+        // Verify the XML contains the vertex_transaction_type element
+        assert xml.contains("<vertex_transaction_type>lease</vertex_transaction_type>") :
+            "Serialized XML should contain vertex_transaction_type element";
+        assert xml.contains("<collection_method>automatic</collection_method>");
+        assert xml.contains("<currency>USD</currency>");
+    }
+
+    @Test(groups = "fast")
+    public void testVertexTransactionTypeAllValidValues() throws Exception {
+        // Test all valid values: sale, rental, lease
+        final String[] validValues = {"sale", "rental", "lease"};
+
+        for (String value : validValues) {
+            final Purchase purchase = new Purchase();
+            purchase.setVertexTransactionType(value);
+            assertEquals(purchase.getVertexTransactionType(), value,
+                "Should correctly set and get value: " + value);
+
+            // Verify serialization/deserialization round-trip
+            final String xml = xmlMapper.writeValueAsString(purchase);
+            final Purchase deserializedPurchase = xmlMapper.readValue(xml, Purchase.class);
+            assertEquals(deserializedPurchase.getVertexTransactionType(), value,
+                "Should correctly deserialize value: " + value);
+        }
+    }
 
     @Test(groups = "fast")
     public void testHashCodeAndEquality() throws Exception {