Skip to main content
POST
Payout

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

application_id
string<uuid>
required

Body

application/json

Finance payout step — extends ApprovalAction with payment details required on approval.

decision
enum<string>
required

Outcome of this step.

Available options:
APPROVED,
REJECTED
remarks
string
required

Mandatory explanation — visible to the applicant.

payment_method
enum<string> | null

Required when approving. Payout channel.

Available options:
RTGS,
EFT,
MPESA_BUSINESS,
INTERNAL_LEDGER
payment_reference
string | null

Required when approving. Bank/M-PESA transaction reference.

approved_amount

Required when approving. Final payout in KES — may differ from computed commission.

Response

Successful Response