LakiPayConnect

API reference

Endpoint reference for connected accounts, payments, and dashboard APIs.

API reference

Base URL: https://api.lakipay.co/api/v2

Endpoints below use master X-API-Key unless noted. Dashboard routes require JWT Bearer with CanActAsMaster.

Connected Accounts

POST/lakiconnect/connected-accounts

Create a new connected account under the authenticated master merchant.

Auth: X-API-Key
RBAC: RESOURCE_CONNECTED_ACCOUNTS:CREATE
GET/lakiconnect/connected-accounts

List connected accounts. Supports filters such as page, page_size, status, created_from, created_to, and q. Response includes merchant details, configuration, and pagination metadata for admin dashboards.

Auth: X-API-Key
RBAC: RESOURCE_CONNECTED_ACCOUNTS:READ
  • Query: page, page_size, status, created_from, created_to, q
GET/lakiconnect/connected-accounts/:id

Retrieve a single connected account. Returns merchant core details plus associated bank accounts and their statuses — use for detailed merchant views, KYC status display, and bank account verification.

Auth: X-API-Key
RBAC: RESOURCE_CONNECTED_ACCOUNTS:READ
POST/lakiconnect/connected-accounts/kyc-documents

Upload KYC documents for a connected account.

Auth: X-API-Key + X-Connected-Merchant-Id
  • Content-Type: multipart/form-data
  • Fields: tin, business_license, national_id
GET/lakiconnect/connected-accounts/wallet

Retrieve wallet aggregate for a connected account.

Auth: X-API-Key + X-Connected-Merchant-Id
GET/lakiconnect/connected-accounts/webhook-settings

Retrieve master LakiConnect webhook settings.

Auth: X-API-Key
PUT/lakiconnect/connected-accounts/webhook-settings

Create or update master LakiConnect webhook settings.

Auth: X-API-Key
  • Body: webhook_url (string), webhook_secret (string), webhook_enabled (boolean)
GET/lakiconnect/connected-accounts/fee-config

Retrieve fee configuration for master default or a connected account.

Auth: X-API-Key
  • Optional header: X-Connected-Merchant-Id
  • Without header: master default; with header: resolved per-connected config
PUT/lakiconnect/connected-accounts/fee-config

Upsert fee configuration for master default or a connected override.

Auth: X-API-Key
  • Optional header: X-Connected-Merchant-Id
  • Body: fee_model (FREE | PERCENT | FIXED), fee_value (number)

Payments

POST/payment/direct

Initiate a direct payment attributed to a connected merchant.

Auth: X-API-Key
  • Optional: X-Connected-Merchant-Id (enables split settlement)
POST/payment/checkout

Create a hosted checkout session optionally tied to a connected merchant.

Auth: X-API-Key
  • Optional: X-Connected-Merchant-Id

Dashboard (JWT)

All dashboard routes require a JWT Bearer token and CanActAsMaster permission.

GET/lakiconnect/dashboard/connected-accounts

List connected accounts.

Auth: JWT Bearer
GET/lakiconnect/dashboard/connected-accounts/:id

Get account detail with resolved fee context.

Auth: JWT Bearer
PUT/lakiconnect/dashboard/connected-accounts/:id/price-config

Update fee config for an account.

Auth: JWT Bearer
GET/lakiconnect/dashboard/connected-accounts/:id/transactions

List transactions for an account.

Auth: JWT Bearer
GET/lakiconnect/dashboard/connected-accounts/:id/wallet-balance

Wallet balance for an account.

Auth: JWT Bearer

Pagination

List endpoints return a consistent pagination envelope:

json
{
  "data": [...],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 150,
    "total_pages": 8
  }
}

Pass ?page=2&per_page=50 to navigate pages.

Continue reading

Security best practices

API key management, webhook security, transport, and production deployment.