Integration Docs

To Install Instant Bank Payments via Ivy to your shop system, follow the steps below:

Step 1: Enable Instant Bank Payments with Ivy

  • Create an Ivy Account: Go to this link: https://merchant.getivy.de/sign-up and sign up for an Ivy account. Please e-mail [email protected] as soon as this has happened so that you can be activated for production. We also need to know your IBAN for the activation.
  • Add Your Beneficiary IBAN: Once your account is approved, you’ll additionally need to upload your IBAN to receive funds. Navigate to “Settings → KYB” and enter your IBAN details (without spaces). This IBAN will be automatically applied to all future payments.

Step 2: Set Up Ivy with Payever

  • Create a Payever Business Account: If you haven’t created one yet, sign up for a business account via this link: https://commerceos.payever.org/registration/business.
    Add Payever to Your Ivy Dashboard: Add [email protected] as a member (admin) of your Ivy Dashboard. This allows Payever to configure webhooks, callbacks, and API keys. These can be found by navigating to “Developer → Secrets”.

Step 3: Configuring the Payment Method in Your Checkout

  • To ensure that your customers clearly understand the payment option, we recommend using the following naming conventions in your checkout settings:
    Title: Instant Bank Transfer / Banküberweisung
    Description: This is a simple, fast, and TÜV certified way to pay directly from your bank account. / Eine einfache, schnelle und TÜV-zertifizierte Möglichkeit, direkt aus Ihrem Bankkonto zu bezahlen.

Step 4: Reconciliation
To ensure a smooth instant payment experience, only SEPA Instant-enabled banks will be displayed to your customers. This covers approximately 85% of all banks in Germany, with a few exceptions, such as ING and DKB.
SEPA Instant payments should settle within 10 seconds, and the transaction status will show as “Paid”.

Step 5: Handling Refunds
As funds are settled directly into your business account, you’ll need to manually process any returns to your customers. The payee’s IBAN can be found in the original transfer details within your shop system.

Payever Information and Status Overview

  • Payever Link 1: All Plugins
    Payever Link 2: Ivy-specific integration
  • Order Statuses Explained:
    Paid: The payment has been initiated from a SEPA Instant-enabled bank and will arrive in your account within minutes.
    Cancelled: This means either the payment has been cancelled or fully refunded.
    Failed: The payment failed during the initiation process.
    Note: Status names may vary slightly depending on your shop system. For more details on order status, please refer to the Payever transactions app or reach out to [email protected] for assistance.

🔶

If you are stuck at any step, please reach out to support directly