{"id":3930,"date":"2025-05-19T13:38:47","date_gmt":"2025-05-19T13:38:47","guid":{"rendered":"https:\/\/developers-test.one2five.digital\/?post_type=docs&#038;p=3930"},"modified":"2025-05-27T14:46:32","modified_gmt":"2025-05-27T14:46:32","slug":"review-verification","status":"publish","type":"docs","link":"https:\/\/developers-test.one2five.digital\/?docs=review-verification","title":{"rendered":"Review Verification"},"content":{"rendered":"\n<p>The aim is to enhance consumer protection by reducing the prevalence of false, misleading, and deceptive reviews in online commerce. This involves ensuring that reviews come from genuine customers who have actually purchased or used the product, rather than from fake accounts, bots, or incentivized sources. By implementing stricter verification mechanisms and review authenticity checks, the goal is to foster a more trustworthy and transparent online shopping environment.<\/p>\n\n\n\n<p>Such efforts not only help consumers make better-informed decisions but also support fair competition among sellers. Reliable review systems can build consumer confidence and reduce the risk of manipulation or fraud, ultimately leading to a healthier and more accountable e-commerce ecosystem.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">Components<\/mark><a href=\"https:\/\/developers.bazaarvoice.com\/v1.0-ConversationsAPI\/docs\/b-mastered#components\"><\/a><\/h3>\n\n\n\n<p>The following table summarizes the components you will need to understand in order to implement the review verification flow. These components will be referenced throughout the rest of this documentation. Familiarizing yourself with them will make understanding the One2Five review verification easier.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td>Component<\/td><td>Description<\/td><td>Owner<\/td><\/tr><tr><td>Submission Form<\/td><td>This is a web form you build and host. Authors will use it to submit content<\/td><td>Client\/One2Five<\/td><\/tr><tr><td>Verification page<\/td><td>This page is designed and hosted by the client, or if the client does not have the feasibility, then One2Five provides a default to which the user gets redirected to on clicking the verification link got on email<\/td><td>Client\/One2Five<\/td><\/tr><tr><td>Authentication email<\/td><td>This email, which is typically sent by One2Five, asks the user to confirm they submitted the content by clicking on a link including a unique auth token.\u00a0\u00a0Clicking on the link opens a URL to your verification service.<\/td><td>One2Five<\/td><\/tr><tr><td>Token<\/td><td>This is a web form you build and host. Authors will use it to submit content<\/td><td>One2Five<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">Walk Through<\/mark><\/h3>\n\n\n\n<h4 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">How it works<\/mark><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Submit Content\n<ul class=\"wp-block-list\">\n<li>The process starts with a  content submission to the One2Five platform<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Verification mail sent to the content author\n<ul class=\"wp-block-list\">\n<li>After the review submission, the One2five platform triggers an email to the user who submitted the content.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>The author clicks the verification link in the email\n<ul class=\"wp-block-list\">\n<li>The verification email contains a link with a token, which will redirect to the page referenced by the hostedAuthentication_CallbackURL provided while content submission.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Updating review status\n<ul class=\"wp-block-list\">\n<li>on clicking the verification link which we shared to the user, the review status is now changed from not verified to verified\/open. <\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">Process and different options for verification setup<\/mark><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>hosted authentication on the client side<\/li>\n\n\n\n<li>hosted authentication on the One2Five side<\/li>\n\n\n\n<li>No authentication required (PIE, signed in user on client side)<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">Hosted authentication on the client side<\/mark><\/h4>\n\n\n\n<p>In this process, authentication and verification of the content submitted is done at the client side, while submitting the content, One2Five will need two parameters <em><code>HostedAuthentication_AuthenticationEmail<\/code>&nbsp;<\/em>and&nbsp;<code><em>HostedAuthentication_CallbackURL<\/em><\/code>.<\/p>\n\n\n\n<p><strong><code>HostedAuthentication_AuthenticationEmail<\/code><\/strong>: This parameter tells the One2Five platform where to send the email containing the authentication link.<\/p>\n\n\n\n<p><strong>HostedAuthentication_CallbackURL<\/strong>: This URL will be used as the front-end to your authentication service.&nbsp;This <em><code>hostedAuthentication_CallbackURL<\/code> <\/em>is the page where the verification API will get triggered. However, One2Five needs a dedicated hosted verification page from the client side that triggers our authentication API for the verification step itself.<\/p>\n\n\n\n<p>Here is an example of <a href=\"https:\/\/developers-test.one2five.digital\/?docs=fundamentals#3-toc-title\" data-type=\"link\" data-id=\"https:\/\/developers-test.one2five.digital\/?docs=fundamentals#3-toc-title\">submitreview.json<\/a> POST request.<\/p>\n\n\n\n<p>parameters used for example should look like:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">1. <em>hostedAuthentication_AuthenticationEmail<\/em> = someuseremail@domain.com\n\n2. <em>hostedAuthentication_CallbackURL<\/em> = URL where the client has hosted the page or has a mechanism to call our authentication API.\n\n3. <em>isAuthenticationRequired<\/em> = true<\/mark><\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">Hosted authentication on the One2Five side<\/mark><\/h4>\n\n\n\n<p>In this process, One2Five platform has provides a verification page is hosted at One2Five platform side, and the url provided by our platform should be used as a value for <em>hostedAuthentication_CallbackURL<\/em>.<\/p>\n\n\n\n<p>Whenever a content is submitted using the callback url provided by One2Five platform, the user gets an email with the link to redirect to the provided url where the verification page is hosted , which internally call the authentication api to authenticate and verify the content.<\/p>\n\n\n\n<p>Here is an example of <a href=\"https:\/\/developers-test.one2five.digital\/?docs=fundamentals#3-toc-title\" data-type=\"link\" data-id=\"https:\/\/developers-test.one2five.digital\/?docs=fundamentals#3-toc-title\">submitreview.json<\/a> POST request.<\/p>\n\n\n\n<p>parameters used for example should look like:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>default call back urls:\n<\/strong>\ntest environment : http:\/\/authentication-test.one2five-reviews.com\/verification.html\n\nproduction environment : http:\/\/authentication.one2five-reviews.com\/verification.html<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-preformatted\">1. <em>hostedAuthentication_AuthenticationEmail<\/em> = someuseremail@domain.com<br><br>2. <em>hostedAuthentication_CallbackURL<\/em> = call back url provided by one2five platform.<br><br>3. <em>isAuthenticationRequired<\/em> = true<\/pre>\n\n\n\n<h4 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">No authentication required (PIE, signed in user on client side)<\/mark><\/h4>\n\n\n\n<p>One2Five offers its customers the capability to request reviews via email, collectively termed as Post Interaction Emails (PIE). In this process, an email is sent to users that redirects them to the PIE submission form. These mechanisms ensure the reviews are collected from earlier purchasers of the product. This form can be customised as per the client. Once the review is submitted, no authentication or verification is required<\/p>\n\n\n\n<p>Pie review submission through pie mail sendout:<br>Here is an example of <a href=\"https:\/\/developers-test.one2five.digital\/?docs=fundamentals#3-toc-title\" data-type=\"link\" data-id=\"https:\/\/developers-test.one2five.digital\/?docs=fundamentals#3-toc-title\">submitreview.json<\/a> POST request.<br>Request:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apiversion : 5.4\n\npassKey : ibmgltgs-fhlc-ntxo-fzkz-etnkhwmihpwj\n\nDisplayCode : msm-de_de\n\naction : submit\n\nFP : 0400R9HVeoYv\n\nproductId : 3005\n\nuserId : 75847785871\n\nrating : 5\n\ntitle : Fantastic Device \u2013 Exceeded My Expectations!\n\nreviewText : I recently purchased this Refrigerator and couldn\u2019t be happier with my decision! The build quality is excellent, and it feels durable yet sleek. The performance is outstanding\u2014fast, efficient, and exactly as advertised. The battery life is impressive, lasting much longer than I expected, and the user interface is incredibly intuitive. Setup was a breeze, and it has quickly become an essential part of my daily routine. I highly recommend this to anyone looking for a high-quality and reliable gadget. Worth every penny!\n\ncontextDataValue_Competition : No\n\nisRecommended : true\n\nAgreedToTermsAndConditions : true\n\nUserNickname : Kunal\n\nrating_Design : 5\n\nrating_Features : 5\n\nrating_Quality : 5\n\nSendEmailAlertWhenPublished : True\n\nisAuthenticationRequired : false\n\ncontextdatavalue_VerifiedPurchaser : true\n\nformat : json<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-color\">Link to API Reference<\/mark><\/h4>\n\n\n\n<p>For detailed API documentation and usage instructions, please refer to the&nbsp;<a href=\"https:\/\/developers-test.one2five.digital\/?docs=api\">API Reference<\/a>.<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The aim is to enhance consumer protection by reducing the prevalence of false, misleading, and deceptive reviews in online commerce. This involves ensuring that reviews come from genuine customers who have actually purchased or used the product, rather than from fake accounts, bots, or incentivized sources. By implementing stricter verification mechanisms and review authenticity checks, &#8230; <a title=\"Review Verification\" class=\"read-more\" href=\"https:\/\/developers-test.one2five.digital\/?docs=review-verification\" aria-label=\"Read more about Review Verification\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_eb_attr":"","inline_featured_image":false,"footnotes":""},"doc_category":[11],"doc_tag":[],"class_list":["post-3930","docs","type-docs","status-publish","hentry","doc_category-knowledge-hub"],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=\/wp\/v2\/docs\/3930","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3930"}],"version-history":[{"count":52,"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=\/wp\/v2\/docs\/3930\/revisions"}],"predecessor-version":[{"id":4022,"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=\/wp\/v2\/docs\/3930\/revisions\/4022"}],"wp:attachment":[{"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3930"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=3930"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers-test.one2five.digital\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=3930"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}