ImpactPay URL

The ImpactPay URL is a way to add a post-purchase impact journey in an offline context such as receipts, email, or SMS. Rather than embedding an SDK, you generate a hosted link that customers can follow.

While simple to implement, it does mean you’ll need to build and style the component or link in your own UI. Our team can support you with design guidance to make sure the experience feels seamless.

Step-by-step flow

1. Create a brand. Use POST /organisations/brand/onboarding to create a brand and get a productId.

2. Calculate carbon impact. Call POST /impactpay/calculate with the productId and order details. The response includes a calcReference.

3. Build the hosted URL. Construct the ImpactPay URL with the calcReference:

   • Sandbox: https://impactpay-sandbox.ekko.earth/carbon?referenceId=<CALCREFERENCE>
   • Production: https://impactpay.ekko.earth/carbon?referenceId=<CALCREFERENCE>

4. Share the URL with customers. Add it to SMS, receipts, or post-purchase emails. Customers are taken to an ekko-hosted page where they can review their impact and make a contribution.

5. Records and reconciliation. Contributions and reversals appear in Impact Records. Since ekko processes the contribution, settlement shows fundsFlow = receivable for the client’s service-fee share.

Best practices

• Use this flow when you want to add an impact journey in an offline context
• Set up webhooks to be notified of consumer compensations
• Track click-through and compensation rates to measure engagement