From 36fd4e7c734fd6219779ee1c405f23a4ceae409e Mon Sep 17 00:00:00 2001
From: avinashp-plivo <avinash.p@plivo.com>
Date: Mon, 27 Jul 2026 12:20:58 +0530
Subject: [PATCH] feat(tollfree-verification): support 4 new optional Zipwhip
 TF fields

Adds the following optional parameters to the toll-free verification
create and update APIs:

  terms_and_conditions_link
  privacy_policy_link
  optin_message
  help_message

All four are optional and backward compatible; existing callers are
unaffected. Mirrors the corresponding porter API change.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 .../TollfreeVerificationCreator.java          | 40 ++++++++++++++
 .../TollfreeVerificationUpdater.java          | 40 ++++++++++++++
 .../plivo/api/TollfreeVerificationTest.java   | 55 +++++++++++++++++++
 3 files changed, 135 insertions(+)

diff --git a/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationCreator.java b/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationCreator.java
index e09a7386..a8eda207 100644
--- a/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationCreator.java
+++ b/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationCreator.java
@@ -16,6 +16,10 @@ public class TollfreeVerificationCreator extends Creator<TollfreeVerificationCre
   private String volume;
   private String additionalInformation;
   private String extraData;
+  private String termsAndConditionsLink;
+  private String privacyPolicyLink;
+  private String optinMessage;
+  private String helpMessage;
   private String callbackUrl;
   private String callbackMethod;
 
@@ -119,6 +123,42 @@ public TollfreeVerificationCreator extraData(final String extraData) {
     return this;
   }
 
+  public String termsAndConditionsLink() {
+    return termsAndConditionsLink;
+  }
+
+  public TollfreeVerificationCreator termsAndConditionsLink(final String termsAndConditionsLink) {
+    this.termsAndConditionsLink = termsAndConditionsLink;
+    return this;
+  }
+
+  public String privacyPolicyLink() {
+    return privacyPolicyLink;
+  }
+
+  public TollfreeVerificationCreator privacyPolicyLink(final String privacyPolicyLink) {
+    this.privacyPolicyLink = privacyPolicyLink;
+    return this;
+  }
+
+  public String optinMessage() {
+    return optinMessage;
+  }
+
+  public TollfreeVerificationCreator optinMessage(final String optinMessage) {
+    this.optinMessage = optinMessage;
+    return this;
+  }
+
+  public String helpMessage() {
+    return helpMessage;
+  }
+
+  public TollfreeVerificationCreator helpMessage(final String helpMessage) {
+    this.helpMessage = helpMessage;
+    return this;
+  }
+
   public String additionalInformation() {
     return additionalInformation;
   }
diff --git a/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationUpdater.java b/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationUpdater.java
index bc5f5240..6f95da86 100644
--- a/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationUpdater.java
+++ b/src/main/java/com/plivo/api/models/tollfree_verification/TollfreeVerificationUpdater.java
@@ -15,6 +15,10 @@ public class TollfreeVerificationUpdater extends Updater<TollfreeVerificationUpd
   private String volume;
   private String additionalInformation;
   private String extraData;
+  private String termsAndConditionsLink;
+  private String privacyPolicyLink;
+  private String optinMessage;
+  private String helpMessage;
   private String callbackURL;
   private String callbackMethod;
 
@@ -117,6 +121,42 @@ public TollfreeVerificationUpdater extraData(final String extraData) {
     return this;
   }
 
+  public String termsAndConditionsLink() {
+    return termsAndConditionsLink;
+  }
+
+  public TollfreeVerificationUpdater termsAndConditionsLink(final String termsAndConditionsLink) {
+    this.termsAndConditionsLink = termsAndConditionsLink;
+    return this;
+  }
+
+  public String privacyPolicyLink() {
+    return privacyPolicyLink;
+  }
+
+  public TollfreeVerificationUpdater privacyPolicyLink(final String privacyPolicyLink) {
+    this.privacyPolicyLink = privacyPolicyLink;
+    return this;
+  }
+
+  public String optinMessage() {
+    return optinMessage;
+  }
+
+  public TollfreeVerificationUpdater optinMessage(final String optinMessage) {
+    this.optinMessage = optinMessage;
+    return this;
+  }
+
+  public String helpMessage() {
+    return helpMessage;
+  }
+
+  public TollfreeVerificationUpdater helpMessage(final String helpMessage) {
+    this.helpMessage = helpMessage;
+    return this;
+  }
+
   public String callbackURL() {
     return callbackURL;
   }
