MKSD Connect documentation

MKSD Connect is a sandbox B2B payment and reconciliation hub for MKSD Group merchants in Sudan. One integration surface covers payment requests, hosted invoices, signed webhooks, and settlement previews — all against mock providers with controllable outcomes.

info

This platform does not process live bank, wallet, or card-network payments. There is no Central Bank of Sudan, EBS, or licensed live PSP connection in this product. Sandbox only.

What you can build

Server-to-server payment requests in SDG with idempotency
Hosted invoice checkout (card + sandbox Apple Pay / Samsung Pay)
Webhook consumers that verify HMAC signatures
Reconciliation against simulated provider CSV reports
Settlement previews and sandbox fee invoices

Quick start

Open the merchant portal and sign in with the demo merchant
Go to Settings → API keys and create or regenerate a sandbox secret key
Create a payment with an Idempotency-Key (see Payments)
Or create an invoice and open its checkout_url (see Invoices)
Inspect status in Payments, then import a provider CSV under Reconciliation

tip

Demo merchant: merchant@demo.local / <SEED_MERCHANT_PASSWORD>

Base URL

Environment	Base URL
Local API	`http://localhost:8000/api/v1`
Portal	`http://localhost:3000`
OpenAPI	`http://localhost:8000/docs`

All amounts are decimal strings (for example "250.00"). Default currency is SDG. Do not use floating-point math for money.

Next steps

Authentication — API keys and Bearer JWT
Payments — create, retrieve, cancel, refund
Invoices — hosted checkout and 3DS sandbox
Sandbox & test cards — scenarios and 4111… cards