{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars/hpp_sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","img","tabs","tab"]},"type":"markdown"},"seo":{"title":"CCD2 with Hosted Payment Page | Ratepay","description":"The specifications of Ratepay's APIs for easy payment transactions.","siteUrl":"https://docs.ratepay.com","keywords":"Ratepay developer portal, Ratepay api portal, Ratepay api reference docs","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ccd2-with-hosted-payment-page","__idx":0},"children":["CCD2 with Hosted Payment Page"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"badges-container"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"className":"reading-time-badge"},"children":["⏱ 3 min"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"author-badge"},"children":["👤 Merchant Onboarding Team (Marcel K.)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this guide if buyers complete Ratepay payments on the Hosted Payment Page (HPP)."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Before you start:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["New to CCD2? Read ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/legal/a_legal_requirements_for_the_integration/ccd2/what_is_ccd2"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What is CCD2?"]}]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check whether CCD2 applies to you: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/legal/a_legal_requirements_for_the_integration/ccd2/do_i_need_to_take_action"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Do I need to take action?"]}]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See who does what: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/legal/a_legal_requirements_for_the_integration/ccd2/responsibilities/hosted_payment_page"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HPP: Your CCD2 responsibilities"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-need-to-do","__idx":1},"children":["What you need to do"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-present-bnpl-payment-methods-fairly-and-transparently","__idx":2},"children":["1. Present BNPL payment methods fairly and transparently"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Where BNPL is promoted, relevant costs and risks must be communicated clearly. Available payment methods should also be presented without undue emphasis on credit."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Before you continue, check that:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All available payment methods are visible from the start"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No in-scope method is pre-selected or emphasised"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The buyer makes the choice."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-choose-your-secci-buyer-experience","__idx":3},"children":["2. Choose your SECCI buyer experience"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose one of the two experiences described in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/legal/a_legal_requirements_for_the_integration/ccd2/responsibilities/hosted_payment_page"},"children":["Hosted Payment Page buyer experience"]},". We recommend Automatic SECCI email. Inform your Ratepay representative which experience you want, and Ratepay sets it up for you."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"SECCI experience pattern"},"children":["SECCI experience pattern"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HPP Design"},"children":["HPP Design"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What this means for you"},"children":["What this means for you"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recommended: Automatic SECCI email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/ccd2_automatic_email.05a9a8d88ccaa46291c9fc35d35e71aabdcb36fe4edb6d3a6ce27921ccdad168.22a2e3bf.png","alt":"Example HPP with Automatic SECCI email.","withLightbox":true},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add a SECCI notice to your checkout (Step 3)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explicit SECCI interaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/ccd2_explicit_secci_interaction.1354e523833cc443cc84ff3eda041153202d97f746dc2658be4a7ec7390e5d75.22a2e3bf.png","alt":"Example HPP with Explicit SECCI interaction.","withLightbox":true},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No change to your checkout. Ratepay shows the notice on the HPP. Skip step 3."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-inform-buyers-about-the-secci-before-redirecting","__idx":4},"children":["3. Inform buyers about the SECCI before redirecting"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note: This step is only needed if you prefer ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Automatic SECCI email"]}," from step 2 as SECCI buyer experience."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Show the SECCI notice in your checkout after payment method selection. See example below."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/ccd2_notice.db58b80829141db11acdd357e9ccf82b383eb7ecf9987970513c31930bd73582.22a2e3bf.png","alt":"SECCI notice checkout example","withLightbox":true,"align":"center"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Suggested buyer-facing copy:"]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"English","disable":false},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header:"]}," Standard EU Consumer Credit Info"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Text:"]}," Proceeding with [affected Ratepay payment methods] will automatically send this information to [buyer email]."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expandable section:"]}," Learn more"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn more text:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EU consumer credit rules have changed and now require additional information for [affected Ratepay payment methods]. This information helps you understand the key credit terms before completing your purchase. Our payment partner Ratepay will use your email address solely to send it, using a third-party email delivery provider."]}]}]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Deutsch","disable":false},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header:"]}," EU-Standardinformationen für Verbraucherkredite"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Text:"]}," Wenn Sie [betroffene Ratepay-Zahlungsarten] auswählen, senden wir diese Informationen automatisch an [E-Mail-Adresse des Käufers]."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Aufklappbarer Bereich:"]}," Mehr erfahren"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Text unter „Mehr erfahren“:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Die EU-Verbraucherkreditregeln haben sich geändert und verlangen nun zusätzliche Informationen für [betroffene Ratepay-Zahlungsarten]. Diese Informationen helfen Ihnen, die wichtigsten Kreditbedingungen zu verstehen, bevor Sie Ihren Kauf abschließen. Unser Zahlungspartner Ratepay verwendet Ihre E-Mail-Adresse ausschließlich, um Ihnen diese Informationen über einen externen E-Mail-Versanddienstleister zu senden."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Before you continue, check that:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The SECCI notice is shown in your checkout when the in-scope payment method is selected."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-check-how-your-system-handles-declines","__idx":5},"children":["4. Check how your system handles declines"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This step is needed if your system reads decline categories or reasons from the session record API or webhooks."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CCD2 introduces new decline categories and reasons: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_RISK"]},". They appear in the session record API and in webhooks upon CCD2-enablement."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your system only accepts a fixed list of values, update it so that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["it recognises the new values and maps them as you need, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_RISK"]}," as a credit decline"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an unknown value is treated as a general decline instead of causing an error, so future additions won’t break it"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You don’t need to show the decline explanation to the buyer, because Ratepay already shows it on the HPP."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Before you continue, check that:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your system processes the new decline values without errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An unknown decline value doesn’t break post-purchase experience"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"5-after-the-purchase","__idx":6},"children":["5. After the purchase"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No action needed. Continue your normal order process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you capture the transaction, Ratepay sends the Credit Contract Information to the buyer. If the amount increases later, Ratepay provides any updated credit information. There is no new SECCI generation request or token after checkout."]}]},"headings":[{"value":"CCD2 with Hosted Payment Page","id":"ccd2-with-hosted-payment-page","depth":1},{"value":"What you need to do","id":"what-you-need-to-do","depth":2},{"value":"1. Present BNPL payment methods fairly and transparently","id":"1-present-bnpl-payment-methods-fairly-and-transparently","depth":3},{"value":"2. Choose your SECCI buyer experience","id":"2-choose-your-secci-buyer-experience","depth":3},{"value":"3. Inform buyers about the SECCI before redirecting","id":"3-inform-buyers-about-the-secci-before-redirecting","depth":3},{"value":"4. Check how your system handles declines","id":"4-check-how-your-system-handles-declines","depth":3},{"value":"5. After the purchase","id":"5-after-the-purchase","depth":3}],"frontmatter":{"seo":{"title":"CCD2 with Hosted Payment Page | Ratepay"},"markdown":{"toc":{"hide":false,"depth":3}}},"lastModified":"2026-10-19T07:58:19.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/developer/hosted_payment_page/ccd2","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}