How can I integrate Kora as a payment gateway on my Tradly?

Ideas & Feature Request
1

I’m building a marketplace on Tradly and I’d like to integrate Kora as my payment solution. Does Tradly currently support Kora, or is there a way to connect it (via API, plugins, or custom integration)?

Thanks!

2

If you want to use Kora, there are two possible approaches:

  1. Custom Integration via API/Webhooks

  • Kora provides APIs for payments, payouts, and transaction management.

  • You can connect Kora by building a custom middleware between Tradly APIs and Kora APIs. For example:

    • Capture orders in Tradly.
    • Redirect checkout/payment to Kora.
    • Use Kora’s webhook to update payment status back into Tradly.
  1. Request as a Feature Integration
  • If Kora is important for your region/market, you can raise a feature request with us.
  • Tradly team can evaluate adding Kora as a native integration (similar to Stripe).

:backhand_index_pointing_right: For now, the fastest option is to handle it through custom API integration. If you need developer docs for Kora, check: https://developers.korapay.com/

3

Technical details for developers

Tradly’s Extension Developer Guide provides a robust framework for integrating external services—like payment gateways—through a microservice-based extension. You can absolutely leverage this to connect Kora. Here’s how:

1. Understand the Extension Framework

Tradly Extension is a microservice that:
• Listens for events from Tradly via webhooks (e.g., payment.created, order.confirmed)
• Executes custom business logic (e.g., forwarding to Kora API)
• Updates Tradly through its API once processing is completed


Common extension types include payment gateways—this is exactly suited for your Kora integration.


2. Set Up Project Structure & Webhook Configurations

You’ll follow these core steps:
• Create a project with Express, axios, .env, and other dependencies as illustrated in the guide.
• In your configs.json, define webhook endpoints and events—for example:

{
“name”: “kora-payment-extension”,
“api_events”: [
{
“route”: “/payments/create”,
“events”: [“payment.created”]
}
]
}



3. Build the Code Logic

Inside your extension:
• In controllers/feature/controller.ts, handle incoming webhook events (e.g., payment.created) and forward them to your Kora integration.
• In services, implement the logic to:
1. Authenticate with Kora (via their API credentials)
2. Send payment request data to Kora
3. Process Kora’s response
4. Inform Tradly of the result via its API (e.g., update payment status)


You can structure your code similarly to the guide’s examples (service layer, controller actions, shared utilities, etc.).


4. Deploy & Register the Extension

•	Deploy your microservice to a cloud environment (e.g., Vercel, Heroku).
•	In Tradly’s SuperAdmin panel, go to Extensions, and upload your configs.json along with your deployment URL. Then activate it.



5. Test & Troubleshoot

•	Create test transactions in your Tradly instance to trigger the payment.created event.
•	Monitor logs in your extension to verify requests to Kora are happening, and that responses are being processed back to Tradly correctly.
•	Use tools like ngrok for local testing if needed.



Step Description

  1. Framework: Use Tradly Extension microservice model for payment integration
  2. Setup: Create project structure, configs.json, webhook endpoints
  3. Logic: Handle Tradly webhook → call Kora API → update Tradly
  4. Deploy: Host your code and register it via SuperAdmin
  5. Test: Trigger payment events, monitor logs, confirm smooth flow

For full guidance, follow the Extension Developer Guide here: Tradly Docs > Extensions.