For this solution, YouLend are responsible for splitting the funds. This solution requires no development work from the partner because no calculation of the sweep or withholding of funds needs to take place at the partner level.

This rerouting approach is the standard method we use across all our payment processing partnerships. It’s also widely adopted for routing payments from acquirers we’re not partnered with.

There are 3 ways that this can be adopted:

1. Automated process powered by API
2. Offline process, arranged by Partner and YouLend
3. Offline process, arranged by merchant

These solutions all work identically after a merchant is funded, the differences are entirely in the set up. After a merchant is funded the flow is:

1. Each day, the merchant's payout from the partner gets sent to the YouLend virtual accounts (one payment per account, one account per merchant).
2. When funds reach this account, YouLend will retain the sweep % owed and forward the remaining funds on to the merchant immediately.
3. Merchants can track their settlements via their YouLend dashboard, which clearly displays daily sales, repayments, and amounts settled. (See attachment.)

Offline process, arranged by Partner and YouLend

This is our most common approach for non-integrated or minimally integrated partners. It requires no technical development and minimal operational effort from the partner, while providing a smooth merchant experience.

Operational procedure for funding

1. Merchant is approved for funding
2. YouLend notifies partner via a dedicated email inbox, sharing merchant details and the relevant YouLend virtual account.
3. YouLend disburse the funds
4. Partner change the payout bank account for the merchant within 24-48 hours

Offline process, arranged by merchant

This option is used when our partner lacks the resources to assist directly, or when rerouting flow from a non-partner acquirer.

Operational procedure for funding

1. Merchant is approved for funding
2. YouLend provides merchant with a virtual account and instructions for updating their partner payout
3. Merchant completes the update
4. Partner processes the change via their standard change of bank process
5. YouLend receives settlement from the next batch
6. YouLend disburses funds

Automated process powered by API

Use the automated change of bank process when the merchant’s payout or settlement route needs to be updated to the YouLend settlement account before funding can proceed.

YouLend will notify you when the settlement account details are ready. You should then retrieve the account details, update the merchant payout route on your side, and confirm back to YouLend once the change has been completed.

How it works

1. Receive the settlement account ready webhook

YouLend will send the ONB10035 webhook when the settlement or repayment account details are ready to fetch.

Example event:

{
  "EventCode": "ONB10035",
  "Message": "The Settlement/Repayment account details are ready to fetch from the AOL endpoint to begin the re-routing process",
  "EventProperties": {
    "LeadId": "511898ff-3a66-4ebd-8508-22c94c05416e"
  }
}

Use the LeadId from the webhook to retrieve the settlement account details.

2. Retrieve the settlement account details

Call the account opening letter endpoint using the LeadId from the webhook. This endpoint returns the settlement account details that should be used for the merchant’s payout route.

Example response:

[
  {
    "iban": "DK7389000112017272",
    "virtualIban": "DK8389222292389284",
    "secondaryVirtualIban": "GB85SAPY62838292389284",
    "accountName": "Test Company Limited - SXP Settlement - GBP",
    "currencyISOCode": "GBP",
    "accountOpeningLetter": {
      "documentId": "7fd7c2b5-37fc-4df8-a710-dbfbf5a5cef1",
      "document": "JVBERi0xLjYKJeLjz9MKMjI",
      "documentName": "Test Company Limited - Account Opening Letter.pdf",
      "documentType": "application/pdf"
    },
    "domesticAccountNumber": "92389284",
    "domesticSortCode": "628382",
    "partner": "Test Account",
    "swift": "SXPYDKKK",
    "thirdPartyCustomerId": "89ab144"
  }
]

3. Update the merchant payout route

Once you have retrieved the settlement account details, update the merchant payout or settlement bank account in your system.

Only confirm completion to YouLend once the account update has been completed.

4. Confirm change of bank completion

After the merchant payout route has been updated, notify YouLend that the change of bank process is complete. This endpoint marks the change of bank process as complete for the lead.

Important rules

• Only call the completion endpoint once the payout route has been updated.
• The leadId used to retrieve the account details should be the same leadId used to confirm completion.
• If the account update fails, do not call the completion endpoint.
• If the settlement account details cannot be applied, contact YouLend through the agreed channel.

Related API reference

• Webhook events
• List settlement details with an account opening letter
• Complete change of bank process