Twill Brain

#448 Add Luqra merchants

2 min read

#448 — Add Luqra merchants

Repo: Twill-AI/facade State: closed | Status: done Assignee: nadddder, sparsh-twillpayments

Created: 2025-07-30 · Updated: 2025-11-04

Description

We need to support including Luqra merchants in the partner portal. Considerations:

  • API documentation: https://docs.luqra.com/
  • no sandbox from Luqra, only Prod API available. So only fetch data, nothing the other way
  • Onboarding workflow is out of scope of this ticket: User submits an application, Mike decided to put them on Luqra (independent from PayEngine) and submits application manually
  • On every sync, all merchants should be fetched from Luqra and included with all details.

Implementation Plan: https://twillpayments.atlassian.net/wiki/spaces/TD/pages/448069634/Luqra+Integration

AC:

  • Add Source in Merchant table
  • Investigate Luqra API documentation Portal for reliable source
  • Implement merchant data fetcher
  • Extract and map merchant fields
  • Sync merchants into partner portal backend
  • Add unit test cases

09-Oct-2025

  • Update total processing volume of PE be total processing volume of the month not the year
  • Remove source column from merchant table
  • Add luqra mid and application id in merchant table
  • Make partner id nullable in merchant and merchant officer table
  • Plan to merchant sync between PE and Luqra
  • Update Total Volume in Luqra Merchants
  • Add mechanism for syncing merchant from luqra for both type of merchants which are mapped to partner and which are not
  • Update merchant persist
  • Update unit test cases
  • Update sync job function

10-Oct-2025

  • APIs for mapping luqra

Notes

Add implementation notes, blockers, and context here

Add wikilinks to related people, meetings, or other tickets

Graph View