Payment webhook
Webhook endpoint for payment gateway events. Used by Paystack to notify payment status.
/v1/payments/webhookHeader Parameters
Paystack webhook signature for verification
Response Body
application/json
curl -X POST "https://example.com/v1/payments/webhook" \ -H "x-paystack-signature: string" \ -H "user-agent: string"{ "success": true, "statusCode": 200, "message": "Request processed successfully", "timestamp": "2025-10-20T16:30:00.000Z", "path": "/v1/auth/register", "data": { "success": true, "event": "charge.success", "reference": "REF_1634567890123", "message": "Webhook processed successfully" }}Admin adjust / clawback organisation wallet (audited)
Signed, audited wallet adjustment — the single sanctioned manual mutation path (ADR-013). Positive amount credits; negative amount debits/claws back. Writes a transactions row, journals a wallet_ledgers entry (operationId adj:<ref>, with reason + adjustedBy), updates the durable Postgres balance and syncs the Redis mirror — replacing raw Redis/SQL edits. A reason is mandatory; adjustments above WALLET_ADJUST_APPROVAL_THRESHOLD require a secondApprover. Admin only.
Get all transactions
Retrieve all payment transactions for the authenticated organisation.