Extensions

Guides for building custom implementations of the Bridge's extension points

The G2P Bridge is extensible: the parts that touch external systems are pluggable, so you can adapt it to a specific country, sponsor bank, or delivery model without forking the core.

Start here → How to write your own connector — the end-to-end flow: implement an interface, extend the published Bridge Docker image (FROM … + pip install), select it via config, and deploy. The guides below give the method-by-method contract for each individual interface.

Each guide below describes the interface and how to provide your own implementation:

• Financial address resolver — resolve a beneficiary ID to a financial address (e.g. with SPAR).

• Sponsor Bank connector — integrate a real sponsor bank in place of the Example Bank.

• Geo resolver — resolve geography for in-kind allocation.

• Warehouse allocator / Agency allocator — in-kind fulfilment allocation.

• Notification connector — deliver notifications to partners and beneficiaries.

For the conceptual overview of these extension points, see Features → Extensibility.