Skip to main content

Build with Clive Payments

Clive Payments is a cross-border acquiring and settlement layer that helps partners like Echezona collect card payments, monitor outcomes, and settle merchant balances with clear fee transparency.

What this platform does​

  • Accepts partner transaction initialization requests with strict security controls.
  • Tracks payment lifecycle events from Stripe (initialized -> pending -> succeeded or terminal states).
  • Calculates fee split across processor fees, partner payout, and Clive earnings.
  • Notifies partner systems with signed webhooks.
  • Batches and pays settlements through payout rails.

Product model​

  • Partner: Payment company integrating with Clive (example: Echezona).
  • Client: Merchant under partner (example: Air Peace).
  • Transaction: Single payment tracked by Clive and linked to Stripe PaymentIntent.
  • Settlement Batch: Group of succeeded transactions paid out together.

Base URL​

https://<your-host>/api/v1

API lifecycle at a glance​

  1. Initialize transaction (POST /transactions/initialize)
  2. Attach Stripe intent (POST /transactions/attach-intent)
  3. Receive Stripe webhook updates (Clive internal endpoint)
  4. Receive Clive partner status webhook (your endpoint)
  5. Settle and payout batches