How to set up Koalect for SextANT P2P Integration
To enable the automatic creation of SextANT P2P campaigns from Koalect projects, RaiseNow might need to activate the project creation notification from Koalect to the backend.
From Koalect project to SextANT P2P campaign
To create a P2P campaign in SextANT, a campaigner first creates a project under a specific Koalect campaign. In SextANT, each P2P campaign is created under a defined SextANT purpose (PaymentOption), so Koalect must supply the necessary SextANT purpose reference when the project is created.
There are two possible ways to provide this purpose reference in Koalect:
-
Inherited from the beneficiary: The Koalect campaign may inherit a SextANT purpose reference from the associated beneficiary via the benefiting_reference field (labelled Reference in the UI).
-
Set via the project creation form: Alternatively, the SextANT purpose reference can be defined explicitly in the project creation form using the external_reference field (labelled Main Reference in the UI).
When the project is created, its unique project_id in Koalect will be used to generate a corresponding P2P Campaign in SextANT under the given SextANT purpose. This forms the SextANT P2P campaign structure.
From Koalect project contribution to SextANT P2P Payment
When a donor makes a contribution to a Koalect project, this payment must be recorded in SextANT as a donation, linked to the P2P campaign that was previously created. Again its unique project_id in Koalect will be used to generate the payment under the corresponding P2P Campaign in SextANT.
Fallback values
To ensure data integrity and continuous delivery to SextANT, fallback mechanism is in place:
- If no SextANT purpose reference is set on the Beneficiary or in the project creation forms, the backend will apply a predefined fallback purpose reference (fallback-p2p-purpose).
Field mapping & resolution order
The following table outlines the order in which purpose references are resolved during project creation processing
Project Creation → SextANT P2P Campaign
| Priority | Source | Field Label | API Field | SextANT Field |
|---|---|---|---|---|
| 1 | Beneficiary | Reference | benefiting_reference | SextANT PaymentOption |
| 2 | Project Form | Main Reference | external_reference | SextANT PaymentOption |
| 3 | Backend | Fallback | fallback-p2p-purpose | SextANT PaymentOption |