{"title":"Payment request for Hosted Payment Pages","category":"default","creationDate":1776961627,"content":"<div class=\"sc-notice warning\"><div>\n<p><strong>Hosted Payment Pages are no longer available<\/strong><\/p>\n<p>To accept payments through an Adyen-hosted page, use our <a href=\"\/pt\/online-payments\/build-your-integration\/sessions-flow?platform=Web&amp;integration=Hosted%2BCheckout\">Hosted Checkout<\/a>.<\/p>\n<p>This page is for the classic Hosted Payment Pages (HPP) integration, which has reached end-of-life.  We are no longer processing transactions though HPP.<\/p>\n<\/div><\/div>\n<p>After you have set up your\u00a0<a href=\"\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/skin\">skin<\/a>, set up\u00a0a payment session using a generated URL, for example for a browser redirect (<a href=\"https:\/\/en.wikipedia.org\/wiki\/HTTP_302\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">HTTP status code 302<\/a>)\u00a0for the shopper as a standard HTML form. \u00a0Use this payment session to transfer the shopper to the HPP. To avoid tampering with payment session data, data traffic it is cryptographically signed using a\u00a0<a href=\"https:\/\/en.wikipedia.org\/wiki\/Shared_secret\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">shared secret<\/a>.\u00a0<\/p>\n<div class=\"sc-notice note\"><div>\n<ul>\n<li>Not all browsers can handle long URLs. For example, Microsoft Internet Explorer cannot handle URLs that are longer than 2083 characters. It is your responsibility to ensure that this limit is not exceeded.<\/li>\n<li>All parameters and their values should be URL-encoded using UTF-8 character encoding, as per W3C recommendation.<\/li>\n<\/ul>\n<\/div><\/div>\n<h2 id=\"use-case\">Use case<\/h2>\n<p>A shopper makes an order for a total amount payable of GBP 100. The order reference in your backoffice is Internet order 12345.<\/p>\n<p>The order details are:<\/p>\n<ul>\n<li>Goods shipping date to the shopper: before or not later than October 20th, 2016.<\/li>\n<li>Order summary information to display on the\u00a0payment review page for the order:\u00a0<em>1 digital camera<\/em>.<\/li>\n<li>Shopper's locale is British English.<\/li>\n<li>The skin you want to use to style the HPP is\u00a0<em>4aD37dJA<\/em>.<\/li>\n<li>The merchant account you are using is\u00a0<em>YOUR_MERCHANT_ACCOUNT<\/em>.<\/li>\n<li>The order was placed before or on October 11th 2016, 10:30 am.<\/li>\n<\/ul>\n<div class=\"notices blue\">\n<p>For a full list of the fields you can provide in a payment request, see our <a href=\"\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/hosted-payment-pages-api\/hpp-payment-request\">Payment request reference<\/a>.<\/p>\n<\/div>\n<h2 id=\"example\">Example<\/h2>\n<p>This example represents a complete payment session, based on the order details above.<\/p>\n<pre><code class=\"language-xml\">&lt;!DOCTYPE html&gt;\n&lt;html&gt;\n  &lt;body&gt;\n    &lt;form method=\"post\" action=\"https:\/\/test.adyen.com\/hpp\/select.shtml\" id=\"adyenForm\" name=\"adyenForm\" target=\"_parent\"&gt;\n      &lt;input type=\"hidden\" name=\"orderData\" value=\"H4sIAAAAAAAAALMpSUzKSVVIzkksLrZVyk9RsuPlsikpApMZdi6pxclFmQUlmfl5Cjb6QAEFkGhgaWJeSWZJJZKQY25+aV4JRACoVR9qAoRMsTNUcMlMzyxJzFFwTsxNLUpU0Hg5e\/fTrtkvVux5NnvH06UTn29pebKn8dnStY8bV2sCtaeAjE2BOatIyc4Qq6CBgYK7U4ACWA7TWpjKJCW7kHyg5diMwBBLUoAYrIfdbH1weNkBACLpJjE3AQAA\"&gt;\n      &lt;input type=\"hidden\" name=\"merchantSig\" value=\"3iWDU\/V5RMtdaiZC4YRIpoX9\/v0=\" \/&gt;\n      &lt;input type=\"hidden\" name=\"sessionValidity\" value=\"2014-10-11T10:30:00Z\" \/&gt;\n      &lt;input type=\"hidden\" name=\"shipBeforeDate\" value=\"2014-10-20\" \/&gt;\n      &lt;input type=\"hidden\" name=\"shopperLocale\" value=\"en_GB\" \/&gt;\n      &lt;input type=\"hidden\" name=\"merchantAccount\" value=\"TestMerchant\" \/&gt;\n      &lt;input type=\"hidden\" name=\"paymentAmount\" value=\"10000\" \/&gt;\n      &lt;input type=\"hidden\" name=\"currencyCode\" value=\"GBP\" \/&gt;\n      &lt;input type=\"hidden\" name=\"skinCode\" value=\"4aD37dJA\" \/&gt;\n      &lt;input type=\"hidden\" name=\"merchantReference\" value=\"Internet order 12345\" \/&gt;\n      &lt;input type=\"hidden\" name=\"shopperReference\" value=\"YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j\" \/&gt;\n      &lt;input type=\"hidden\" name=\"recurringContract\" value=\"RECURRING,ONECLICK\" \/&gt;\n      &lt;input type=\"hidden\" name=\"shopperEmail\" value=\"test102@gmail.com\" \/&gt;\n      &lt;input type=\"hidden\" name=\"offset\" value=\"0\" \/&gt;\n      &lt;input type=\"submit\" value=\"Send\" \/&gt;\n      &lt;input type=\"reset\" \/&gt;\n    &lt;\/form&gt;\n  &lt;\/body&gt;\n&lt;\/html&gt;<\/code><\/pre>\n<div class=\"sc-notice note\"><div>\n<p>Some payment methods restrict WebView in the app for security reasons. We recommend using the following if you want to display local payment method in your app:<\/p>\n<ul>\n<li><strong>iOS<\/strong>: SFSafariViewController (<a href=\"https:\/\/developer.apple.com\/documentation\/safariservices\/sfsafariviewcontroller\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/developer.apple.com\/documentation\/safariservices\/sfsafariviewcontroller<\/a>)<\/li>\n<li><strong>Android<\/strong>: Chrome Custom Tabs (<a href=\"https:\/\/developer.chrome.com\/multidevice\/android\/customtabs\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/developer.chrome.com\/multidevice\/android\/customtabs<\/a>)<\/li>\n<\/ul>\n<\/div><\/div>","url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/payment-request","articleFields":{"id":"24217170","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"29-10-2019 11:07","sitemap":{"priority":0.3},"parameters":{"anchor_new":"<a href=\"\/online-payments\">Online payments<\/a>","parent_page":"classic Hosted Payment Pages (HPP)"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/payment-request","title":"Payment request for Hosted Payment Pages","content":"\nHosted Payment Pages are no longer available\nTo accept payments through an Adyen-hosted page, use our Hosted Checkout.\nThis page is for the classic Hosted Payment Pages (HPP) integration, which has reached end-of-life.  We are no longer processing transactions though HPP.\n\nAfter you have set up your\u00a0skin, set up\u00a0a payment session using a generated URL, for example for a browser redirect (HTTP status code 302)\u00a0for the shopper as a standard HTML form. \u00a0Use this payment session to transfer the shopper to the HPP. To avoid tampering with payment session data, data traffic it is cryptographically signed using a\u00a0shared secret.\u00a0\n\n\nNot all browsers can handle long URLs. For example, Microsoft Internet Explorer cannot handle URLs that are longer than 2083 characters. It is your responsibility to ensure that this limit is not exceeded.\nAll parameters and their values should be URL-encoded using UTF-8 character encoding, as per W3C recommendation.\n\n\nUse case\nA shopper makes an order for a total amount payable of GBP 100. The order reference in your backoffice is Internet order 12345.\nThe order details are:\n\nGoods shipping date to the shopper: before or not later than October 20th, 2016.\nOrder summary information to display on the\u00a0payment review page for the order:\u00a01 digital camera.\nShopper's locale is British English.\nThe skin you want to use to style the HPP is\u00a04aD37dJA.\nThe merchant account you are using is\u00a0YOUR_MERCHANT_ACCOUNT.\nThe order was placed before or on October 11th 2016, 10:30 am.\n\n\nFor a full list of the fields you can provide in a payment request, see our Payment request reference.\n\nExample\nThis example represents a complete payment session, based on the order details above.\n&lt;!DOCTYPE html&gt;\n&lt;html&gt;\n  &lt;body&gt;\n    &lt;form method=\"post\" action=\"https:\/\/test.adyen.com\/hpp\/select.shtml\" id=\"adyenForm\" name=\"adyenForm\" target=\"_parent\"&gt;\n      &lt;input type=\"hidden\" name=\"orderData\" value=\"H4sIAAAAAAAAALMpSUzKSVVIzkksLrZVyk9RsuPlsikpApMZdi6pxclFmQUlmfl5Cjb6QAEFkGhgaWJeSWZJJZKQY25+aV4JRACoVR9qAoRMsTNUcMlMzyxJzFFwTsxNLUpU0Hg5e\/fTrtkvVux5NnvH06UTn29pebKn8dnStY8bV2sCtaeAjE2BOatIyc4Qq6CBgYK7U4ACWA7TWpjKJCW7kHyg5diMwBBLUoAYrIfdbH1weNkBACLpJjE3AQAA\"&gt;\n      &lt;input type=\"hidden\" name=\"merchantSig\" value=\"3iWDU\/V5RMtdaiZC4YRIpoX9\/v0=\" \/&gt;\n      &lt;input type=\"hidden\" name=\"sessionValidity\" value=\"2014-10-11T10:30:00Z\" \/&gt;\n      &lt;input type=\"hidden\" name=\"shipBeforeDate\" value=\"2014-10-20\" \/&gt;\n      &lt;input type=\"hidden\" name=\"shopperLocale\" value=\"en_GB\" \/&gt;\n      &lt;input type=\"hidden\" name=\"merchantAccount\" value=\"TestMerchant\" \/&gt;\n      &lt;input type=\"hidden\" name=\"paymentAmount\" value=\"10000\" \/&gt;\n      &lt;input type=\"hidden\" name=\"currencyCode\" value=\"GBP\" \/&gt;\n      &lt;input type=\"hidden\" name=\"skinCode\" value=\"4aD37dJA\" \/&gt;\n      &lt;input type=\"hidden\" name=\"merchantReference\" value=\"Internet order 12345\" \/&gt;\n      &lt;input type=\"hidden\" name=\"shopperReference\" value=\"YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j\" \/&gt;\n      &lt;input type=\"hidden\" name=\"recurringContract\" value=\"RECURRING,ONECLICK\" \/&gt;\n      &lt;input type=\"hidden\" name=\"shopperEmail\" value=\"test102@gmail.com\" \/&gt;\n      &lt;input type=\"hidden\" name=\"offset\" value=\"0\" \/&gt;\n      &lt;input type=\"submit\" value=\"Send\" \/&gt;\n      &lt;input type=\"reset\" \/&gt;\n    &lt;\/form&gt;\n  &lt;\/body&gt;\n&lt;\/html&gt;\n\nSome payment methods restrict WebView in the app for security reasons. We recommend using the following if you want to display local payment method in your app:\n\niOS: SFSafariViewController (https:\/\/developer.apple.com\/documentation\/safariservices\/sfsafariviewcontroller)\nAndroid: Chrome Custom Tabs (https:\/\/developer.chrome.com\/multidevice\/android\/customtabs)\n\n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Classic integrations for Ecommerce","lvl3":"Hosted Payment Pages","lvl4":"Payment request for Hosted Payment Pages"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/online-payments","lvl2":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations","lvl3":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/hosted-payment-pages","lvl4":"\/pt\/online-payments\/classic-integrations\/hosted-payment-pages\/payment-request"},"levels":5,"category":"Online Payments","category_color":"green","tags":["Payment","request","Hosted","Payment","Pages"]}}