PAYONE Documentation Platform | Client API

<!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 | Client API - Managemandate </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/channel-client-api/client-api-managemandate"/>  </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/channel-client-api">Channel-Client-API</a></li><li class="is-active"><a href="/integration/channel-client-api/client-api-managemandate">Client API - Managemandate</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"> <h3>Introduction</h3> <div class="payone-white-content-section"> <p>Create a pending mandate – used for SEPA Direct Debit.</p> <p>Mandate will be activated and persisted by a payment-request (preauthorization / authorization) or by customer management (updateuser) – this request has to follow a “managemandate”-request within 2 hours.<span style="font-weight: 400; text-align: inherit;">.</span></p> </div> <h3>Overview</h3> <div class="payone-white-content-section"> <table style="border-collapse: collapse; width: 94.1131%;"> <tbody> <tr style="height: auto; vertical-align: top; padding: 10px;"> <th style="width: 25%;"> <p><strong>Debit payment</strong></p> </th> <td style="width: 75%;"> <p>Create a pending mandate</p> </td> </tr> </tbody> </table> </div> <div class="payone-white-content-section"> <div class="columns api-content" title="requestpayment"> <div class="column is-two-thirds middleAC"> <pre class="full-pre mb-3 "><span class="typ ">POST</span> Request - managemandate</pre> <h5 class="h5Param">Account Parameters</h5> <table title="account_parameter" class="ac-isParent"> <tbody> <tr title="request"> <td class="ac-isParentTD pTDa" title="request"><span class="sLborder"></span>request <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Fixed Value: managemandate</span></div> </td> </tr> <tr title="mid"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>mid <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">your merchant ID, 5-digit numeric</span></div> </td> </tr> <tr title="aid"> <td class="ac-isParentTD pTDa" title="subaccountId"><span class="sLborder"></span>aid <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">your subaccount ID, 5-digit numeric</span></div> </td> </tr> <tr title="portalID"> <td class="ac-isParentTD pTDa" title="portalId"><span class="sLborder"></span>portalId <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">your Portal ID, 7-digit numeric</span></div> </td> </tr> <tr title="key"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>key <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">your key value, alpha-numeric</span></div> </td> </tr> </tbody> </table> <p class="endOfBlock m-0 p-0">---end</p> <h5 class="h5Param">common Parameters</h5> <table title="common_parameter" class="ac-isParent"> <tbody> <tr title="clearingtype"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>clearingtype <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Fixed Value elv</span></div> </td> </tr> <tr title="mode"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>mode <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Fixed Value test/live</span></div> <div class="wfptf"> <p></p> <p>can be either test environment (test) or live environment (live)</p> </div> </td> </tr> <tr title="currency"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>currency <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format LIST</span></div> <div><span class="dmLkmF lVyis">Permitted values ISO 4217 (currencies) 3-letter-codes</span></div> <div class="wfptf">Samples: EUR / USD / GBP</div> </td> </tr> </tbody> </table> <h5 class="h5Param">PERSONAL DATA Parameters</h5> <table class="ac-isParent"> <tbody> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>customerid <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..20) <br>Permitted Symbols [0-9, a-z, A-Z, .,-,_,/] </span></div> <div class="wfptf"> <p>Merchant's customer ID, defined by you / merchant to refer to the customer record.</p> <div class="notification is-success is-light">"customerid" can be used to identify a customer record. <br>If "customerid" is used then stored customer data are loaded automatically.</div> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>userid <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format NUMERIC(6..12)</span></div> <div class="wfptf"> <p>PAYONE User ID, defined by PAYONE</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>salutation <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..10)</span></div> <div class="wfptf"> <p>The customer's salutation</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>title <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF lVyis">Format CHAR(1..20)</span></div> <div>Samples</div> <div>Dr <br>Prof. <br>Dr.-Ing.</div> <div class="wfptf"> <p>Title of the customer</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>firstname <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..50)</span></div> <div class="wfptf"> <p>First name of customer; optional if company is used, i.e.: you may use</p> <p>"company" or "lastname" or "firstname" plus "lastname"</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>lastname <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF lVyis">Format CHAR(2..50)</span></div> <div class="wfptf"> <p>Last name of customer; optional if company is used, i.e.: you may use</p> <p>"company" or "lastname" or "firstname" plus "lastname"</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>company <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF lVyis">Format CHAR(2..50)</span></div> <div class="wfptf"> <p>Comany name of customer; optional if company is used, i.e.: you may use</p> <p>"company" or "lastname" or "firstname" plus "lastname"</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>street <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF lVyis">Format CHAR(1..50)</span></div> <div class="wfptf"> <p>Street number and name (required: at least one character)</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>addressaddition <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF lVyis">Format CHAR(1..50)</span></div> <div>Samples</div> <div>7th floor <br>c/o Maier</div> <div class="wfptf"> <p>Specifies an additional address line for the invoice address of the customer.</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>zip <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF lVyis">Format CHAR(2..50)</span></div> <div><span class="dmLkmF lVyis">Permitted Symbols [0-9][A-Z][a-z][_.-/ ]</span></div> <div class="wfptf"> <p>Postcode</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>city <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF lVyis">Format CHAR(2..50)</span></div> <div class="wfptf"> <p>City of customer</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>country <div class="reqUOO reqUn">required</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format List</span></div> <div><span class="dmLkmF lVyis">Permitted values ISO 3166 2-letter-codes</span></div> <div>Samples: DE / GB / US</div> <div class="wfptf"> <p>Specifies country of address for the customer.</p> </div> <div class="notification is-success is-light">Some countries require additional information in parameter "state"</div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>state <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format LIST</span></div> <div><span class="dmLkmF lVyis">Permitted values ISO 3166-2 States (regions) 2-letter-codes</span></div> <div></div> <table class="payone-simpleTable"> <thead> <tr> <th class="payone-simpleTh" style="width: 50%;">Samples US</th> <th class="payone-simpleTh" style="width: 50%;">Samples CA</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd">AK</td> <td class="payone-simpleTd">AB</td> </tr> <tr> <td class="payone-simpleTd">AL</td> <td class="payone-simpleTd">BC</td> </tr> <tr> <td class="payone-simpleTd">AR</td> <td class="payone-simpleTd"></td> </tr> </tbody> </table> <div class="wfptf"> <p>Specifies state / region of country for the customer. <br>"state" is required for these countries: US, CA, CN, JP, MX, BR, AR, ID, TH, IN and must not be used for all other countries.</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>email <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(5..254)</span></div> <div class="wfptf"> <p>Permitted Symbols RFC 5322</p> <p>Special Remark email validation:</p> <p>Max. length for email is 254 characters. Validation is set up in the following way:</p> <p>Username = Max. 63 characters</p> <p>Domain Name = Max. 63 characters <br>Domain Suffixes = Max. 4 suffixes with max. 124 characters <br>Example: username[63]@domain_name[63].suffix[60].suffix[60].suffix[4]</p> <p>"@" and "." is counted as a character as well; in case of a total of three suffixes, this would allow a total of 254 characters.</p> <p>email-address of customer</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>telephonenumber <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..30)</span></div> <div class="wfptf"> <p>Phone number of customer</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>birthday <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format DATE(8), YYYYMMDD</span></div> <div class="wfptf"> <div>Samples: 20190101 / 19991231</div> <p>Date of birth of customer</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>language <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format LIST</span></div> <div class="wfptf"> <p>Permitted values ISO 639-1 (Language)2-letter-codes</p> <p>Language indicator (ISO 639) to specify the language that should be presented to the customer (e.g. for error messages, frontend display).</p> <p>If the language is not transferred, the browser language will be used. For a non-supported language English will be used.</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>vatid <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..50)</span></div> <div class="wfptf"> <p>VAT identification number. Used for b2b transactions to indicate VAT number of customer.</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>gender <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format LIST</span></div> <div class="wfptf"> <p>Permitted values: f / m / d</p> <p></p> <p>Gender of customer (female / male / diverse* )</p> <p>* currently not in use</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>personalid <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..32)</span></div> <div class="wfptf"> <p>Permitted Symbols [0-9][A-Z][a-z][+-./()]</p> <p>Person specific numbers or characters, e.g. number of passport / ID card</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>ip <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..39)</span></div> <div class="wfptf"> <p>Customer's IP-V4-address (123.123.123.123) or IP-V6-address</p> </div> </td> </tr> </tbody> </table> <p class="endOfBlock m-0 p-0">---end</p> <h5 class="h5Param">bank Account data PARAMETERS</h5> <table class="ac-isParent"> <tbody> <tr title="bankcountry"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>bankcountry <div class="reqUOO optUn"><span>required</span></div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format LIST</span></div> <div><span class="dmLkmF isTLDY">Account type/ country for use with BBAN (i.e. bankcode, bankaccount): DE</span></div> <div class="wfptf"> <p>DE: Mandatory with bankcode, bankaccount, optional with IBAN</p> <p>For other countries than DE please use IBAN or IBAN/BIC</p> </div> </td> </tr> <tr title="iban"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>iban <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(8 or 11) Only capital letters and digits, no spaces</span></div> <div><span class="dmLkmF lVyis">Permitted Symbols [0-9][A-Z]</span></div> <div class="wfptf"> <p>Bank Identifier Code to be used for payment or to be checked</p> </div> </td> </tr> <tr title="bic"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>bic <br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(8 or 11) Only capital letters and digits, no spaces</span></div> <div><span class="dmLkmF lVyis">Permitted Symbols [0-9][A-Z]</span></div> <div class="wfptf"> <p>BIC is optional for all Bank transfers within SEPA. For Accounts from Banks outside of SEPA, BIC is still required.</p> </div> </td> </tr> <tr title="bankaccount"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>bankaccount<br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format NUMERIC(1..10)</span></div> <div class="wfptf">DE: bankcountry, bankcode and bankaccount may be used. Then IBAN will be generated by PAYONE platform and used for SEPA transactions.<br>Not DE: Please use IBAN or IBAN / BIC.</div> </td> </tr> <tr title="bankcode"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>bankcode<br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format NUMERIC(8)</span></div> <div class="wfptf">DE: bankcountry, bankcode and bankaccount may be used. Then IBAN will be generated by PAYONE platform and used for SEPA transactions.<br>Not DE: Please use IBAN or IBAN / BIC.</div> </td> </tr> <tr title="bankaccountholder"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>bankaccountholder<br> <div class="reqUOO optUn">optional</div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..50)</span></div> <div class="wfptf">Account holder</div> </td> </tr> </tbody> </table> <p class="endOfBlock m-0 p-0">---end</p> <h5 class="h5Param">Response Parameters</h5> <table class="ac-isParent"> <tbody> <tr title="status"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span> status</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Permitted Values <br></span></div> <div><span class="dmLkmF lVyis">APPROVED</span><br><span class="dmLkmF lVyis"></span></div> <div><span class="dmLkmF lVyis">ERROR </span></div> </td> </tr> </tbody> </table> <div class="responsesDIV"><button class="notiBtn has-text-primary-dark has-background-success-light" 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; color: #00947e;"> <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>200 </span><span class="sc-jcwpoC DVwyR"></span></button> <h5 class="h5Param">Response Parameter (Approved)</h5> <table class="ac-isParent"> <tbody> <tr title="mandate_identification"> <td class="ac-isParentTD pTDa"><span class="sLborder"></span>mandate_identification<br> <div class="reqUOO reqUn"></div> </td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..35)</span></div> <div><span class="dmLkmF lVyis">Permitted Symbols [A-Z,a-z,0-9,+,-,.,(,)]</span></div> <div class="wfptf"> <p>A SEPA mandate can be created if a payment is initiated (amount > 0). Can be used to enforce a merchant specific mandate identification. The mandate_identification has to be unique.</p> <div class="alertbox"> <p>PPS (PAYONE Payment Service): This parameter must not be used! For PPS the PAYONE platform defines the mandate_identification</p> </div> <div class="ml-3"> <div class="tryoutbox"><span>If the mandate_identification is not set PAYONE will create an unique mandate identification <br>(pattern: PO-nnnnnnnnnn).</span></div> <p class="endOfBlock m-0 p-0">---end</p> </div> </div> </td> </tr> <tr title="mandate_dateofsignature"> <td class="ac-isParentTD pTDa" title="cardPaymentMethodSpecificInput"><span class="sLborder"></span>mandate_status</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format LIST </span></div> <div> <table class="payone-simpleTable"> <thead> <tr> <th class="payone-simpleTh" style="width: 20%;">Value</th> <th class="payone-simpleTh" style="width: 80%;">Comment</th> </tr> </thead> <tbody> <tr> <td class="payone-simpleTd">pending</td> <td class="payone-simpleTd"> <p>indicates a new created mandate</p> <p></p> <p>Pending mandate has to be used within 2 hours by authorization / preauthorization to complete a payment.</p> </td> </tr> <tr> <td class="payone-simpleTd">active</td> <td class="payone-simpleTd">indicates an existing / active mandate</td> </tr> </tbody> </table> </div> <div class="wfptf"> <p>Status of SEPA mandate</p> </div> </td> </tr> <tr title="creditor_identifier"> <td class="ac-isParentTD pTDa" title="cardPaymentMethodSpecificInput"><span class="sLborder"></span>mandate_text</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format TEXT</span></div> <div class="wfptf"> <p>Content of mandate text</p> <p>HTML-formatted, URL-encoded</p> </div> </td> </tr> <tr title="creditor_name"> <td class="ac-isParentTD pTDa" title="cardPaymentMethodSpecificInput"><span class="sLborder"></span>creditor_identifier</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..35)</span></div> <div class="wfptf"> <p>Creditor identifier as recorded at PAYONE</p> </div> </td> </tr> <tr title="creditor_stree"> <td class="ac-isParentTD pTDa" title="cardPaymentMethodSpecificInput"><span class="sLborder"></span>iban</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(8 or 11) Only capital letters and digits, no spaces<br>Permitted Symbols [0-9][A-Z]</span></div> <div class="wfptf"> <p>Bank Identifier Code to be used for payment or to be checked.</p> </div> </td> </tr> <tr title="creditor_stree"> <td class="ac-isParentTD pTDa" title="cardPaymentMethodSpecificInput"><span class="sLborder"></span>bic</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(8 or 11) Only capital letters and digits, no spaces<br>Permitted Symbols [0-9][A-Z]</span></div> <div class="wfptf"> <p>BIC is optional for all Bank transfers within SEPA. For Accounts from Banks outside of SEPA, BIC is still required.</p> </div> </td> </tr> </tbody> </table> </div> <div class="responsesDIV"><button class="notiBtn has-text-danger-dark has-background-danger-light" 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; color: #cc0f35;"> <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>400 </span><span class="sc-jcwpoC DVwyR"></span></button> <h5 class="h5Param">Response Parameter (Error)</h5> <table class="ac-isParent"> <tbody> <tr> <td class="ac-isParentTD pTDa" title="cardPaymentMethodSpecificInput"><span class="sLborder"></span> errorcode</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format NUMERIC(1..6)</span></div> <div class="wfptf"> <p>In case of error the PAYONE Platform returns an error code for your internal usage.</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa" title="hostedCheckoutSpecificInput"><span class="sLborder"></span>errormessage</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..1024)</span></div> <div class="wfptf"> <p>In case of error the PAYONE Platform returns an error message for your internal usage.</p> </div> </td> </tr> <tr> <td class="ac-isParentTD pTDa" title="redirectPaymentMethodSpecificInput"><span class="sLborder"></span>customermessage</td> <td class="pTDb"> <div><span class="dmLkmF isTLDY"></span><span class="dmLkmF lVyis">Format CHAR(1..1024)</span></div> <div class="wfptf"> <p>The customermessage is returned to your system in order to be displayed to the customer.</p> <p>(Language selection is based on the end customer's language, parameter "language")</p> </div> </td> </tr> </tbody> </table> </div> <p class="endOfBlock m-0 p-0">---end</p> </div> <div class="column is-one-third code-samples-wrap"> <div class="payone-code-lane"><button class="csw-iONbtn mb-2"> <span type="post" class="SpanVerbHttp http-verb http-post"></span> <span class="SpanVerb">/post-gateway/ HTTP/1.1</span> </button></div> <div class="payloadbox codebox"> <pre class="has-text-white p-3 payone-code-background payone-w-100">Host: api.pay1.de<br>Content-Type: application/x-www-form-urlencoded</pre> </div> <div class="payone-codeseperator"></div> <div class="divcopybtn payone-w-100"><button type="button" class="payone-copy-text button payone-is-tiny btn-primary"> <span class="icon-text"> <span class="payone-is-tiny"> <i class="fas fa-regular fa-copy"></i> </span> <span>Copy</span> </span> </button></div> <div class="payloadbox codebox"> <pre class="has-text-white p-3 payone-code-background payone-w-100">Payload <br>https://api.pay1.de/post-gateway/<br>aid=52078<br>bankaccount=<br>bankaccountholder=Siegfried Sepa<br>bankcode=<br>bankcountry=DE<br>bic=<br>city=Kiel<br>clearingtype=elv<br>country=DE<br>currency=EUR<br>email=Siegfried.Sepa@payone.com<br>encoding=UTF-8<br>firstname=Siegfried<br>gender=m<br>iban=DE11210501706179573239<br>ip=172.19.0.34<br>key=17031f73e2c6f9755788bddfff04169b<br>language=de<br>lastname=Sepa<br>mid=14648<br>mode=test<br>portalid=2037267<br>request=managemandate<br>salutation=Herr<br>street=Fraunhoferstr. 2-4<br>zip=24118<br> </pre> </div> <div class="payone-codeseperator"></div> <div class="divcopybtn payone-w-100"><button type="button" class="payone-copy-text button payone-is-tiny btn-primary"> <span class="icon-text"> <span class="payone-is-tiny"> <i class="fas fa-regular fa-copy"></i> </span> <span>Copy</span> </span> </button></div> <div class="payloadbox codebox"> <pre class="has-text-white p-3 payone-code-background payone-w-100">RESPONSE <br>status=APPROVED<br>mandate_identification=TM-10052817<br>mandate_status=pending<br>mandate_text=%3Cdiv+class%3D%22mandatetext%22%3E%0A%3Cp%3E%0A%3Cstrong%3ESEPA-Lastschriftmandat%3C%2Fstrong%3E%0A%3C%2Fp%3E%0A%3Cp%3E%0A++++++++++++++++++++++++++++Zahlungsempf%26auml%3Bnger%3A+Payone+Test+Kiel%2C+DE%3Cbr%3E%0A++++++++++++++++Gl%26auml%3Bubiger-Identifikationsnummer%3A+TESTTESTTEST%3Cbr%3E%0A++++++++++++++++Mandatsreferenz%3A+TM-10052817%3C%2Fp%3E%0A%3Cp%3EIch+erm%26auml%3Bchtige+den+Zahlungsempf%26auml%3Bnger%2C+Zahlungen+von+meinem+Konto+mittels+Lastschrift+einzuziehen.+Zugleich+weise+ich+mein+Kreditinstitut+an%2C+die+von+dem+Zahlungsempf%26auml%3Bnger+auf+mein+Konto+gezogenen+Lastschriften+einzul%26ouml%3Bsen.%3C%2Fp%3E%0A%3Cp%3EHinweis%3A+Ich+kann+innerhalb+von+acht+Wochen%2C+beginnend+mit+dem+Belastungsdatum%2C+die+Erstattung+des+belasteten+Betrages+verlangen.+Es+gelten+dabei+die+mit+meinem+Kreditinstitut+vereinbarten+Bedingungen.%3C%2Fp%3E%0A%3Cdl%3E%0A%3Cdt%3EName+des+Zahlungspflichtigen%3A%3C%2Fdt%3E%0A%3Cdd%3ESiegfried+Sepa%3C%2Fdd%3E%0A%3Cdt%3EStra%26szlig%3Be+und+Hausnummer%3A%3C%2Fdt%3E%0A%3Cdd%3EFraunhoferstr.+2-4%3C%2Fdd%3E%0A%3Cdt%3EPostleitzahl%3A+%3C%2Fdt%3E%0A%3Cdd%3E24118%3C%2Fdd%3E%0A%3Cdt%3EOrt%3A+%3C%2Fdt%3E%0A%3Cdd%3EKiel%3C%2Fdd%3E%0A%3Cdt%3ELand%3A%3C%2Fdt%3E%0A%3Cdd%3EDE%3C%2Fdd%3E%0A%3Cdt%3EE-Mail%3A%3C%2Fdt%3E%0A%3Cdd%3ESiegfried.Sepa%40payone.com%3C%2Fdd%3E%0A%3Cdt%3EBankkontonummer+-+IBAN%3A%3C%2Fdt%3E%0A%3Cdd%3EDEXX21050170XXXXXX3239%3C%2Fdd%3E%0A%3C%2Fdl%3E%0A%3Cp%3E%0A%3Cspan+class%3D%22mandatetext_cityofsignature%22%3EKiel%3C%2Fspan%3E%2C+04.10.2023%2C+Siegfried+Sepa%3C%2Fp%3E%0A%3C%2Fdiv%3E%0A<br>creditor_identifier=TESTTESTTEST<br>iban=DE11210501706179573239 </pre> </div> </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/channel-client-api/client-api-managemandate"; 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>

CINXE.COM

PAYONE Documentation Platform | Client API - Managemandate