Merchant Onboarding (Manual flow)

This page describes the current onboarding flow for merchants on Djust Pay where merchant onboarding is handled manually by Djust.

⚙️ Overview

Djust currently manages merchant onboarding manually. This means Djust is responsible for:

• Creating the platform-level structure in Adyen (account holders, accounts...)
• Generating onboarding links
• Pre-configuring payment settings and credentials

Merchants do not create their own accounts. Instead, Djust creates them on their behalf and provides them with a secure onboarding link.

flowchart LR
 subgraph subGraph0["Adyen Onboarding Flow"]
        D1["Client accesses<br> onboarding"]
        D2["Client fills KYC<br>& banking info"]
  end
    B["Contract & merchant <br>info collected"]
    B --> C["Djust creates<br> new merchant"]
    C --> D1
    C --> D2
    D1 --> E["Adyen verifies<br>submitted data"]
    D2 --> E
    E --> F["Merchant ready<br>for payments"]

    D1@{ shape: rounded}
    D2@{ shape: rounded}
    B@{ shape: rounded}
    C@{ shape: rounded}
    E@{ shape: rounded}
    F@{ shape: rounded}
    subGraph0@{ shape: rounded}
     D1:::subphase
     D2:::subphase
     B:::phase
     C:::phase
     E:::phase
     F:::phase
    classDef phase fill:#0080ff,stroke:none,color:#ffffff,font-size:12px,border-radius:12px
    classDef subphase fill:#ffffff,stroke:none,color:#1A2A44,font-size:10px,border-radius:10px
    classDef startEnd fill:#FFAF40,stroke:none,color:#1A2A44,font-size:12px,border-radius:12px

🚶‍♂️Current Onboarding Flow (Manual)

1. Client signs with Djust and expresses intent to activate Djust Pay.
2. Djust creates the Adyen platform account structure:
   • accountHolderCode for the client
   • accountCode for the merchant account
   • Links API and webhook settings
3. Djust generates an onboarding link using Adyen's [Hosted Onboarding Page (HOP)].
4. The onboarding link is made available in the Djust backoffice.

📍Where to Find the Onboarding Link

Merchants can find their personal onboarding link in the Djust backoffice:

https://your.tenant.name.djust-app.com/pay/onboarding

This page displays the current onboarding status and provides access to the onboarding form hosted by Adyen.

⚠️

This link is unique and should only be shared with the relevant internal teams completing the onboarding.

📋 What the Merchant Must Do

Once the onboarding link is opened:

• The merchant fills in their legal, business, and bank details in Adyen's secure form.
• Adyen may request supporting documents for KYC verification.
• The onboarding process must be fully completed and verified before payments can be accepted.

📬 Support & Troubleshooting

If the merchant encounters issues with the onboarding form (e.g. link expired, validation errors), they should contact the Djust support team.

🧭 Next Steps After Onboarding

Once the merchant is verified:

• Djust will enable the account in Adyen.
• Payment methods will be activated.
• The merchant can begin accepting payments through Djust Pay.

🛠️ Future Improvements (Roadmap)

This flow is currently managed manually. A future version will support automated onboarding, allowing:

• Self-serve onboarding via API and through the Djust backoffice
• Real-time onboarding status updates
• Automated document upload handling