{"id":277822,"date":"2026-02-18T14:54:06","date_gmt":"2026-02-18T14:54:06","guid":{"rendered":"https:\/\/support-landing.altegio.cloud\/support\/?post_type=docs&p=277822"},"modified":"2026-07-24T17:10:28","modified_gmt":"2026-07-24T17:10:28","password":"","slug":"277822","status":"publish","type":"docs","link":"https:\/\/alteg.io\/en\/support\/knowledge-base\/277822\/","title":{"rendered":"Adyen Integration: Setup and verification guide"},"content":{"rendered":"\n

Adyen<\/a> <\/strong>is available as a payment system inside Altegio, so eligible companies can accept online payments and receive payouts to a business bank account.<\/p>\n\n\n\n

\n

Adyen supports a broad set of payment methods including credit\/debit cards, Apple Pay, Google Pay, PayPal, and regional payment systems<\/strong>. <\/p>\n<\/blockquote>\n\n\n\n

With a connected Adyen integration in Altegio companies are able to:<\/p>\n\n\n\n

    \n
  • Accept online credit\/debit card<\/strong> payments (including American Express<\/strong> and UnionPay<\/strong>, where available).<\/li>\n\n\n\n
  • Accept digital wallets<\/strong> like Apple Pay<\/strong> and Google Pay<\/strong> (where supported).<\/li>\n\n\n\n
  • Use local payment methods<\/strong> in some countries (if available at location).<\/li>\n\n\n\n
  • Receive payouts to your bank account on a schedule (typically once every week<\/strong>).<\/li>\n<\/ul>\n\n\n\n
    \n

    Availability depends on your country and business category. If you don\u2019t see Adyen in Integrations, it likely isn\u2019t available for your location yet\u2014contact Support.<\/p>\n<\/blockquote>\n\n\n\n

    \n

    Important<\/strong><\/p>\n\n\n\n

    Only the Location Owner<\/strong> can connect Adyen and complete verification.<\/p>\n<\/blockquote>\n\n\n\n

    What you should prepare<\/h3>\n\n\n\n

    You\u2019ll go through business verification (KYC\/KYB)<\/strong>. Have these ready:<\/p>\n\n\n\n

      \n
    • Legal business details<\/strong> (legal name, registration country, business address, phone, etc.).<\/li>\n\n\n\n
    • Ownership \/ decision-maker info<\/strong> (owners and people who control the business).<\/li>\n\n\n\n
    • A business bank account<\/strong> (IBAN or bank details depending on country).<\/li>\n\n\n\n
    • Verification documents<\/strong> (business registration docs, ID documents for relevant persons, and any other documents requested during onboarding).<\/li>\n\n\n\n
    • A device\/camera<\/strong> for identity checks (if prompted). <\/li>\n<\/ul>\n\n\n\n

      Open the integration in Altegio<\/h2>\n\n\n\n
        \n
      1. Go to Administration<\/strong> mode, Integrations > Payment systems<\/strong>.<\/li>\n<\/ol>\n\n\n\n
        \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
          \n
        1. Find Adyen<\/strong> and open it.<\/li>\n\n\n\n
        2. Click Connect<\/strong>.<\/li>\n<\/ol>\n\n\n\n
          \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
            \n
          1. You will see a confirmation screen saying you\u2019re about to connect the Adyen application to Altegio and that it requests access to your location. <\/li>\n\n\n\n
          2. Click Continue<\/strong>.<\/li>\n<\/ol>\n\n\n\n
            \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

            Fill in registration details in Altegio<\/h2>\n\n\n\n

            After you confirm access, you\u2019ll complete a Registration<\/strong> form in Altegio. This information is required for verification and is not shown to your clients<\/strong>.<\/p>\n\n\n\n

            Typical fields include:<\/p>\n\n\n\n

              \n
            • Legal entity (legal name, country of registration)<\/li>\n\n\n\n
            • Store\/business details (business country, description, address\/city\/zip, phone)<\/li>\n\n\n\n
            • Shopper statement (what customers will see on their bank statement)<\/li>\n<\/ul>\n\n\n\n
              \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

              Click Save and continue<\/strong>.<\/p>\n\n\n\n

              Complete Adyen onboarding <\/h2>\n\n\n\n

              After registration, you\u2019ll be taken to Adyen onboarding<\/strong>.<\/p>\n\n\n\n

              \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
              \n

              Note<\/strong><\/p>\n\n\n\n

              In Altegio, you may see a note that you have 1 hour<\/strong> to complete the onboarding.
              If the link expires, you can request\/generate a new link<\/strong> from the same integration screen (Altegio will provide a way to return to onboarding).<\/p>\n\n\n\n

              Click Go to Adyen onboarding<\/strong> to open the hosted onboarding flow.<\/p>\n<\/blockquote>\n\n\n\n

              Adyen onboarding<\/h2>\n\n\n\n

              You will typically see a checklist like this to be filled out:<\/p>\n\n\n\n

                \n
              • Business details<\/strong><\/li>\n<\/ul>\n\n\n\n
                \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                  \n
                • Country\/region of establishment<\/li>\n\n\n\n
                • Business legal name<\/li>\n<\/ul>\n\n\n\n
                  \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                    \n
                  • Company structure (e.g., private company \/ public company \/ non-profit, etc.)<\/li>\n<\/ul>\n\n\n\n
                    \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                    \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                      \n
                    • Decision-makers<\/strong> (owners and people responsible for the business)<\/li>\n<\/ul>\n\n\n\n
                      \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

                      You\u2019ll be asked for details about:<\/p>\n\n\n\n

                        \n
                      • At least one business representative<\/li>\n<\/ul>\n\n\n\n
                        \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                          \n
                        • Information about business owners <\/li>\n<\/ul>\n\n\n\n
                          \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                          \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

                          You may also be prompted to complete identity verification<\/strong>:<\/p>\n\n\n\n

                            \n
                          • You can usually scan an ID<\/strong> or add details manually<\/strong><\/li>\n<\/ul>\n\n\n\n
                            \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                            \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                            \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                              \n
                            • Follow the on-screen instructions and provide a clear photo with no glare and in good lighting.<\/li>\n<\/ul>\n\n\n\n
                              \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                \n
                              • Payout details<\/strong> (where Adyen will send your payouts)<\/li>\n<\/ul>\n\n\n\n
                                \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

                                You will be asked to add a bank account for payouts.
                                <\/p>\n\n\n\n

                                \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

                                Additionally, you may be prompted to fill in an IBAN<\/strong> field and a note about supported payout currencies.<\/p>\n\n\n\n

                                \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                  \n
                                • Services agreement<\/strong><\/li>\n<\/ul>\n\n\n\n
                                    \n
                                  • Legal disclosures<\/strong><\/li>\n<\/ul>\n\n\n\n

                                    Complete the PCI questionnaire and sign the services agreement <\/p>\n\n\n\n

                                    \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                      \n
                                    • PCI DSS questionnaire<\/strong> (required for card payments)<\/li>\n<\/ul>\n\n\n\n
                                      \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                      \n

                                      Note<\/strong>

                                      These usually remain \u201cpending<\/strong>\u201d until you finish the required steps.<\/p>\n<\/blockquote>\n\n\n\n

                                      Confirm \u201cIntegration connected\u201d in Altegio<\/h2>\n\n\n\n

                                      When everything is completed and accepted, you\u2019ll see Integration connected<\/strong> on the Adyen integration page in Altegio.<\/p>\n\n\n\n

                                      \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

                                      From that screen, you\u2019ll also typically have these options:<\/p>\n\n\n\n

                                        \n
                                      • Change your registration details<\/strong> (the initial form you filled in Altegio)<\/li>\n\n\n\n
                                      • Change your Adyen onboarding details<\/strong> (this sends you back to Adyen to update verified info)<\/li>\n<\/ul>\n\n\n\n

                                        What happens if something blocks you <\/h2>\n\n\n\n

                                        You\u2019re the owner, but onboarding isn\u2019t finished<\/strong><\/h4>\n\n\n\n

                                        You will see a yellow warning<\/strong> banner in Altegio interface saying:<\/p>\n\n\n\n

                                          \n
                                        • \u201cTo connect Adyen, you need to complete onboarding and upload the required documents\u201d

                                          And:<\/li>\n\n\n\n
                                        • A button Go to Adyen onboarding<\/strong><\/li>\n\n\n\n
                                        • The Connect<\/strong> button may be disabled until onboarding is completed<\/li>\n<\/ul>\n\n\n\n
                                          \n

                                          Click Go to Adyen onboarding<\/strong> and finish the steps (including document upload if requested).<\/p>\n<\/blockquote>\n\n\n\n

                                          You\u2019re not the owner (insufficient permissions)<\/strong><\/h4>\n\n\n\n

                                          You will see a red warning<\/strong> like:<\/p>\n\n\n\n

                                            \n
                                          • \u201cOnly the location owner can connect Adyen and complete onboarding and verification\u201d

                                            And the Connect<\/strong> button will be disabled.<\/li>\n<\/ul>\n\n\n\n
                                            \n

                                            Ask the Location Owner<\/strong> to connect and complete onboarding.<\/p>\n<\/blockquote>\n\n\n\n

                                            Adyen is already connected in another location<\/strong><\/h4>\n\n\n\n

                                            You will see a message like:<\/p>\n\n\n\n

                                              \n
                                            • \u201cAdyen is already connected\u201d<\/li>\n\n\n\n
                                            • And which location it\u2019s connected to<\/li>\n<\/ul>\n\n\n\n

                                              You\u2019ll be offered options such as:<\/p>\n\n\n\n

                                                \n
                                              • Use the same account (for a single legal entity)<\/strong><\/li>\n\n\n\n
                                              • Create a new account (for a chain\/other legal entity)<\/strong><\/li>\n<\/ul>\n\n\n\n
                                                \n

                                                Notes<\/strong><\/p>\n\n\n\n

                                                If you\u2019re not the owner<\/strong>, \u201cUse the same account\u201d will be disabled and you\u2019ll be prompted to contact the owner or Support.<\/p>\n\n\n\n

                                                Which option should you choose?<\/p>\n\n\n\n

                                                Same legal entity across locations<\/strong> > choose Use the same account<\/strong><\/p>\n\n\n\n

                                                Different legal entity (chain \/ separate company)<\/strong> > choose Create a new account<\/strong><\/p>\n<\/blockquote>\n\n\n\n

                                                Re-onboarding and updates (when Adyen asks for changes)<\/h2>\n\n\n\n

                                                Sometimes Adyen may require you to re-confirm or update information (for example, if key business details change or documents expire). When that happens:<\/p>\n\n\n\n

                                                  \n
                                                • Altegio will show notification banners<\/strong> with a deadline.<\/li>\n\n\n\n
                                                • You\u2019ll be directed back to Adyen onboarding to complete the required updates.<\/li>\n<\/ul>\n\n\n\n
                                                  \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                                  \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                                  \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                                  \n

                                                  Improtant<\/strong>

                                                  Don\u2019t ignore these banners\u2014if the deadline passes, payouts or payment acceptance may be affected until the onboarding is updated.<\/p>\n<\/blockquote>\n\n\n\n

                                                  \n

                                                  Notes<\/strong>

                                                  Verification time depends on the documents requested and how quickly they can be reviewed. If Adyen needs more info, you\u2019ll see it in the onboarding checklist.<\/p>\n\n\n\n


                                                  You can change business or payout details later. To do so, use Change your registration details<\/strong> (Altegio-side form) or Change your Adyen onboarding details<\/strong> (Adyen-side verified info).<\/p>\n\n\n\n


                                                  If you don’t see Adyen in Integration section, most commonly: your country or business type isn\u2019t eligible yet. Contact Support to confirm availability (and possible alternatives like Stripe where applicable).<\/p>\n<\/blockquote>\n\n\n\n

                                                  Adyen Dashboard<\/h2>\n\n\n\n

                                                  The Adyen Dashboard<\/strong> in Altegio shows every payment processed through the Adyen integration, the current account balance, and the payouts sent to your bank account. Use it to check incoming payments, track payouts, filter transactions, and issue refunds to clients.<\/p>\n\n\n\n

                                                  \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

                                                  To open Adyen Dashboard <\/strong>go to the Administration<\/strong> mode, open Finance > Adyen Dashboard<\/strong> in the left menu. The page opens on the Transactions<\/strong> view.<\/p>\n\n\n\n

                                                  Transactions<\/h3>\n\n\n\n

                                                  The Transactions<\/strong> view lists every operation processed through Adyen. Two summary blocks sit above the table:<\/p>\n\n\n\n

                                                    \n
                                                  • Total incoming<\/strong> and Total outgoing<\/strong> for the selected period, in your payout currency (for example, EUR).<\/li>\n\n\n\n
                                                  • Available balance<\/strong> (the amount currently available) and Reserved balance<\/strong> (the amount currently reserved and not yet available).<\/li>\n<\/ul>\n\n\n\n

                                                    Each row in the table shows:<\/p>\n\n\n\n

                                                      \n
                                                    • Date<\/strong>: the date and time of the operation.<\/li>\n\n\n\n
                                                    • Payment method<\/strong>: the method used (for example, Apple Pay or Visa) with the last digits of the card, or a bank icon for a payout.<\/li>\n\n\n\n
                                                    • Transaction type<\/strong>: for example, Payment<\/strong> or Transfer<\/strong>.<\/li>\n\n\n\n
                                                    • Net amount (\u20ac)<\/strong>: the amount credited after Adyen’s processing fee.<\/li>\n\n\n\n
                                                    • Gross amount (\u20ac)<\/strong>: the full amount charged to the client.<\/li>\n<\/ul>\n\n\n\n

                                                      Click Export<\/strong> in the top-right corner to download the transaction list. At the bottom of the table, the Showing<\/strong> selector sets how many rows appear per page, and the arrows move between pages.<\/p>\n\n\n\n

                                                      Filtering transactions<\/h3>\n\n\n\n
                                                        \n
                                                      • Date range<\/strong><\/li>\n<\/ul>\n\n\n\n

                                                        The first filter (Last 180 days<\/strong> by default) sets the period covered by the table and by the Total incoming<\/strong> and Total outgoing<\/strong> totals.<\/p>\n\n\n\n

                                                        \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                                          \n
                                                        • Type<\/strong><\/li>\n<\/ul>\n\n\n\n

                                                          Click Type<\/strong> to filter by transaction type. Select one or more types and click Apply<\/strong>. The available types are ATM<\/strong>, Capital<\/strong>, Chargeback<\/strong>, Correction<\/strong>, Payment<\/strong>, Refund<\/strong>, Transfer<\/strong>, and Other<\/strong>. Click Reset<\/strong> to clear the selection.<\/p>\n\n\n\n

                                                          \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                                            \n
                                                          • PSP reference<\/strong><\/li>\n<\/ul>\n\n\n\n

                                                            Click PSP reference<\/strong> to find one specific transaction by its Adyen PSP reference. Enter the reference in the field and click Apply<\/strong>. Click Reset<\/strong> to clear it.<\/p>\n\n\n\n

                                                            \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

                                                            Insights<\/strong><\/h3>\n\n\n\n

                                                            Switch to the Insights<\/strong> tab using the toggle in the top-right corner to see a summary for the selected period instead of the transaction list:<\/p>\n\n\n\n

                                                              \n
                                                            • Period result<\/strong>: the net result for the period (Total incoming minus Total outgoing).<\/li>\n\n\n\n
                                                            • Total incoming<\/strong>: broken down by transaction type (for example, Payment<\/strong>).<\/li>\n\n\n\n
                                                            • Total outgoing<\/strong>: broken down by transaction type (for example, Transfer<\/strong>, which represents payouts sent to your bank account).<\/li>\n<\/ul>\n\n\n\n
                                                              \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n

                                                              Refunds to clients<\/h2>\n\n\n\n

                                                              If a client needs a refund<\/strong>, it can be processed from the Adyen dashboard.<\/p>\n\n\n\n

                                                              To issue a refund:<\/p>\n\n\n\n

                                                                \n
                                                              1. Open the transaction in the dashboard.<\/li>\n\n\n\n
                                                              2. Click the transaction details.<\/li>\n\n\n\n
                                                              3. Click Refund<\/strong>.<\/li>\n<\/ol>\n\n\n\n
                                                                \"\"\n\t\t\t\n\t\t\t\t\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n
                                                                \n
                                                                  \n
                                                                • Only the Location Owner<\/strong> can issue refunds.<\/li>\n\n\n\n
                                                                • A fee is charged for processing a refund. The exact fee is specified in the merchant agreement on the Adyen page in the Altegio Marketplace.<\/li>\n\n\n\n
                                                                • When a full refund is issued, the full refunded amount is debited from the business balance. Previously charged payment processing fees are not returned.<\/li>\n\n\n\n
                                                                • An additional fee for the refund operation itself may also be charged to the business.<\/li>\n<\/ul>\n<\/blockquote>\n\n\n\n

                                                                  Payouts to your business bank account<\/h2>\n\n\n\n

                                                                  Funds collected through Adyen are paid out to the business bank account automatically.<\/p>\n\n\n\n

                                                                    \n
                                                                  • payouts are scheduled once a week<\/strong><\/li>\n\n\n\n
                                                                  • available funds are transferred on Monday morning<\/strong><\/li>\n<\/ul>\n\n\n\n
                                                                    \n
                                                                      \n
                                                                    • Refund availability depends on user permissions. If you do not see the Refund<\/strong> button, check whether you are signed in as the Location Owner.<\/li>\n\n\n\n
                                                                    • Payouts are processed automatically based on the configured schedule, so no manual withdrawal request is required in the standard setup.<\/li>\n<\/ul>\n<\/blockquote>\n\n\n\n
                                                                      \n

                                                                      Adyen is not available for individual entrepreneurs.<\/p>\n<\/blockquote>\n","protected":false},"excerpt":{"rendered":"

                                                                      Adyen is available as a payment system inside Altegio, so eligible companies can accept online payments and receive payouts to a business bank account. Adyen supports a broad set of payment methods including credit\/debit cards, Apple Pay, Google Pay, PayPal, and regional payment systems. With a connected Adyen integration in Altegio companies are able to: […]<\/p>\n","protected":false},"author":44,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_monsterinsights_skip_tracking":false,"footnotes":"","_members_access_role":[],"_members_access_error":""},"doc_category":[3274,3238],"doc_tag":[2071,1252],"class_list":["post-277822","docs","type-docs","status-publish","hentry","doc_category-payment-system-integrations","doc_category-payment-systems","doc_tag-integrations-en","doc_tag-location-en"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t