Developer Documentation

Merchant Dashboard API

Merchant Dashboard API

Base URL: https://api.sikaahub.com/v1

The merchant dashboard API supports https://dashboard.sikaahub.com. Endpoints require Authorization: Bearer {token} and are scoped to the authenticated merchant owner or active merchant staff member.

Summary

GET /dashboard/merchant/summary

Returns merchant profile status, wallet balance, same-day payment and withdrawal totals, commission earned, pending work, QR status, and provider health summary.

Analytics

• GET /dashboard/merchant/analytics/transactions
• GET /dashboard/merchant/analytics/payments
• GET /dashboard/merchant/analytics/withdrawals
• GET /dashboard/merchant/analytics/commissions

Query filters:

• from=YYYY-MM-DD
• to=YYYY-MM-DD
• group_by=hour|day|week|month
• status=successful|failed|pending
• type=payment|withdrawal|commission

Operations

• GET /dashboard/merchant/transactions
• GET /dashboard/merchant/payments
• GET /dashboard/merchant/payments/{id}
• GET /dashboard/merchant/payments/{id}/receipt
• GET /dashboard/merchant/withdrawals
• GET /dashboard/merchant/withdrawals/{id}
• GET /dashboard/merchant/withdrawal-requests
• POST /dashboard/merchant/withdrawal-requests/{id}/approve
• POST /dashboard/merchant/withdrawal-requests/{id}/reject
• POST /dashboard/merchant/withdrawal-requests/{id}/complete

Lists use cursor pagination with limit and cursor. Sensitive actions require X-Device-ID; withdrawal completion also requires transaction_pin and cash_given=true.

QR, Profile, Settings

• GET /dashboard/merchant/qr
• POST /dashboard/merchant/qr/regenerate
• GET /dashboard/merchant/qr/download
• GET /dashboard/merchant/profile
• PUT /dashboard/merchant/profile
• GET /dashboard/merchant/settings
• PUT /dashboard/merchant/settings

QR regeneration and settlement preference changes require transaction PIN confirmation.