Configure API Transaction Fee Responsibility

Requires authenticated user session, active business context, verified business (businessGuard.verified), and role permissions.

Determine who bears transaction fees for API-initiated transfers on your business account. Choose whether fees should be deducted from the business's designated fee wallet or charged directly to the initiating API wallet. This setting applies to transfers made through your API integration and can be updated at any time.

Request body — parameters

Validation rules

• If charge_branch_for_api_wallet_transfer is true, fee_wallet_id_for_api_wallet_transfer must be provided.
• Invalid or ineligible fee wallets may fail silently in the handler (no error returned); consider documenting this as a known limitation or fixing in a follow-up.

{
  "charge_branch_for_api_wallet_transfer": true,
  "fee_wallet_id_for_api_wallet_transfer": "wallet-uuid-here"
}

{
  "status": true,
  "message": "API fee wallet settings updated successfully"
}

{
  "status": true,
  "message": "One or more validation errors occurred",
  "errors": [
    {
      "field": "fee_wallet_id_for_api_wallet_transfer",
      "message": "fee_wallet_id_for_api_wallet_transfer is required when charge_branch_for_api_wallet_transfer is true"
    }
  ]
}