diff --git a/src/test/java/com/plivo/api/TollfreeVerificationTest.java b/src/test/java/com/plivo/api/TollfreeVerificationTest.java
index 9b4c62bb..5019bbb4 100644
--- a/src/test/java/com/plivo/api/TollfreeVerificationTest.java
+++ b/src/test/java/com/plivo/api/TollfreeVerificationTest.java
@@ -1,5 +1,6 @@
 package com.plivo.api;
 
+import com.fasterxml.jackson.databind.JsonNode;
 import com.plivo.api.models.tollfree_verification.TollfreeVerification;
 import com.squareup.okhttp.mockwebserver.MockResponse;
 import com.squareup.okhttp.mockwebserver.RecordedRequest;
@@ -65,6 +66,60 @@ public void tollfreeVerificationCreateWithMandatoryParamsShouldSucceed() throws
 
     assertRequest("POST", "TollfreeVerification/");
   }
+  @Test
+  public void tollfreeVerificationCreateWithZipwhipFieldsShouldSucceed() throws Exception {
+    expectResponse("tollfreeVerificationCreateResponse.json", 201);
+
+    TollfreeVerification.creator()
+      .profileUuid("fb239ee1-fb5c-4dd9-b55c-5cf10170e756")
+      .number("18557312530")
+      .usecase("FRAUD_ALERT")
+      .usecaseSummary("summary")
+      .optinImageUrl("https://wwww.optinurl.com")
+      .optinType("VERBAL")
+      .messageSample("message sample")
+      .volume("10")
+      .additionalInformation("additional information")
+      .extraData("extra data")
+      .termsAndConditionsLink("https://www.example.com/terms")
+      .privacyPolicyLink("https://www.example.com/privacy")
+      .optinMessage("Reply YES to opt in")
+      .helpMessage("Reply HELP for help")
+      .callbackMethod("POST")
+      .callbackUrl("https://www.callbackurl.com")
+      .create();
+
+    JsonNode payload = actualRequestPayload();
+    assertEquals("https://www.example.com/terms", payload.get("terms_and_conditions_link").asText());
+    assertEquals("https://www.example.com/privacy", payload.get("privacy_policy_link").asText());
+    assertEquals("Reply YES to opt in", payload.get("optin_message").asText());
+    assertEquals("Reply HELP for help", payload.get("help_message").asText());
+  }
+
+  @Test
+  public void tollfreeVerificationUpdateWithZipwhipFieldsShouldSucceed() throws Exception {
+    String fixtureName = "tollfreeVerificationUpdateResponse.json";
+    String uuid = "uuid";
+
+    server.enqueue(new MockResponse()
+      .setResponseCode(200)
+      .setBody(loadFixture(fixtureName))
+    );
+
+    TollfreeVerification.updater(uuid)
+      .termsAndConditionsLink("https://www.example.com/terms")
+      .privacyPolicyLink("https://www.example.com/privacy")
+      .optinMessage("Reply YES to opt in")
+      .helpMessage("Reply HELP for help")
+      .update();
+
+    JsonNode payload = actualRequestPayload();
+    assertEquals("https://www.example.com/terms", payload.get("terms_and_conditions_link").asText());
+    assertEquals("https://www.example.com/privacy", payload.get("privacy_policy_link").asText());
+    assertEquals("Reply YES to opt in", payload.get("optin_message").asText());
+    assertEquals("Reply HELP for help", payload.get("help_message").asText());
+  }
+
   @Test
   public void tollfreeVerificationGetShouldSucceed() throws Exception {
     String uuid = "uuid";