CINXE.COM

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> <meta name="author" content="PAYONE"> <title>PAYONE Documentation Platform | Integration Guide Shopware 5 </title> <meta name="description" content=""> <link rel="icon" href="https://docs.payone.com/bl-themes/payone-docs/img/favicon.ico" type="image/png"> <link rel="stylesheet" type="text/css" href="https://docs.payone.com/bl-themes/payone-docs/css/font-line-aw-1.3.0/css/line-awesome.min.css?version=3.15.0">  <link rel="stylesheet" type="text/css" href="https://docs.payone.com/bl-themes/payone-docs/css/bulma.min.css?version=3.15.0"> <link rel="stylesheet" type="text/css" href="https://docs.payone.com/bl-themes/payone-docs/css/bulma-tooltip.min.css?version=3.15.0"> <link rel="stylesheet" type="text/css" href="https://docs.payone.com/bl-themes/payone-docs/css/bulma.overrides.css?version=3.15.0"> <link rel="stylesheet" type="text/css" href="https://docs.payone.com/bl-themes/payone-docs/css/payone.icons.css?version=3.15.0"> <link rel="stylesheet" type="text/css" href="https://docs.payone.com/bl-themes/payone-docs/css/payone.misc.css?version=3.15.0">  <link rel="stylesheet" type="text/css" href="https://docs.payone.com/bl-themes/payone-docs/css/highlight.github.min.css?version=3.15.0">  <link rel="stylesheet" type="text/css" href="https://docs.payone.com/bl-themes/payone-docs/php/api/api-template.css?version=3.15.0">  <link rel="canonical" href="https://docs.payone.com/integration/plugins/integration-guide-shopware-5"/>  </head> <body>  <div class="site_container" id="payone-sitecontainer">  <div id="navbardiv_on_index"> <nav class="navbar" role="navigation" aria-label="main navigation"> <div class="navbar-brand"> <a class="navbar-item" href="https://docs.payone.com"> <img src="/bl-themes/payone-docs/img/logo.svg" width="150" height="44" class="mt-3 mb-3"> </a> <a role="button" class="navbar-burger" data-target="navbarMenuContent" aria-label="menu" aria-expanded="false"> <span aria-hidden="true"></span> <span aria-hidden="true"></span> <span aria-hidden="true"></span> </a> <button id="mobileSubmenu" title="Open submenu"></button> </div> <div id="static top right sight" class="navbar-menu" style="display: block !important;"> <div class="navbar-end"> <div class="navbar-item"><div class="field has-addons"><div class="control"><input type="hidden" id="jspluginPayoneSearchMinChars" value="3" readonly><span id="jspluginPayoneSearchTextTooltip"><input type="text" class="input is-primary" id="jspluginPayoneSearchText" /> </span></div><div class="control"><button id="jspluginPayoneSearchButton" class="button is-primary" onClick="pluginPayoneSearch()" ><i class="payone-icon-tiny payone-white-search"></i></button></div></div></div><script> function openMinCharsMessage() { const tooltip = document.getElementById("jspluginPayoneSearchTextTooltip"); const minChars = document.getElementById("jspluginPayoneSearchMinChars").value; const message = 'Please enter at least ' + minChars + ' characters!'; tooltip.dataset.tooltip = message; tooltip.classList.add( 'has-tooltip-left', 'has-tooltip-arrow', 'has-tooltip-primary', 'has-tooltip-active' ); } function pluginPayoneSearch() { const text = document.getElementById("jspluginPayoneSearchText").value; const minChars = document.getElementById("jspluginPayoneSearchMinChars").value; const valid = (text.length >= minChars); if (!valid) { openMinCharsMessage(); return false; } window.open('https://docs.payone.com/'+'search/'+text, '_self'); return true; } document.getElementById("jspluginPayoneSearchText").onkeypress = function(e) { if (!e) e = window.event; var keyCode = e.keyCode || e.which; if (keyCode == '13'){ pluginPayoneSearch(); return false; } } </script> <div id="login" class="navbar-item"> <div class="buttons"> <a class="btn btn-outline-primary" type="button" href="https://login.pay1.de/"> Login PMI </a> </div> </div>  </div> </div> </nav> <nav class="navbar payone-hide-navbar-mobile"> <div id="navbarMenuContent" class="navbar-menu box"> <div class="navbar-start"> <a class="navbar-item" href="/pcp/payone-commerce-platform"> PAYONE Commerce Platform </a> <a class="navbar-item" href="/payment-methods/"> Payment Methods </a> <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link" href="/integration"> Integration </a> <div class="navbar-dropdown"> <a class="navbar-item" href="/integration/plugins"> Plugins </a> <hr class="navbar-divider"> <a class="navbar-item" href="/integration/channel-server-api"> Server API </a> <hr class="navbar-divider"> <a class="navbar-item" href="/integration/channel-client-api"> Client API </a> <hr class="navbar-divider"> <a class="navbar-item" href="/integration/channel-payone-link"> Channel PAYONE Link </a> <hr class="navbar-divider"> <a class="navbar-item" href="/integration/channel-frontend"> Channel Frontend </a> <hr class="navbar-divider"> <a class="navbar-item" href="/integration/response-handling"> Response Handling </a> <hr class="navbar-divider"> <a class="navbar-item" href="/integration/testdata"> Testdata </a> </div> </div> <a class="navbar-item" href="/advanced-features"> Advanced Features </a> <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link"> Security & Risk Management </a> <div class="navbar-dropdown"> <a class="navbar-item" href="/security-risk-management/3d-secure"> 3DS </a> <hr class="navbar-divider"> <a class="navbar-item" href="/security-risk-management/fraudprevention"> Fraud </a> <hr class="navbar-divider"> <a class="navbar-item" href="/security-risk-management/consumerscore"> Consumer score </a> </div> </div> <div class="navbar-item has-dropdown is-hoverable"> <a class="navbar-link"> Information </a> <div class="navbar-dropdown"> <a class="navbar-item" href="/information/general-information"> General information </a> <hr class="navbar-divider"> <a class="navbar-item" href="/information/platform-codes"> Platform codes </a> <hr class="navbar-divider"> <a class="navbar-item" href="/information/payone-merchant-interface"> PAYONE Merchant Interface (PMI) </a> <hr class="navbar-divider"> <a class="navbar-item" href="/information/sequence-diagrams"> Sequence diagrams </a> <hr class="navbar-divider"> <a class="navbar-item" href="/information/privacy-policy"> Privacy Policy </a> <hr class="navbar-divider"> <a class="navbar-item" href="https://www.payone.com/DE-de/service/kontakt" target="_blank"> Contact (DE) </a> <hr class="navbar-divider"> <a class="navbar-item" href="https://www.payone.com/DE-de/service/feedback-beschwerde" target="_blank"> Report an issue (DE) </a> </div> </div> </div> </div> </nav> </div> <div class="payone-breadcrumbs"> <nav class="breadcrumb has-arrow-separator is-small" aria-label="breadcrumbs"> <ul> <li class=""><a href="/integration">Integration</a></li><li class=""><a href="/integration/plugins">Plugins</a></li><li class="is-active"><a href="/integration/plugins/integration-guide-shopware-5">Integration Guide Shopware 5</a></li> </ul> </nav> </div> <div class="docs-container is-flex"> <aside id="aside" class="column is-2 is-narrow-mobile is-fullheight is-hidden-touch"><ul class="tree"><li><a target="_self" href="https://docs.payone.com/integration">Integration</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/plugins">Plugins</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-shopware-6">Integration Guide Shopware 6 </a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/shopware-6-integrationsanleitung">Integrationsanleitung Shopware 6 </a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-magento-2">Integration Guide Magento 2</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-magento-2">Integrationsanleitung Magento 2</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-shopware-5">Integration Guide Shopware 5</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-shopware-5">Integrationsanleitung Shopware 5</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-woocommerce">Integration Guide WooCommerce</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-woocommerce">Integrationsanleitung WooCommerce</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-oxid-6">Integrationsanleitung Oxid 6</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-oxid-6">Integration Guide Oxid 6</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-oxid-7">Integrationsanleitung Oxid 7</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-oxid-7">Integration Guide Oxid 7</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/installationsanleitung-magento-1">Installationsanleitung Magento 1</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-magento-1">Integration Guide Magento 1</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api">Channel-Server-API</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-preauthorization">Server API - Preauthorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-authorization">Server API - Authorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-capture">Server API - Capture</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-refund">Server API - Refund</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-debit">Server API - Debit</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-managemandate">Server API - Managemandate</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-getinvoice">Server API - Getinvoice</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-getfile">Server API - Getfile</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-vauthorizatuion">Server API - Vauthorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-creditcardcheck">Server API - Creditcardcheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-getuser">Server API - Getuser</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-updateuser">Server API - Updateuser</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-3dscheck">Server API - 3dscheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-bankaccountcheck">Server API - Bankaccountcheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-addresscheck">Server API - Addresscheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-createaccess">Server API - Createaccess</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-updateaccess">Server API - Updateaccess</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-updatereminder">Server API - Updatereminder</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-general-definitions">Server API - General Interface Definitions</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-checkout-demo-app">Server API - checkout demo app</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api">Channel-Client-API</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-preauthorization">Client API - Preauthorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-bankaccountcheck">Client API - Bankaccountcheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-creditcardcheck">Client API - Creditcardcheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-managemandate">Client API - Managemandate</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-general-interface-definitions">Client API - General Interface Definitions</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-createaccess">Client API - Createaccess</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-vauthorization">Client API - Vauthorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-authorization">Client API - Authorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-ajax-mode">Client API - AJAX-Mode</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-redirect-mode">Client API - Redirect-Mode</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-addresscheck">Client API - Addresscheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-hosted-iframe-mode">Client API - Hosted iFrame Mode </a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-hosted-iframe-mode/hosted-iframe-examples">Hosted Iframe Examples</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-hosted-iframe-mode/client-api-additional-tips">Client API - Additional Tips</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/calculation-of-the-hash-value">Client API - Calculation of the HASH value</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link">PAYONE Link</a><ul style="display:none"><li><a target="_blank" href="https://docs.payone.com/integration/channel-payone-link/payone-link-api?fullwidth=1">PAYONE Link - API</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link/payone-link-notification-api">PAYONE Link - Notification-API</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link/how-to-verify-notifications">PAYONE Link - How to Verify Notifications</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link/payone-link-authorization">PAYONE Link - Authorization + Linkstatus</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link/payone-link-complete-bash-example">PAYONE Link - Complete Bash Example + HMAC SHA256 Examples</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-frontend">Channel-Frontend</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/channel-frontend/frontend-available-payment-types">Frontend - Available payment types</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-frontend/payment-portals-access-shop">Payment portals (Access - Shop Versions)</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/response-handling">Response Handling</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/response-handling/transactionstatus-notification"> Transactionstatus Notifications - Samples and Responses</a></li><li><a target="_self" href="https://docs.payone.com/integration/response-handling/json-responses">JSON-Responses</a></li><li><a target="_self" href="https://docs.payone.com/integration/response-handling/json-examples">JSON Examples</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/testdata">Testdata</a></li></ul></li></ul></aside> <div id="payone-modal-submenu" class="modal"> <div class="modal-background"></div> <div class="modal-card"> <header class="modal-card-head"> <p class="modal-card-title"> Integration </p> <button class="delete payone-primary-background" aria-label="close"></button> </header> <section class="modal-card-body"> <ul class="tree"> <li><a target="_self" href="https://docs.payone.com/integration">Integration</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/plugins">Plugins</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-shopware-6">Integration Guide Shopware 6 </a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/shopware-6-integrationsanleitung">Integrationsanleitung Shopware 6 </a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-magento-2">Integration Guide Magento 2</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-magento-2">Integrationsanleitung Magento 2</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-shopware-5">Integration Guide Shopware 5</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-shopware-5">Integrationsanleitung Shopware 5</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-woocommerce">Integration Guide WooCommerce</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-woocommerce">Integrationsanleitung WooCommerce</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-oxid-6">Integrationsanleitung Oxid 6</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-oxid-6">Integration Guide Oxid 6</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integrationsanleitung-oxid-7">Integrationsanleitung Oxid 7</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-oxid-7">Integration Guide Oxid 7</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/installationsanleitung-magento-1">Installationsanleitung Magento 1</a></li><li><a target="_self" href="https://docs.payone.com/integration/plugins/integration-guide-magento-1">Integration Guide Magento 1</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api">Channel-Server-API</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-preauthorization">Server API - Preauthorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-authorization">Server API - Authorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-capture">Server API - Capture</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-refund">Server API - Refund</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-debit">Server API - Debit</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-managemandate">Server API - Managemandate</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-getinvoice">Server API - Getinvoice</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-getfile">Server API - Getfile</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-vauthorizatuion">Server API - Vauthorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-creditcardcheck">Server API - Creditcardcheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-getuser">Server API - Getuser</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-updateuser">Server API - Updateuser</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-3dscheck">Server API - 3dscheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-bankaccountcheck">Server API - Bankaccountcheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-addresscheck">Server API - Addresscheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-createaccess">Server API - Createaccess</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-updateaccess">Server API - Updateaccess</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-updatereminder">Server API - Updatereminder</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-general-definitions">Server API - General Interface Definitions</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-server-api/server-api-checkout-demo-app">Server API - checkout demo app</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api">Channel-Client-API</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-preauthorization">Client API - Preauthorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-bankaccountcheck">Client API - Bankaccountcheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-creditcardcheck">Client API - Creditcardcheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-managemandate">Client API - Managemandate</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-general-interface-definitions">Client API - General Interface Definitions</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-createaccess">Client API - Createaccess</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-vauthorization">Client API - Vauthorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-authorization">Client API - Authorization</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-ajax-mode">Client API - AJAX-Mode</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-redirect-mode">Client API - Redirect-Mode</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-addresscheck">Client API - Addresscheck</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-hosted-iframe-mode">Client API - Hosted iFrame Mode </a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-hosted-iframe-mode/hosted-iframe-examples">Hosted Iframe Examples</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/client-api-hosted-iframe-mode/client-api-additional-tips">Client API - Additional Tips</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-client-api/calculation-of-the-hash-value">Client API - Calculation of the HASH value</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link">PAYONE Link</a><ul style="display:none"><li><a target="_blank" href="https://docs.payone.com/integration/channel-payone-link/payone-link-api?fullwidth=1">PAYONE Link - API</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link/payone-link-notification-api">PAYONE Link - Notification-API</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link/how-to-verify-notifications">PAYONE Link - How to Verify Notifications</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link/payone-link-authorization">PAYONE Link - Authorization + Linkstatus</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-payone-link/payone-link-complete-bash-example">PAYONE Link - Complete Bash Example + HMAC SHA256 Examples</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/channel-frontend">Channel-Frontend</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/channel-frontend/frontend-available-payment-types">Frontend - Available payment types</a></li><li><a target="_self" href="https://docs.payone.com/integration/channel-frontend/payment-portals-access-shop">Payment portals (Access - Shop Versions)</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/response-handling">Response Handling</a><ul style="display:none"><li><a target="_self" href="https://docs.payone.com/integration/response-handling/transactionstatus-notification"> Transactionstatus Notifications - Samples and Responses</a></li><li><a target="_self" href="https://docs.payone.com/integration/response-handling/json-responses">JSON-Responses</a></li><li><a target="_self" href="https://docs.payone.com/integration/response-handling/json-examples">JSON Examples</a></li></ul></li><li><a target="_self" href="https://docs.payone.com/integration/testdata">Testdata</a></li></ul></li> </ul> </section> <footer class="modal-card-foot"> <div class="buttons"> <button class="btn btn-outline-primary">Cancel</button> </div> </footer> </div> </div>  <section class="section"> <div class="column is-12 mb-3 payone-sitedivs"> <div class="pagetitle"> <h2 class="h2Header">Integration Guide Shopware 5</h2> </div> <div id="navigation"><nav class="in-page-sub-nav" id="subnavbar"> <table style="width: 100%;"> <tbody> <tr> <td style="width: 20.0%;"> <p class="navbar">Introduction</p> </td> <td style="width: 20.0%;"> <p class="navbar">Requirements</p> </td> <td style="width: 20.0%;"> <p class="navbar"><a href="#InstallPlugin" title="Install_plugin">Plugin Installation</a></p> </td> <td style="width: 20.0%;"> <p class="navbar"><a href="#PortalConfig" title="Portal_Config">PAYONE - Portal configuration</a></p> </td> <td style="width: 20.0%;"> <p class="navbar"><a href="#AdminConfig" title="Admin_config">Shopware 5 - Admin configuration</a></p> </td> </tr> </tbody> </table> </nav></div> <div class="payone-white-content-section" title="Introduction"> <h4 class="h4Header" id="Introduction">Introduction</h4> <p>Our Shopware 5 plugin comes with regular updates and full integration support, offering a versatile out-of-the-box solution to accept online payments easily:</p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Currently supported payment methods:</span></div> <div class="responsesDivcontent"> <p></p> <ul style="list-style: disc inside;"> <li>Credit Cards (Visa, Mastercard, American Express, JCB, Diners Club, Maestro International, Carde Bleue)</li> <li>Amazon Pay (V1)</li> <li>Alipay</li> <li>Apple Pay</li> <li>Bancontact</li> <li>Barzahlen</li> <li>EPS</li> <li>Giropay</li> <li>iDEAL</li> <li>Klarna Payments</li> <li>PAYONE secure Invoice </li> <li>PAYONE Secured Invoice, Secured Direct Debit and Secured Installment</li> <li>PAYONE Direct Debit</li> <li>PAYONE Open Invoice</li> <li>PAYONE Prepayment</li> <li>PayPal and PayPal Express</li> <li>PostFinance Card and E-Finance</li> <li>Przelewy24</li> <li>Ratepay Invoice, Direct Debit and Installment</li> <li>Sofort</li> <li>Trustly</li> <li>Unzer Invoice, Direct Debit and Installment</li> <li>WeChat Pay</li> </ul> <p></p> </div> <p>Keep an eye on our Release Notes to stay informed about updates and new features (i.e. payment methods, features, integration modes) we have added to this plugin!</p> <p>Check out our documentation to learn how to link your store with our platform to profit from all these features!</p> <p>Current Release: <strong>v4.13.2</strong></p> <div class="buttons"><a class="btn btn-success" type="button" href="https://github.com/PAYONE-GmbH/shopware-5/releases/tag/4.13.2" target="_blank" rel="noopener"> Download Plugin </a></div> </div> <div class="payone-white-content-section" title="Requirements"> <h4 class="h4Header" id="Requirements">Requirements</h4> <p>An active PAYONE - Account is required. If you do not have one yet, <a href="https://www.payone.com/DE-de/service/kontakt" target="_blank" rel="noopener">please contact us</a>.</p> </div> <div class="payone-white-content-section" title="Install Plugin"> <h4 class="h4Header" id="InstallPlugin">Plugin Installation</h4> <p>You have 2 ways to install our plugin:</p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Installation directly in Shopware5 - Admin<span></span></span></div> <p></p> <ul> <li style="list-style-type: none;"> <ul style="padding-left: 25px;"> <li>Download our latest plugin from <a href="https://github.com/PAYONE-GmbH/shopware-5/releases" target="_blank" rel="noopener">Github</a></li> <li>You can upload the plugin under Ice Settings -> Plugin Manager -> Installed -> Upload Plugin</li> <li>Install and activate the plugin.</li> </ul> </li> </ul> <p><img src="https://docs.payone.com/bl-content/uploads/pages/bfca26ca51fe8ee11792c7f9ff5060b3/PluginuploadSW5.png" alt=""></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Installation via Github<span></span></span></div> <div class="responsesDivcontent"> <p></p> <div class="buttons"><a class="btn btn-success" type="button" href="https://github.com/PAYONE-GmbH/shopware-5/releases" target="_blank" rel="noopener">Download von Github</a></div> </div> </div> <p></p> <div class="payone-white-content-section" title="Portal Config"> <h4 class="h4Header" id="PortalConfig">PAYONE - Portal configuration</h4> <p>To send the transaction status to the correct address, the log in to the PAYONE Merchant Interface (PMI).</p> <p>Under Configuration → Payment Portals → YOUR_PORTAL → Advanced → TransactionStatus URL</p> <div class="infobox"><SHOPURL>/MoptShopNotification</div> <p><a href="https://docs.payone.com/bl-content/uploads/pages/bfca26ca51fe8ee11792c7f9ff5060b3/Shopware5_en_Admin.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/bfca26ca51fe8ee11792c7f9ff5060b3/Shopware5_en_Admin.png" alt="" width="500"></a></p> <div class="expectbox">Please leave the hash check set to "md5 oder sha2-384 (during migration)" to ensure correct communication between PAYONE and the store.</div> <h5 class="h5Header">Additional Response-data</h5> <p>Under General, set the Additional Response data for both Live and Test modes to "on".</p> <p><a href="https://docs.payone.com/bl-themes/payone-docs/img/start_here/pmi-additional-resp-data.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-themes/payone-docs/img/start_here/pmi-additional-resp-data.png" width="400" height="156" alt=""></a></p> </div> <div class="payone-white-content-section" title="Admin Config"> <h4 class="h4Header" id="AdminConfig">Shopware 5 - Admin configuration</h4> <p>Click on Customers → Payments → PAYONE → Konfiguration</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-2.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-2.png" alt="" width="300"></a></p> <p>You can create a separate configuration for each payment type. The default setting - Alle (global) applies to all payment types.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-3.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-3.png" alt="" width="300"></a></p> <p></p> <p>Once you have created a separate configuration for a payment type, the default setting - Alle (global) no longer applies to the payment type.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-4.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-4.png" alt="" width="300"></a></p> <p>If you have made changes to a payment type that differ from the global settings, the payment type will be displayed in red.</p> <p>Please enter your access data here under Customers → Payments → PAYONE → Konfiguration → sheet: "general":</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-5.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-5.png" alt="" width="300"></a></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Detailed description of each field</span></div> <div class="responsesDivcontent"> <p></p> <p>Save acceptance of the general business terms</p> <ul style="list-style: disc inside;"> <li><strong>Off </strong>- witches off the saving of the AGB confirmation completely.</li> <li><strong>On the Confirm-Page</strong> - Only on the Confirm page the saving of the AGB is activated.</li> <li><strong>Global </strong>- Enables global storage.</li> </ul> <table class="payone-simpleTable" style="width: 67.0226%; height: 3022px;"> <thead> <tr style="height: 39px;"> <th class="payone-simpleTh" style="width: 9.68468%; height: 39px;">Field</th> <th class="payone-simpleTh" style="width: 90.3152%; height: 39px;">Description</th> </tr> </thead> <tbody> <tr style="height: 47px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 47px;">Merchant ID</td> <td class="payone-simpleTd" style="width: 90.3152%; height: 47px;">You will find your PAYONE Merchant ID at the top right of the PAYONE Merchant Interface (PMI) and on all PAYONE invoices.</td> </tr> <tr style="height: 87px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 87px;">Portal ID</td> <td class="payone-simpleTd" style="width: 90.3152%; height: 87px;">You can find the portal ID in the PAYONE Merchant Interface (PMI) under the menu item Configuration → Payment Portals</td> </tr> <tr style="height: 63px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 63px;"> <p>Subaccount-ID</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 63px;"> <p>You can find the ID in the PAYONE Merchant Interface (PMI) under the menu item Configuration → Accounts</p> </td> </tr> <tr style="height: 63px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 63px;"> <p>Key</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 63px;"> <p>Please enter the key here to protect the data communication against manipulation. This must be identical to the key stored in the corresponding PAYONE payment portal.</p> </td> </tr> <tr style="height: 87px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 87px;"> <p>operating mode</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 87px;"> <p>Here you can specify for the respective payment type whether the payments are to be processed in test mode or whether they are to be executed "live". You can also configure the test mode for individual payment types.</p> </td> </tr> <tr style="height: 207px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 152px;"> <p>authorization</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 152px;"> <ul style="list-style: disc inside;"> <li><strong>preauthorisation </strong>- The amount to be paid is reserved in the course of the order. In this case, the debit must be initiated in a second step when the goods are delivered (Capture). The receivable is only posted after the capture has been carried out.</li> <li><strong>authorisation </strong>- The amount tobe paid is collected immediately when the order is placed. The receivable is immediately booked on the PAYONE platform.</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%;"> <p>basket handover</p> </td> <td class="payone-simpleTd" style="width: 90.3152%;"> <p>Here you can configure whether the shopping cart information should be transferred to the PAYONE platform for each request.</p> <div class="tryoutbox">In most cases it's safe to leave this setting on. However, some usecases may cause issues with this setting enabled:<br>- PayPal with cart items that are free - PayPal expects every cart item to have a price, so if you ship bonus items it's better to leave this off.<br><br>- Plugins which alter the calculation of prices - some plugins alter price calculation, which can lead to rounding differences. If you frequently see error 1610 (Article list faulty or incomplete) and are confident about the actual amount of the order, try disabling this setting.<br><br></div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%;"> <p>query Credit Card Verification</p> </td> <td class="payone-simpleTd" style="width: 90.3152%;"> <p>Determines whether the credit card verification number is queried. This is only possible if the acquirer allows it.</p> </td> </tr> <tr style="height: 87px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 87px;"> <p>check bank details</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 87px;"> <p>Determines whether a bank account check should be performed. This option is only available if the Direct Debit payment type is selected.</p> </td> </tr> <tr style="height: 87px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 87px;"> <p>Additionally Show account number/ bank code</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 87px;"> <p>Legacy option from the transition period from account number to IBAN.</p> </td> </tr> <tr style="height: 63px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 63px;"> <p>in addition to IBAN query also BIC?</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 63px;"> <p>Legacy option, as today the IBAN is sufficient.</p> </td> </tr> <tr style="height: 63px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 63px;"> <p>query IBAN and BIC for SOFORT Payments</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 63px;"> <p>Legacy option, as today the IBAN is sufficient.</p> </td> </tr> <tr style="height: 111px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 111px;"> <p>activate direct debits mandates?</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 111px;"> <p>Determines whether the SEPA mandate manager is to be used. A check of the bank details is mandatory. A check against the cash block list is not possible.</p> </td> </tr> <tr style="height: 111px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 111px;"> <p>Download mandate as PDF?</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 111px;"> <p>If activated, a link will be offered after the order has been placed, via which the end customer can download the SEPA Mandate as a PDF file.</p> <div class="tryoutbox">This product must be ordered separately.</div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%;"> <p>Klarna Store ID</p> </td> <td class="payone-simpleTd" style="width: 90.3152%;"> <p>Specific store IDs must be configured for the Klarna payment method. You can obtain these store IDs from Klarna. Please note that for the payment method Klarna the delivery address must be the same as the billing address. You can enforce this with Shopware Risk Management.</p> <div class="tryoutbox"> <p>Note: The store ID can only be configured if the payment method Klarna is selected. Please also note that Klarna payment methods can't be duplicated!</p> </div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%;"> <p>show paypal ECS Button on basket page?</p> </td> <td class="payone-simpleTd" style="width: 90.3152%;"> <p>This option activates the PayPal Expresscheckout button on the shopping cart page.</p> <div class="tryoutbox"> <p>Note: This option can only be selected if the payment method PayPal is selected.</p> </div> </td> </tr> <tr style="height: 63px;"> <td class="payone-simpleTd" colspan="2" style="width: 99.9999%; background-color: #ecf0f1; height: 63px;"> <p>Note: The Unzer options can only be selected if a Unzer payment method is selected.</p> </td> </tr> <tr style="height: 63px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 63px;"> <p>Unzer company name</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 63px;"> <p>The full name of the company must appear here. The name will be used in the privacy policy.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%; height: 67px;"> <p>Unzer b2b mode<br> </p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 67px;"> <p>If the B2B mode is activated, it is automatically assumed that it is a B2B transaction if the "Company" field was executed during address entry. To check the creditworthiness of the company, further information such as the commercial register number is then requested in the checkout. </p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%; height: 87px;"> <p>Unzer-username</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 87px;"> <p>In order to retrieve the installment purchase draft contract, the user name assigned by Unzer (usually dealer name installation) must be stored here.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%; height: 87px;"> <p>Unzer-password<br> </p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 87px;"> <p>The password assigned by Unzer must be stored here in order to retrieve the installment purchase draft contract.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%; height: 175px;"> <p>Paydirekt Overcapture</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 175px;"> <p>This setting enables you to increase the original order value in the reservation and subsequent collection procedure and to collect up to a maximum amount. This maximum amount is displayed on the paydirekt pages.</p> <div class="tryoutbox"> <p>Note: This setting only applies to the payment type paydirekt.</p> </div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%; height: 169px;"> <p>use shopware ordernumber</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 169px;"> <p>This setting causes an order number generated by the plugin to be reported as a reference to PAYONE. However, the order number generated by Shopware is not. </p> <div class="tryoutbox"> <p>Note: This order number must always be unique and cannot be reused. Make sure that the correct and not already used order number range is active.</p> </div> </td> </tr> <tr style="height: 87px;"> <td class="payone-simpleTd" style="width: 9.68468%; height: 87px;"> <p>update order timestamp on notify </p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 87px;"> <p>Updates the order change timestamp on the order when a new transaction status notification is received and processed.</p> <div class="tryoutbox">Note: This only works in Shopware 5.5 and higher.</div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%; height: 77px;"> <p>Ratepay SnippetId</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 77px;"> <p>Specifies the ratepay SnippetId used for fingerprinting the device. Default is "ratepay". This can be changed by ratepay. Please note that only the global setting applies, even if payment method specific settings have been made.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.68468%; height: 63px;"> <p>query IBAN and BIC for Trustly payments</p> </td> <td class="payone-simpleTd" style="width: 90.3152%; height: 63px;"> <p>Legacy option, as today the IBAN is sufficient.</p> </td> </tr> </tbody> </table> </div> <p></p> <h5 class="h5Header">Special Adjustments</h5> <p>Some payment types require special adjustments. The next points are only interesting for you if you use the respective payment method:</p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">PAYONE Secured Invoice + PAYONE Secured Installment<span></span></span></div> <div class="responsesDivcontent"> <p></p> <p>These two payment methods require their own payment portal. Please enter under Customers → Payments → PAYONE → Konfiguration → applies to payment method: PAYONE Secured Invoice bzw. PAYONE Secured Installment a separate portal ID.</p> <div class="tryoutbox">If the orders are partially captured, the refunds must be created in the same amount. The background is that a new receivable is created with each capture.</div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">PayPal Express Checkout</span></div> <div></div> <div class="responsesDivcontent"> <div>Click on Customers → Payments → PAYONE → Payone PayPal<br> </div> <div><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-6.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-6.png" alt="" width="300"></a></div> <div><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-7.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-7.png" alt="" width="300"></a></div> <div></div> <div> <table class="payone-simpleTable" style="width: 50.9755%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 32.7338%;">Field</th> <th class="payone-simpleTh" style="width: 67.2662%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 32.7338%;"> <p>Add item</p> </td> <td class="payone-simpleTd" style="width: 67.2662%;"> <p>Add more countries</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 32.7338%;"> <p>Delete all selected</p> </td> <td class="payone-simpleTd" style="width: 67.2662%;"> <p>Delete selected entries</p> </td> </tr> </tbody> </table> <p></p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-8.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-8.png" alt="" width="300"></a></p> <p></p> <div> <table class="payone-simpleTable" style="width: 52.6443%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 21.3467%;">Field</th> <th class="payone-simpleTh" style="width: 78.6533%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 21.3467%;"> <p>Language</p> </td> <td class="payone-simpleTd" style="width: 78.6533%;"> <p>Select language</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 21.3467%;"> <p>Packstation mode</p> </td> <td class="payone-simpleTd" style="width: 78.6533%;"> <ul style="list-style: disc inside;"> <li><strong>Erlauben </strong>- Allow packing stations as delivery address</li> <li><strong>Verbieten </strong>- Disallow Packing stations as delivery address</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 21.3467%;"> <p>PayPal Button</p> </td> <td class="payone-simpleTd" style="width: 78.6533%;"> <p>Path to the image file of the button</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 21.3467%;"> <p>Default</p> </td> <td class="payone-simpleTd" style="width: 78.6533%;"> <p>If the check-box is enabled, the settings will apply to all languages for which no button has been defined.</p> </td> </tr> </tbody> </table> <div class="tryoutbox">If no image file is available, the PayPal ECS button will not be displayed in the shopping cart. There must be at least one button and it must be marked as default.</div> </div> </div> </div> <div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Ratepay</span></div> <div class="responsesDivcontent"> <div></div> <div>Click on Customers → Payments → PAYONE → Payone Ratepay</div> <div></div> <div>For Ratepay, you need to enter some additional configuration data that Ratepay has set to make the payment method work smoothly. Use the Add button to add another Ratepay configuration:</div> <div><br> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-9.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-9.png" alt="" width="300"></a></div> <div></div> <div> <table class="payone-simpleTable" style="width: 54.7538%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 9.71831%;">Field</th> <th class="payone-simpleTh" style="width: 90.2817%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 9.71831%;"> <p>Shopid</p> </td> <td class="payone-simpleTd" style="width: 90.2817%;"> <p>The store ID provided by RatePay.</p> <p>This represents a configuration record (country, currency, interest rates, maturities, etc.).</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.71831%;"> <p>currency</p> </td> <td class="payone-simpleTd" style="width: 90.2817%;"> <p>Currency to be used for this store ID</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 9.71831%;"> <p>installment mode</p> </td> <td class="payone-simpleTd" style="width: 90.2817%;"> <p>This setting has no effect on the other Ratepay payment types (invoice, direct debit).</p> <ul style="list-style: disc inside;"> <li><strong>Prepayment </strong>- The buyer must transfer the installments to an account designated by Ratepay.</li> <li><strong>direct debit</strong> - The installments are collected by direct debit from the buyer's account.</li> </ul> </td> </tr> </tbody> </table> <p></p> <p>Save the configuration and then retrieve the other data from RatePay with "Retrieve Ratepay configuration". Make sure that you select the checkbox beforehand.<br> </p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-10.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-10.png" alt="" width="300"></a></p> <div class="tryoutbox">You can find the global snippet ID setting in the general configuration.</div> </div> </div> <div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Amazon Pay</span></div> <div></div> <div class="responsesDivcontent"> <div> <p>Click on Customers → Payments → PAYONE → Payone Amazon Pay</p> <p>Amazon Pay requires you to enter some additional data to ensure that the payment method works smoothly.</p> <h5 class="h5Param">Integrations settings in Seller Central</h5> </div> <div> <p>Please enter the following URL in the integration settings in Seller Central under Integrator URL:</p> <p>https://gpc-sys.pay1.de/gpc/amazon/1.0/notify - the seller URL can be left blank.</p> <p>This URL ensures that the store receives all notifications from Amazon.</p> </div> <div><a href="https://docs.payone.com/bl-content/uploads/pages/45112abd826dc8011bfb22b25862bd34/Magento2-12.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/45112abd826dc8011bfb22b25862bd34/thumbnails/Magento2-12.png" alt="" width="200"></a></div> <div>Also please make sure to store all your shop URLs as allowed Javascript Origin in Seller Central.</div> <div></div> <ol style="padding-left: 25px;"> <li>From the Seller Central home page, select “Integration - Integration Central” from the navigation bar on top-left side</li> <li>From Integration Central page, scroll down to the “Manage client ID/store ID(s)” section, and click “View client ID/store ID(s)”</li> <li>If you have an existing client or Store ID registered, review the configuration of the selected store. You can click on the “Edit” link on the right side to edit information</li> <li>If you click on the “Edit” button, you can edit all the details of the client configuration</li> <li>From STEP 3, if you click on the “Create new configuration” link on top, you will be able to create a new client configuration providing all the relevant information<br> </li> </ol> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-11.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-11.png" alt="" width="300"></a></p> <p>Additionally, the Allowed Return URL has to be set to <shoproot>/moptPaymentAmazon</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-12.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-12.png" alt="" width="300"></a></p> <h5 class="h5Param">add new item</h5> <p>Add a new Amazon Pay configuration by clicking "Add item".</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-13.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-13.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" style="width: 55.3004%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 13.144%;">Field</th> <th class="payone-simpleTh" style="width: 86.856%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 13.144%;"> <p>Client</p> </td> <td class="payone-simpleTd" style="width: 86.856%;"> <p>The client ID from your Amazon Seller Central profile is automatically entered here after saving.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 13.144%;"> <p>Seller</p> </td> <td class="payone-simpleTd" style="width: 86.856%;"> <p>After saving, the seller ID from your Amazon Seller Central profile is automatically entered here.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 13.144%;"> <p>Button Typ</p> </td> <td class="payone-simpleTd" style="width: 86.856%;"> <p>Here you can select which button should be displayed in the shopping cart and in the sidebar.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 13.144%;"> <p>Button Farbe</p> </td> <td class="payone-simpleTd" style="width: 86.856%;"> <p>Here you can select in which color the button in the shopping cart and in the sidebar should be displayed.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 13.144%;"> <p>Amazon Modus</p> </td> <td class="payone-simpleTd" style="width: 86.856%;"> <p>Here you can select in which mode Amazon Pay transactions should be carried out:</p> <ul style="list-style: disc inside;"> <li><strong>Asynchronous On Failure (default)</strong> - The transaction is first tried in synchronous mode. This means that an attempt is made to obtain a direct confirmation from Amazon Pay for the transaction. If this is not possible, the asynchronous mode is tried. Amazon Pay confirms the transaction later when enough data is available. It may also be possible to reject the transaction at a later date. This is indicated in the payment status.</li> <li><strong>Always synchronous</strong> - The transaction is only tried in synchronous mode. If Amazon Pay rejects the transaction, the buyer receives immediate feedback and can choose another payment method.</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 13.144%;"> <p>Packstation mode</p> </td> <td class="payone-simpleTd" style="width: 86.856%;"> <p>Here you can define if "DHL Packstation" addresses are allowed when using Amazon Pay</p> </td> </tr> </tbody> </table> <div class="tryoutbox">Click "save" after you have defined your parameters.</div> <h5 class="h5Param">download Parameters</h5> <p>Download the current Client- and Seller IDs from the PAYONE platform by selecting the entry and clicking on "Download Configuration"</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-14.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-14.png" alt="" width="300"></a></p> <div class="tryoutbox">Make sure the checkbox is checked before clicking the button</div> <h5 class="h5Param">New Parameters visible</h5> <p>If everything went correctly, you should see your Client- and Seller ID in the table:</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-15.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-15.png" alt="" width="300"></a></p> <p>You can now configure the payment method as usual.</p> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Creditcard</span></div> <div class="responsesDivcontent"> <p></p> <p>Click on Customers → Payments → PAYONE → Payone Kreditkartenkonfiguration</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-16.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-16.png" alt="" width="300"></a></p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-17.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-17.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" style="width: 32.964%; height: 144px;"> <thead> <tr style="height: 39px;"> <th class="payone-simpleTh" style="width: 2.98507%; height: 39px;">Field</th> <th class="payone-simpleTh" style="width: 97.0149%; height: 39px;">Description</th> </tr> </thead> <tbody> <tr style="height: 18px;"> <td class="payone-simpleTd" style="width: 2.98507%; height: 18px;"> <p>Add item</p> </td> <td class="payone-simpleTd" style="width: 97.0149%; height: 18px;"> <p>Add more configurations</p> </td> </tr> <tr style="height: 87px;"> <td class="payone-simpleTd" style="width: 2.98507%; height: 87px;"> <p>Delete all selected</p> </td> <td class="payone-simpleTd" style="width: 97.0149%; height: 87px;"> <p>Delete selected entries</p> </td> </tr> </tbody> </table> <br> <p>Selecting Edit (pencil) or Add opens a window with the following parameters:<br> <br><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-18.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-18.png" alt="" width="300"></a> </p> <div> <table class="payone-simpleTable" style="width: 55.3293%; height: 422px;"> <thead> <tr style="height: 39px;"> <th class="payone-simpleTh" style="width: 24.0991%; height: 39px;">Field</th> <th class="payone-simpleTh" style="width: 75.9009%; height: 39px;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 24.0991%; height: 10px;"> <p>Integration type</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 10px;"> <ul style="list-style: disc inside;"> <li>hosted-iFrame (Strongly recommended!)</li> <li>AJAX</li> </ul> <div class="alertbox">Ensure that you always use "hosted iFrame". Only merchants with a PCI DSS certification level of SAQ A-EP or higher are allowed to use AJAX.</div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 24.0991%; height: 64px;"> <p>Shop</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 64px;"> <p>The title of the respective store</p> <div class="tryoutbox">Only one configuration is possible per store. </div> </td> </tr> <tr style="height: 78px;"> <td class="payone-simpleTd" style="width: 24.0991%; height: 10px;"> <p>Default</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 10px;"> <p>Determines whether the current configuration should be used as default.</p> </td> </tr> <tr style="height: 11px;"> <td class="payone-simpleTd" style="width: 24.0991%; height: 11px;"> <p>Merchant ID</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 11px;"> <p>Your Merchant ID</p> </td> </tr> <tr style="height: 78px;"> <td class="payone-simpleTd" style="width: 24.0991%; height: 10px;"> <p>Portal ID</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 10px;"> <p>The portal ID used for the transfer of the credit card data.</p> </td> </tr> <tr style="height: 78px;"> <td class="payone-simpleTd" style="width: 24.0991%; height: 10px;"> <p>Subaccount ID</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 10px;"> <p>The subaccount ID used for the transfer of credit card data.</p> </td> </tr> <tr style="height: 78px;"> <td class="payone-simpleTd" style="height: 10px; width: 24.0991%;"> <p>Key</p> </td> <td class="payone-simpleTd" style="height: 10px; width: 75.9009%;"> <p>The portal key used for the transfer of credit card data.</p> </td> </tr> <tr style="height: 66px;"> <td class="payone-simpleTd" style="height: 10px; width: 24.0991%;"> <p>live mode</p> </td> <td class="payone-simpleTd" style="height: 10px; width: 75.9009%;"> <p>Specifies whether the credit card data should be transferred in live mode.</p> </td> </tr> <tr style="height: 78px;"> <td class="payone-simpleTd" style="width: 24.0991%; height: 10px;"> <p>check creditcard CVC</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 10px;"> <p>Should the card verification number (CVC) be queried?</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 24.0991%; height: 160px;"> <p>minimum validity</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 160px;"> <p>Minimum validity in days that a card may still have in order to be ordered.</p> <div class="tryoutbox"><span>For retailers, this value may be just over the expiration period, so credits will still work even if the card has expired in the meantime.<br></span></div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 24.0991%; height: 78px;"> <p>Auto Credit Card Type Detection</p> </td> <td class="payone-simpleTd" style="width: 75.9009%; height: 78px;"> <p>Determines whether the customer is prompted to specify his card type or whether the card type should be automatically recognized by PAYONE.</p> </td> </tr> </tbody> </table> </div> <h5 class="h5Param">Using the automatic card type detection</h5> <p>Here you can see how our automatic detection of the card type works. This feature can help with conversion as the customer has fewer fields to consider. We also provide visual cues as to which brands are supported by the store.</p> <p>Without the automatic recognition, the customer must specify the card type of his credit card.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-19.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-19.png" alt="" width="300"></a></p> <p>When enabled, all configured credit card brand logos are loaded from our CDN and displayed above the card field. Our platform determines the brand used and highlights it while you enter the card number.</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-20.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-20.png" alt="" width="300"></a></p> <p>In case of an unknown number, a warning is displayed:</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-21.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-21.png" alt="" width="300"></a></p> <p>This case can occur if the customer enters a really wrong number, unsupported characters or a number from a very new BIN range. If the customer is sure of his card number, he can click on the icon of his brand to select the card type manually.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-22.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-22.png" alt="" width="300"></a></p> <p>If the customer wants to use a card that is not supported by the current store configuration, we display an error message and prompt the customer to use a supported card.</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-23.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-23.png" alt="" width="300"></a></p> <h5 class="h5Param">Field Configuration</h5> <p>Our plugin offers you compliance with the "lowest" compliance level according to PCI DSS (SAQ A). Since in this compliance level all credit card data may only be entered in fields hosted by a PCI DSS certified service provider, our plugin uses iFrames that are integrated into the checkout. However, these do not inherit the CSS of the store template, but contain their own style. You can use the following settings to customize these fields.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-24.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-24.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" style="width: 44.8371%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 2.25225%;">Field</th> <th class="payone-simpleTh" style="width: 97.7477%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Field type</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <ul style="list-style: disc inside;"> <li><strong>Numeric </strong>- Only numbers are allowed and the numeric keypad is used for mobile devices → input type="tel"</li> <li><strong>Password </strong>- input type="password"</li> <li><strong>Text </strong>- input type="text"</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Number of characters</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Number of characters in the width of the input field</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Maximum number of characters</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Maximum number of characters allowed</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>iFrame</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <ul style="list-style: disc inside;"> <li><strong>Standard </strong>- Uses width and height from the standard style</li> <li><strong>Custom </strong>- Uses width and height from the following fields</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>iFrame width</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Set the width in CSS</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>iFrame height</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Set the height in CSS</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Style</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <ul style="list-style: disc inside;"> <li><strong>Standard </strong>- Uses CSS specification from "Standard style"</li> <li><strong>Custom </strong>- Uses CSS specification of the following fields</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>CSS</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Specify the CSS to format the field in question.</p> <div class="tryoutbox">If you use the CSS attribute Url, the field in question is not displayed</div> </td> </tr> </tbody> </table> </div> <h5 class="h5Param">Default Style</h5> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-25.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-25.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" height="813" style="width: 82.9537%; height: 738px;"> <thead> <tr style="height: 39px;"> <th class="payone-simpleTh" style="width: 21.4286%; height: 39px;">Field</th> <th class="payone-simpleTh" style="width: 78.5714%; height: 39px;">Description</th> </tr> </thead> <tbody> <tr style="height: 312px;"> <td class="payone-simpleTd" style="width: 21.4286%; height: 312px;"> <p>Fields: input</p> </td> <td class="payone-simpleTd" style="width: 78.5714%; height: 312px;"> <p>Specification of CSS for the default formatting of all input fields.</p> <p>The following CSS can be used in the default Shopware template:</p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">Example</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>box-shadow:inset 0 1px 1px 1px #dadae5;background:#f8f8fa;border:1px solid #dadae5;border-top-color:#cbcbdb;line-height:19px;font-size:.875rem;width:85%;padding:.625rem .625rem .625rem .5625rem .625rem;color:#8798a9; </code></pre> </td> </tr> </tbody> </table> </div> <p></p> </td> </tr> <tr style="height: 305px;"> <td class="payone-simpleTd" style="width: 21.4286%; height: 305px;"> <p>Fields: selected</p> </td> <td class="payone-simpleTd" style="width: 78.5714%; height: 305px;"> <p>Specification of CSS for formatting all selection fields.</p> <p>The following CSS can be used in the Shopware default template:</p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">Example</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>box-shadow:inset 0 1px 1px 1px #dadae5;background:#f8f8fa;border:1px solid #dadae5;border-top-color:#cbcbdb;line-height:19px;font-size:.875rem;width:85%;padding:.625rem .625rem .625rem .5625rem .625rem;color:#8798a9; </code></pre> </td> </tr> </tbody> </table> </div> <p></p> </td> </tr> <tr style="height: 41px;"> <td class="payone-simpleTd" style="width: 21.4286%; height: 41px;"> <p>iFrame height</p> </td> <td class="payone-simpleTd" style="width: 78.5714%; height: 41px;"> <p>Default height specification in CSS for all fields.</p> </td> </tr> <tr style="height: 41px;"> <td class="payone-simpleTd" style="width: 21.4286%; height: 41px;"> <p>iFrame width</p> </td> <td class="payone-simpleTd" style="width: 78.5714%; height: 41px;"> <p>Default height specification in CSS for all fields.</p> </td> </tr> </tbody> </table> <h5 class="h5Param">Default Translation and Error output</h5> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-26.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-26.png" alt="" width="300"></a> <p></p> </div> <div> <table class="payone-simpleTable" style="width: 46.0467%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 31.8996%;">Field</th> <th class="payone-simpleTh" style="width: 68.1004%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 31.8996%;"> <p>Active</p> </td> <td class="payone-simpleTd" style="width: 68.1004%;"> <p>Activates the error output</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 31.8996%;"> <p>custom error messages</p> </td> <td class="payone-simpleTd" style="width: 68.1004%;"> <p>You can enter your own error messages here</p> </td> </tr> </tbody> </table> </div> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">PAYONE Direct Debit</span></div> <div class="responsesDivcontent"> <p></p> <p>If you use the payment method "PAYONE Lastschrift", be sure to specify the countries from which you want to draw direct debits in the country selection. If you do not select a country, the payment method will be displayed to all customers. This can confuse customers from non-SEPA countries. Also, the account country selection list in the checkout will be empty.</p> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Apple Pay</span></div> <div class="responsesDivcontent"> <p></p> <p>Under Customer → Payments → PAYONE Kontrollzentrum → Konfiguration → Grundeinstellungen → Allgemein</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-27.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-27.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" style="width: 54.0786%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 2.25225%;">Field</th> <th class="payone-simpleTh" style="width: 97.7477%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Apple Pay Merchant Id</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>This value can be taken from the Apple Developer Portal as "Identifier" of your Merchant ID:</p> <p></p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-28.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-28.png" alt="" width="300"></a></p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>allow Apple Pay Visa</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Indicates whether Visa cards are allowed for payment with Apple Pay. Please only select the card types here that are also part of your PAYONE contract.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>allow Apple Pay Mastercard</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Indicates whether Mastercard cards are allowed for payment with Apple Pay. Please only select the card types here that are also part of your PAYONE contract.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>allow Apple Pay Girocard</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Indicates whether Girocard cards are allowed for payment with Apple Pay. Please only select the card types here that are also part of your PAYONE contract.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Apple Pay certificate</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Please upload your Apple Pay Merchant Identification Certificate (in .pem format) here.</p> <div class="alertbox">Make sure that the certificate is not publicly accessible and can only be read by Shopware. Your hoster or server administrator can answer any questions you may have.</div> <p> </p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Apple Pay private key</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Please upload your Apple Pay Private Key (in .key format) here.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Apple Pay private key password</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>Here you can set the password for using the private key.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 2.25225%;"> <p>Apple Pay Debug</p> </td> <td class="payone-simpleTd" style="width: 97.7477%;"> <p>If this field is active, debug information about the Apple Pay session is displayed in the checkout, which can be helpful when setting up Apple Pay. This option should be deactivated in live operation</p> </td> </tr> </tbody> </table> </div> <div class="tryoutbox"> <p>In addition to the configuration in Shopware, it is also necessary to set up the corresponding certificates to operate Apple Pay as a payment method. You can find notes on this here: Special Remarks - Apple Pay</p> <p>In addition, Apple requires the validation of the store domain for Apple Pay. To do this, follow the instructions in the Apple Developer Portal:</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/45112abd826dc8011bfb22b25862bd34/Magento2-11.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/45112abd826dc8011bfb22b25862bd34/thumbnails/Magento2-11.png" alt="" width="200"></a></p> </div> </div> <h5></h5> <h5 class="h5Header">Payment methods setup</h5> <p>When you install the PAYONE plugin, all available PAYONE payment types are automatically created in your store. For easier identification, they are created with the prefix "PAYONE". However, you can easily change this by changing the name of the payment type.</p> <p>Activate the desired payment methods under Configuration → Payment Methods</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-29.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-29.png" alt="" width="300"></a></p> <h5 class="h5Header">Editing the orders</h5> <p>The PAYONE plugin sets the payment status of an order according to the set status assignment.</p> <h5 class="h5Param">Capture</h5> <p>Under Customers → Orders you can enter pre-authorized orders. To do this, you need to edit the respective order by clicking on the pen.<br> <br><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-30.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-30.png" alt="" width="300"></a></p> <p>The items to be captured must be marked (checkmarked) and then confirmed with the "capture position" button.<br> <br> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-31.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-31.png" alt="" width="300"></a></p> <p>Check the amount again. Decide whether the shipping costs should also be collected. After clicking on (partial) money collection, the money will be collected and the receivable will be booked on the PAYONE platform.<br> <br><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-32.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-32.png" alt="" width="300"></a></p> <p>For a partial withdrawal, simply add a new identical item to the item and specify the quantity of items you wish to withdraw. Make sure, however, that the original position is reduced in terms of quantity. Use the button final capture to mark the order as completely captured. Where supported, the claim may be reduced by the payment method provider and remaining reservations will be dismissed.</p> <h5 class="h5Param">Refund</h5> <p>Under Customers → Orders you can create credit notes. To do this, you need to edit the respective order by clicking on the pen.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-33.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-33.png" alt="" width="300"></a></p> <p>In the following order details you will find on the sheet Positions the "debt position" button.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-34.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-34.png" alt="" width="300"></a></p> <p>The items to be refund must be marked (checkmarked) and then confirmed with the "debt position" button.<br> <br><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-35.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-35.png" alt="" width="300"></a></p> <h5 class="h5Header">Marking of conspicuous orders</h5> <p>If there are discrepancies in an order, the order will be marked with the status "Verification required". In this case, the amount in Shopware 5 should be checked with the amount in PAYONE Merchant Interface (PMI), as this could be a fraud attempt. </p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-36.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-36.png" alt="" width="300"></a></p> <h5 class="h5Header">Extended configurations</h5> <p>Here you will find separate setting options that allow you to customize our plugin more precisely to your needs.</p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Address check</span></div> <div class="responsesDivcontent"> <p></p> <div class="tryoutbox">You can use the following options only if you have ordered the Protect module from PAYONE. The use of address checks is associated with variable costs per transaction, which you will see in the contract.</div> <p>Under Customers → Payments → PAYONE → Konfiguration → sheet "adress check" you can define if and in which form the address checks should be performed and how the Shopware eShop should behave if certain results apply.</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-37.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-37.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" style="width: 55.6983%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 19.8198%;">Field</th> <th class="payone-simpleTh" style="width: 80.1802%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>active</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>Activates the address check</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>operating mode<br> </p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>Setting in which mode the address check should take place: in test or live.</p> <div class="tryoutbox">Test and live data are different. Test data can only be used in test mode.</div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>billing address</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <ul style="list-style: disc inside;"> <li><strong>Do not check</strong> - No address check is performed</li> <li><strong>Basic </strong>- Address check for existence (street number, postcode, city, country) as well as addition and correction of address (possible for addresses from Germany, Austria, Switzerland, Netherlands, Belgium, Luxembourg, France, Italy, Spain, Portugal, Denmark, Sweden, Finland, Norway, Poland, Slovakia, Czech Republic, Hungary, USA, Canada).</li> <li><strong>Person </strong>- Checking whether the person is known at the address given, checking the existence of the address and supplementing and correcting the address (Germany only).</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>shipping address</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>(see billing address)</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>auto correct</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>If <strong>Yes </strong>is selected, an address corrected by the PAYONE platform will be adopted. Not otherwise. In addition, there are options here that the user can agree to a correction or be prompted to enter the address again.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>error handling</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>Here you can define what should happen if there is a technical error. For example, the address validation is not available or reachable.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>minimum basket value</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>Shopping cart value from which an address check is performed</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>maximum basket value</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>Shopping cart value until an address check is performed</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>validity in days</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>The duration in days for registered users in the shop for which the result of the verification is valid.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>error message<br> </p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>Here you can define which message is displayed to the user if an incorrect entry has been made.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 19.8198%;"> <p>Person Status Mapping</p> </td> <td class="payone-simpleTd" style="width: 80.1802%;"> <p>Below are listed the individual possible results of address verification person to whom you can assign each of the traffic light values:</p> <ul style="list-style: disc inside;"> <li>red</li> <li>yellow</li> <li>green</li> </ul> <p>to the other. In conjunction with the setting in the Risk area, this means that payment types are not available to the customer or are hidden by this traffic light value.</p> </td> </tr> </tbody> </table> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Credit assesment</span></div> <div class="responsesDivcontent"> <p></p> <div class="tryoutbox">You can use the following options only if you have ordered the Protect module from PAYONE. The use of credit checks is associated with variable costs per transaction, which you will see in the contract.</div> <div> <div class="tryoutbox">Please make the settings for the credit check carefully. The credit check is performed after the personal data has been entered and influences the payment types that are offered to your customers in the checkout process. You should only use the credit check for payment types that pose a risk of non-payment for you (e.g. open invoices or direct debits). You configure this via the Traffic Light Value / Score setting in the configuration of the respective payment type. In addition, you should indicate in your store in a suitable manner that you carry out the credit check via infoscore Consumer Data GmbH.</div> <p>Under Customers → Payments → PAYONE → Konfiguration → sheet "credit assesment" you can specify whether and in what form the credit checks should be performed and how the Shopware eShop should behave if certain results apply.<br> <br><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-38.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-38.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" style="width: 60.8653%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 14.9318%;">Field</th> <th class="payone-simpleTh" style="width: 85.0682%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>active</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Activates the credit check</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>operating mode</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Setting in which mode the address check should take place: in test or live.</p> <div class="tryoutbox"><span>Test and live data are different. Test data can only be used in test mode.<br></span></div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>check timing</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Select the time of the check here.</p> <div class="tryoutbox">This setting only applies if the value "Alle (global)" is selected for "Applies to payment type".</div> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>check type B2C</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <ul style="list-style: disc inside;"> <li><strong>Infoscore (hard characteristics)</strong> - Check for hard characteristics via Infoscore (e.g. consumer insolvency proceedings, arrest warrant for affidavit or enforcement of affidavit)</li> <li><strong>Infoscore (all characteristics)</strong> - Examination for so-called "hard" negative features (see above) and "medium" negative features (e.g. order for payment order, enforcement order or enforcement) and "soft" negative features (e.g. collection dunning procedure initiated, continuation of out-of-court collection dunning procedure after partial payment, discontinuation of out-of-court collection dunning procedure due to hopelessness)</li> <li><strong>Infoscore (all characteristics + Boniscore)</strong> - Checking for all characteristics (see above) and delivery of the BoniScore, which as a score value enables a higher selectivity for existing negative characteristics.</li> <li><strong>Boniverse VERITA Score</strong> - Check for VERITA-Scores via Boniversum</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>check type B2B</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Determines whether corporate customers are to be checked. The definition is based on the selection of the end customer during registration or checkout. ("I am a private customer/business customer") </p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>default score for new customers</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Here you can define the traffic light value for new customers.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>Boniversum unknown</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Here you can define the traffic light value for customers who are unknown to Boniversum (only applies when using the check type "Boniversum").</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>validity in days</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Number of days for which the credit standing value returned is valid. No new credit checks will be carried out for the set period for the registered shop buyer / user concerned until the set period expires.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>minimum basket value</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Shopping cart value from which a credit check is carried out.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>maximum basket value</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Shopping cart value until a credit check is carried out.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>error handling</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Here you can define what should happen if a technical error occurs. For example, the credit assessment is not available or attainable.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>notification message</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Enter here the text to be displayed to the buyer when a credit check is performed for him.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 14.9318%;"> <p>consent question</p> </td> <td class="payone-simpleTd" style="width: 85.0682%;"> <p>Enter here the text of the question that will be asked to the customer to agree to a credit check.</p> </td> </tr> </tbody> </table> <div class="alertbox">Please make the settings for the credit check carefully. Incorrect configurations can lead to errors in the checkout process and unwanted costs due to an increased number of queries and an unnecessarily high risk of non-payment.</div> </div> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Paymentstatus </span></div> <div class="responsesDivcontent"> <p></p> <p>Under Customers → Payments → PAYONE → Konfiguration → sheet "Paymentstatus" you can define which status the order should have in Shopware</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-39.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-39.png" alt="" width="300"></a></p> <div> <div class="tryoutbox">For more information about transaction state callbacks, see this page of our server API documentation.</div> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Forward the transaction status</span></div> <div class="responsesDivcontent"> <p></p> <p>Under Customers → Payments → PAYONE → Konfiguration → sheet "forward the transaction status" you can, if required, assign a separate forwarding URL to each payment status message of the PAYONE platform (transaction status). This is always necessary if other systems in your system environment also require this payment information.</p> <p></p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-40.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-40.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" style="width: 52.5374%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 23.0769%;">Field</th> <th class="payone-simpleTh" style="width: 76.9231%;">Description</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 23.0769%;"> <p>Logging</p> </td> <td class="payone-simpleTd" style="width: 76.9231%;"> <p>Enables logging for the transaction status forwarding log.</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 23.0769%;"> <p>Timeout</p> </td> <td class="payone-simpleTd" style="width: 76.9231%;"> <p>Response time in milliseconds until termination</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 23.0769%;"> <p>Timeout increase<br> </p> </td> <td class="payone-simpleTd" style="width: 76.9231%;"> <p>Increase timeout in milliseconds for the next attempt</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 23.0769%;"> <p>max. Tries</p> </td> <td class="payone-simpleTd" style="width: 76.9231%;"> <p>Maximum attempts to forward until aborted</p> </td> </tr> </tbody> </table> <p></p> <p>If the Logging is enabled, errors in forwarding of transaction status messages are displayed in a separate system log. You can then view and download the current logs under Configuration → Logfile → sheet "System Log".</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-41.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-41.png" alt="" width="300"></a></p> <div> <table class="payone-simpleTable" style="width: 58.0746%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 28.5714%;">Log Eintrag</th> <th class="payone-simpleTh" style="width: 35.7143%;">When?</th> <th class="payone-simpleTh" style="width: 85.7143%;">Meaning</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>notification controller called</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>always</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>Information value only - marks the start of txstatus processing</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>different shop active, submitted id, new shopid [1,2,2]</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>active shop has a different ID than the shop that's referred to in the request</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>1,2,2 means:</p> <ul style="list-style: disc inside;"> <li>active shop has ID 1</li> <li>Request refers to shop ID 2</li> <li>tx status processing therefore uses shop ID 2</li> </ul> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>push received for tx 123456789</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>always</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>txid der txstatus-Anfrage</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>clearingdata already exists</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>if a transaction already has clearing data attached to it</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>info - clearing data doesn't get overwritten</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>clearingdata is empty</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>if a transaction doesn't have yet clearing data attached to it</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>info - clearing data from the txstatus request is attached to the transaction</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>save attribute data</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>always</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>info - data gets saved as attributes to an order</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>finished, output TSOK</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>always</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>processing finished - TSOK is being sent</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>starting tx forwards</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>always</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>info - txstatus gets forwarded now</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 28.5714%;"> <p>finished all tasks, exit</p> </td> <td class="payone-simpleTd" style="width: 35.7143%;"> <p>always</p> </td> <td class="payone-simpleTd" style="width: 85.7143%;"> <p>info - clearing data from the txstatus request is attached to the transaction</p> </td> </tr> </tbody> </table> </div> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">API- and Transaktionsstatus-Log</span></div> <div class="responsesDivcontent"> <p></p> <p>Under Customers → Payments → PAYONE → API-Log you will find all information about the processed payments and communication with the PAYONE platform.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-42.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-42.png" alt="" width="300"></a></p> <p>The overview shows all received and processed requests to the PAYONE platform. By clicking on an entry, you can view details about the respective request.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-43.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-43.png" alt="" width="300"></a></p> <p>Under Customers → Payments → PAYONE → Transaktionsstatus-Log you have an overview of the transaction status messages received and can view details by clicking on a record.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-44.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-44.png" alt="" width="300"></a></p> </div> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Integrate clearing data into HTML and PDFs</span></div> <div class="responsesDivcontent"> <p></p> <p>The clearing data is stored in the s_order_attributes table in the mopt_payone_clearing_data column in JSON format. The orderID column contains the ID of the corresponding order stored in the s_order table. The data can be read, for example, with the following SQL statement:</p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">Sample Query<br></span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>SELECT JSON_PRETTY(mopt_payone_clearing_data) FROM s_order_attributes WHERE orderID = <orderID> Ausgabe: { "clearing_txid": "822243227", "clearing_bankbic": "DEUTDEHH210", "clearing_bankcity": "Kiel", "clearing_bankcode": "21070020", "clearing_bankiban": "DE87210700200022520120", "clearing_bankname": "Deutsche Bank AG", "clearing_bankaccount": "0022520120", "clearing_bankcountry": "DE", "clearing_bankaccountholder": "PAYONE GmbH" }</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <h5 class="h5Param">Display prepayment clearing data in the email template.</h5> <p>All email templates can be customized under Settings → Email Management → Email Templates. The order confirmation email template can be found under System emails → sORDER.</p> <p>There are 2 templates: one for text emails and one for HTML emails.</p> <p>The translations of the two templates must be adjusted via the globe button in the upper right corner.</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-45.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-45.png" alt="" width="300"></a></p> <h5 class="h5Param">Customize Text Email Template</h5> <p>You can customize the templates depending on the payment method you use. To customize the templates, you need to use the internal name of the payment method used. You can find the names in the payment methods overview:</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-46.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-46.png" alt="" width="300"></a></p> <p>To add transfer information to the template for the PAYONE Prepayment payment type, please find the following block in the template source code.</p> <p>Here 2 text boxes, one for TEXT and one for HTML: </p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">Text</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "prepayment"} Unsere Bankverbindung: {config name=bankAccount} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">HTML</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "prepayment"} Unsere Bankverbindung:<br/> IBAN: ###<br/> BIC: ###<br/> {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p>And add the following block after it:</p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">DE Text</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "mopt_payone__acc_payinadvance"} {if $additional.moptPayoneClearingData} Unsere Bankverbindung: Kontoinhaber: {$additional.moptPayoneClearingData.clearing_bankaccountholder} IBAN: {$additional.moptPayoneClearingData.clearing_bankiban} BIC: {$additional.moptPayoneClearingData.clearing_bankbic} Bank: {$additional.moptPayoneClearingData.clearing_bankname} Referenz: {$additional.moptPayoneClearingData.clearing_txid} {/if} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">DE HTML<br></span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "mopt_payone__acc_payinadvance"} {if $additional.moptPayoneClearingData} Unsere Bankverbindung:<br/> Kontoinhaber: {$additional.moptPayoneClearingData.clearing_bankaccountholder}<br/> IBAN: {$additional.moptPayoneClearingData.clearing_bankiban}<br/> BIC: {$additional.moptPayoneClearingData.clearing_bankbic}<br/> Bank: {$additional.moptPayoneClearingData.clearing_bankname}<br/> Referenz: {$additional.moptPayoneClearingData.clearing_txid}<br/> {/if} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">EN Text</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "mopt_payone__acc_payinadvance"} {if $additional.moptPayoneClearingData} Our bank details: Account holder: {$additional.moptPayoneClearingData.clearing_bankaccountholder} IBAN: {$additional.moptPayoneClearingData.clearing_bankiban} BIC: {$additional.moptPayoneClearingData.clearing_bankbic} Bank: {$additional.moptPayoneClearingData.clearing_bankname} Reference: {$additional.moptPayoneClearingData.clearing_txid} {/if} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">EN HTML<br></span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "mopt_payone__acc_payinadvance"} {if $additional.moptPayoneClearingData} Our bank details:<br/> Account holder: {$additional.moptPayoneClearingData.clearing_bankaccountholder}<br/> IBAN: {$additional.moptPayoneClearingData.clearing_bankiban}<br/> BIC: {$additional.moptPayoneClearingData.clearing_bankbic}<br/> Bank: {$additional.moptPayoneClearingData.clearing_bankname}<br/> Reference: {$additional.moptPayoneClearingData.clearing_txid}<br/> {/if} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p>To add remittance information to the template for the PAYONE Open Invoice payment type, add the following block after it:</p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">DE Text</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "mopt_payone__acc_invoice"} Unsere Bankverbindung: {config name=bankAccount} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">DE HTML</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "mopt_payone__acc_invoice"} Unsere Bankverbindung::<br/> {config name=bankAccount} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">EN Text</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "mopt_payone__acc_invoice"} Our bank details: {config name=bankAccount} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">EN HTML</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{if $additional.payment.name == "mopt_payone__acc_invoice"} Our bank details:<br/> {config name=bankAccount} {/if}</code></pre> </td> </tr> </tbody> </table> </div> <p></p> <h5 class="h5Param">Extend PDF Templates</h5> <p>In order to display the clearing data on PDF documents, the JSON-encoded content of the corresponding variables must first be decoded. This is done in the .tpl file for the invoice (or similar) for your template:</p> <div class="samplebox responsesDIV"> <div class="sampleboxheader sbflex-big"><span class="sampleboxhtext has-text-white">Bankdaten</span></div> <button type="button" class="payone-copy-text button payone-is-tiny btn-primary sbflex"> <span class="icon-text"> <span class="icon payone-is-tiny"> <i class="payone-copy-outline"></i> </span> <span>Copy</span> </span> </button> <button class="btn-primary button payone-is-tiny sbflex" aria-expanded="false"> <svg class="svg-Up svg2" version="1.1" viewbox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true" style="fill: currentColor;"> <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon> </svg><span>expand</span> </button> <table class="samplecodebox sbflex-full"> <tbody> <tr style="height: 179px;"> <td> <pre class="language-markup"><code>{assign var=mopt_payone_decoded_clearing_data value=$Order._order.attributes.mopt_payone_clearing_data|json_decode:true}</code></pre> </td> </tr> </tbody> </table> </div> <p>These and other variables are then available:</p> <div> <table class="payone-simpleTable" style="width: 58.997%;"> <thead> <tr> <th class="payone-simpleTh" style="width: 50.8787%;">Content</th> <th class="payone-simpleTh" style="width: 49.1213%;">Variable</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd" style="width: 50.8787%;"> <p>Recipient</p> </td> <td class="payone-simpleTd" style="width: 49.1213%;"> <p>{$mopt_payone_decoded_clearing_data.clearing_bankaccountholder}</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 50.8787%;"> <p>IBAN</p> </td> <td class="payone-simpleTd" style="width: 49.1213%;"> <p>{$mopt_payone_decoded_clearing_data.clearing_bankiban}</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 50.8787%;"> <p>BIC</p> </td> <td class="payone-simpleTd" style="width: 49.1213%;"> <p>{$mopt_payone_decoded_clearing_data.clearing_bankbic}</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 50.8787%;"> <p>Bank</p> </td> <td class="payone-simpleTd" style="width: 49.1213%;"> <p>{$mopt_payone_decoded_clearing_data.clearing_bankname}</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 50.8787%;"> <p>Clearing Reference</p> </td> <td class="payone-simpleTd" style="width: 49.1213%;"> <p>{$mopt_payone_decoded_clearing_data.clearing_reference}</p> <p>{$mopt_payone_decoded_clearing_data.clearing_txid}</p> <p>{$attributes.mopt_payone_txid}</p> <p>{$sBookingID}</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 50.8787%;"> <p>Invoice gross amount</p> </td> <td class="payone-simpleTd" style="width: 49.1213%;"> <p>{$Order._order.invoice_amount}</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 50.8787%;"> <p>Invoice net amount</p> </td> <td class="payone-simpleTd" style="width: 49.1213%;"> <p>{$Order._order.invoice_amount_net}</p> </td> </tr> <tr> <td class="payone-simpleTd" style="width: 50.8787%;"> <p>List all variables (for debugging purposes)</p> </td> <td class="payone-simpleTd" style="width: 49.1213%;"> <p>{$mopt_payone_decoded_clearing_data|print_r}</p> </td> </tr> </tbody> </table> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Risk Management</span></div> <div class="responsesDivcontent"> <div class="tryoutbox">In order to use the risk management services, the Protect module of the PAYONE platform must be put into operation.</div> <div> <div class="tryoutbox">Die Plausibilitäts- und Gültigkeitsprüfung von Bankkontoverbindungen (Bankkontoprüfung) und Kreditkartennummern mittels LUHN-Prüfung (Kreditkartenprüfung) wird unabhängig von den Funktionalitäten des Protect-Moduls bei der Abwicklung von Zahlungen per Lastschrift und Kreditkarte eingesetzt.</div> <div> <div class="tryoutbox">Darüber hinaus können weitere Risikomanagement-Services zur Betrugsprävention über die PAYONE Plattform genutzt werden (IP Check, BIN Check, Velocity Check, Risk Matrix, etc.).</div> <h5 class="h5Param">Creditworthiness-dependent management of the payment portfolio</h5> <p>With the PAYONE plugin for Shopware, you can control which payment methods are offered to your customers depending on their creditworthiness. The check takes place in real time for each individual buyer during the checkout process.</p> <p>The settings can be defined differently for each payment type, so that risk checks are only performed under certain conditions and a payment type is only offered under certain conditions.</p> <p>By installing the PAYONE plugin, the conditions of the traffic light value were added to the existing rules.</p> <p>Under Configuration → Risk management you can determine whether a payment type is blocked based on a defined traffic light value.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-47.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-47.png" alt="" width="300"></a></p> </div> </div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Shipping Costs</span></div> <div class="responsesDivcontent"> <p>To ensure smooth operation of the plug-in, it is necessary to assign shipping rates to each payment method. As a further option, you can define an alternative shipping type that always takes effect if no concrete shipping cost record is assigned to a payment type.</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-48.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-48.png" alt="" width="300"></a></p> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Customizing snippets</span></div> <div class="responsesDivcontent"> <p>For the display of certain texts, text modules have been provided with the installation of the plug-in, which you can adapt according to the language used in each case. You find the administration of the snippets under Configuration → Snippets.</p> <p> <a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-48.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-48.png" alt="" width="300"></a></p> <p>All text output (except bank names, e.g. with iDeal) in the frontend is provided via text modules, so that there is the greatest possible flexibility when using several languages. According to the Shopware standard, the text modules are initialized and stored in the database the first time they are used. They are then editable. The most important components are already stored during the installation of the plug-in. To edit specific text modules, you may first have to call the corresponding page in the frontend.</p> <p>The text frame for the PAYONE plug-in can be found in the namespace frontend/MoptPaymentPayone. There is a general error message "generalErrorMessage" that is used when no specific error message is available. Specific error messages can be configured for individual error codes from the PAYONE platform. The text module for an error number 888 is then called "errorMessage888". Exceptions to this are the check of the bank details and the address, since no numerical error codes are returned there. The text modules for this are called "bankaccountcheck-blocked" or "addresscheckcorrected".</p> <p>For technical reasons, only a few individual elements of the checkout can be processed directly in the templates. These templates can be found at:</p> <p>/engine/Shopware/Plugins/Default/Frontend/MoptPaymentPayone/ViewsResponsive/frontend/plugins/payment</p> <p>in the Shopware directory. </p> <div class="tryoutbox">Please ensure to always clear the shop caches after any alterations!</div> </div> <p></p> <div class="is-relative"><a href="#/" class="my_plus my_radius"></a><span class="OptionalsSpan">Duplicate payment method<span></span></span></div> <div class="responsesDivcontent"> <p></p> <p>Under Configuration → Payment methods you can copy the payment methods for separate use, with a subshop or other reasons such as country assignments.</p> <p><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-50.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-50.png" alt="" width="300"></a></p> <p>After duplication, you can give the payment type a different name and assign it to a country or even to another subshop.</p> <div class="tryoutbox">Please do not change the name of the payment type (here mopt_payone__cc_visa), because it is needed for using the correct routines. After duplication, a numeric suffix is appended to the name, which is necessary for the uniqueness of the names.</div> <div><a href="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-51.png" target="_blank" rel="noopener"><img src="https://docs.payone.com/bl-content/uploads/pages/6b844046cb57e07363353c5c8bae75d0/Shopware5-51.png" alt="" width="300"></a></div> </div> </div> </div> </section>  <script src="https://docs.payone.com/bl-kernel/js/jquery.min.js?version=3.15.0"></script> <script src="https://docs.payone.com/bl-themes/payone-docs/js/highlight.min.js?version=3.15.0"></script> <script src="https://docs.payone.com/bl-themes/payone-docs/js/jquery-resizable.js?version=3.15.0"></script> <script src="https://docs.payone.com/bl-themes/payone-docs/js/payone.misc.js?version=3.15.0"></script> <script src="https://docs.payone.com/bl-themes/payone-docs/php/api/jquery.json-editor.min.js?version=3.15.0"></script> <script src="https://docs.payone.com/bl-themes/payone-docs/php/api/stickyNavigator.js?version=3.15.0"></script> <script src="https://docs.payone.com/bl-themes/payone-docs/php/api/autosize.js?version=3.15.0"></script> <script> hljs.initHighlighting(); </script> <script> autosize(document.querySelectorAll('.codetext')); </script> <script> $(function() { /***************************************** PHP generated Sidebar Add Active Navigation Class Based on URL *****************************************/ const browserPath = (location.pathname).slice(1); $('ul.tree li a').each(function(){ var $this = $(this); // We need to extract path from anchor href, so we can do exact comparision const checkLink = $this.attr('href'); const extractedPathWithDomain = checkLink.replace(/http(s)?(:)?(\/\/)?|(\/\/)/g, ''); const pathParts = extractedPathWithDomain.split('/'); pathParts.shift(); const extractedPath = pathParts.join('/'); if(browserPath === extractedPath) { $this.parent().addClass('is-active'); $this.parent().children('ul').show() } // for localhost only // or (window.location.hostname === "localhost" && window.location.pathname==="/bludit/") if (window.location.pathname==="/bludit-commercetools/") { $this.parent().removeClass('is-active'); } }); /************************ Sidebar SVG icon ************************/ jQuery('.svgCl').each(function(){ jQuery(this).css({'height': $(this).closest('ul').height($(this).height() + 5) + 'px'}); jQuery(this).css({'display': 'inline-block'}); }); /************************ Sidebar Nav items toggle open/close ************************/ $( 'ul.tree li' ).each( function() { if($(this).children('ul').length > 0) { $(this).addClass('parentLi'); $('li.parentLi > a').attr('href'); } if ($(this).find('ul > li').hasClass('is-active')) { $(this).addClass('activated'); $(this).children('ul').show(); // ul > display:none is hardcoded in sidebar.php } }); $( 'ul.tree li > ul > li' ).each( function() { $(this).addClass('parentLi'); if ($(this).hasClass('is-active')) { $(this).addClass('activated'); } }); }); // doc ready </script> <script> /************************ Copy to clipboard ************************/ function copyToClipboard(text) { var aux = document.createElement("input"); aux.setAttribute("value", text); document.body.appendChild(aux); aux.select(); document.execCommand("copy"); document.body.removeChild(aux); } function copyToClipboardAsFormatted(text) { navigator.clipboard.writeText(text); } function stripHtml(inputHtml) { const brToNewline = inputHtml.replace(/<br\s*[\/]?>/gi, "\n"); const content = brToNewline.replace(/<\/?[^>]+(>|$)/g, ""); return content; } $(function() { $( ".payone-copy-text" ).on( "click", function() { const currentCopyBtn = $(this); let parentNode = currentCopyBtn.closest('div.divcopybtn'); let payloadbox; if (parentNode.length > 0) { payloadbox = parentNode.next('div.payloadbox'); } else { parentNode = currentCopyBtn.closest('div.samplebox'); parentNode = parentNode.children('table'); parentNode = parentNode.children('tbody'); parentNode = parentNode.children('tr'); payloadbox = parentNode.children('td'); } if (payloadbox.length == 0) { return; } const preNode = payloadbox.children('pre'); const htmlContent = preNode.html(); const content = stripHtml(htmlContent); copyToClipboardAsFormatted(content); }); }); $(function() { $("h2").click(function() { var id = $(this).attr("id"); var permalink = "https://docs.payone.com/integration/plugins/integration-guide-shopware-5"; var link = permalink+"#"+id; copyToClipboard(link); }); }); // doc ready </script> <script> /************************ Sticky navbar ************************/ // Declare the function first var myFunction; // When the user scrolls the page, assign myFunction window.onscroll = function() { if (typeof myFunction === "function") { myFunction(); } }; // Get the navbar var navbar = document.getElementById("subnavbar"); // Check if the navbar exists if (navbar) { // Get the offset position of the navbar var sticky = navbar.offsetTop; // Define the function myFunction = function() { if (window.scrollY >= sticky) { navbar.classList.add("sticky"); } else { navbar.classList.remove("sticky"); } }; } </script> <script src="https://docs.payone.com/bl-themes/payone-docs/php/api/api-template.js?version=3.15.0"></script>  </div> </div> <div class="site_footer" id="footcontainer"> <footer class="footer site-footer">  <div class="container">  <div class="footer-column"> <h3 class="h3Footer">PAYONE</h3> <ul> <li><a href="https://www.payone.com/DE-de/agb">Terms and Conditions</a></li> <li><a href="https://www.payone.com/DE-de/impressum">Legal Notice</a></li> <li><a href="/information/privacy-policy">Privacy Policy</a></li> <li><a href="https://www.payone.com/DE-de/ueber-uns/presse">Press</a></li> </ul> </div>  <div class="footer-column"> <h3 class="h3Footer">Service</h3> <ul> <li><a href="https://www.payone.com/DE-de/service/kundenportale">Customer Portals</a></li> <li><a href="https://www.payone.com/DE-de/ueber-uns/partner">Partner</a></li> <li><a href="https://github.com/PAYONE-GmbH">Github</a></li> <li><a href="https://www.payone.com/DE-de/service/downloads">Downloads</a></li> <li><a href="https://www.payone.com/DE-de/service/kontakt">Contact</a></li> <li><a href="https://www.payone.com/DE-de/service/feedback-beschwerde">Feedback</a></li> </ul> </div>  <div class="footer-column"> </div>  <div class="footer-column-social">  <div class="social-links" style="width: 100%;justify-content: space-evenly;"> <p> <a href="https://www.instagram.com/payone_gmbh/" style="padding: 5px;"> <i class="payone-icon-medium payone-black-instagram"></i></a> <a href="https://www.linkedin.com/company/payone_gmbh" style="padding: 5px;"> <i class="payone-icon-medium payone-black-linkedin"></i></a> <a href="https://www.facebook.com/PAYONEGmbH/"><i class="payone-icon-medium payone-black-facebook"></i></a> <a href="https://github.com/PAYONE-GmbH/" style="padding: 5px;"> <i class="payone-icon-medium payone-black-github"></i></a> <a href="https://www.youtube.com/channel/UCM7Eky84PKzkyTILI6xga-Q" style="padding: 5px;"> <i class="payone-icon-medium payone-black-youtube"></i></a> </p> </div> </div> <div class="footer-column-copyright">  <div class="footer-powered-copyright"> <p ><span style="font-size:13px;">© PAYONE GmbH, Powered by <a target="_blank" class="text-white" href="https://www.bludit.com">Bludit</a></span></p> </div> </div> <div class="footer-column-worldline">  <div class="logo-text"> <img src="//media3.payone.com/f/64176/4200x387/933f1413c4/payone_worldline_endorsement_dunkelgrau.png" alt="" style="max-width:200px;"> </div> </div> </div> </footer> </div> <button id="backToTopBtn" title="Go to page start"></button> </body> </html>