Error
A valid request URL is required to generate request examples{
"policy_version": "<string>",
"finance_policy_approvals_verified": true,
"topup_enabled": true,
"topup_service_fee_idr": 1,
"topup_service_fee_tax_idr": 1,
"topup_service_fee_policy_version": "<string>",
"referral_reward_enabled": true,
"referral_formula": "fixed",
"referral_amount_idr": 1,
"referral_percentage": 0.5,
"referral_max_amount_idr": 1,
"referral_max_completed_courses_per_referred_user": 50,
"referral_max_total_per_referred_user_idr": 1,
"referral_max_total_budget_idr": 1,
"referral_policy_version": "<string>",
"wallet_purchase_enabled": true,
"instructor_withdrawal_enabled": true,
"instructor_withdrawal_minimum_idr": 1,
"instructor_withdrawal_maximum_idr": 1,
"instructor_withdrawal_policy_version": "<string>",
"finance_withdrawal_simulation_enabled": true,
"course_refund_enabled": true,
"course_refund_window_hours": 360,
"instructor_earnings_enabled": true,
"instructor_share_bps": 5000,
"instructor_earning_hold_hours": 43800,
"instructor_share_basis": "price_after_discount_ex_tax",
"instructor_earning_policy_version": "<string>",
"platform_payout_enabled": true,
"platform_payout_simulation_enabled": true,
"platform_payout_safety_reserve_idr": 1,
"platform_payout_maximum_idr": 1,
"platform_payout_destination_ref": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"updated_by": "<string>"
}{
"code": "unauthorized",
"message": "<string>",
"request_id": "<string>"
}{
"code": "unauthorized",
"message": "<string>",
"request_id": "<string>"
}{
"code": "unauthorized",
"message": "<string>",
"request_id": "<string>"
}Finance
Put adminfinancepolicy
Super-admin only. Uses optimistic version checking and appends an audit record. Financial features and referrals are disabled with zero budgets by default; production also requires the environment hard veto.
PUT
/
admin
/
finance
/
policy
Error
A valid request URL is required to generate request examples{
"policy_version": "<string>",
"finance_policy_approvals_verified": true,
"topup_enabled": true,
"topup_service_fee_idr": 1,
"topup_service_fee_tax_idr": 1,
"topup_service_fee_policy_version": "<string>",
"referral_reward_enabled": true,
"referral_formula": "fixed",
"referral_amount_idr": 1,
"referral_percentage": 0.5,
"referral_max_amount_idr": 1,
"referral_max_completed_courses_per_referred_user": 50,
"referral_max_total_per_referred_user_idr": 1,
"referral_max_total_budget_idr": 1,
"referral_policy_version": "<string>",
"wallet_purchase_enabled": true,
"instructor_withdrawal_enabled": true,
"instructor_withdrawal_minimum_idr": 1,
"instructor_withdrawal_maximum_idr": 1,
"instructor_withdrawal_policy_version": "<string>",
"finance_withdrawal_simulation_enabled": true,
"course_refund_enabled": true,
"course_refund_window_hours": 360,
"instructor_earnings_enabled": true,
"instructor_share_bps": 5000,
"instructor_earning_hold_hours": 43800,
"instructor_share_basis": "price_after_discount_ex_tax",
"instructor_earning_policy_version": "<string>",
"platform_payout_enabled": true,
"platform_payout_simulation_enabled": true,
"platform_payout_safety_reserve_idr": 1,
"platform_payout_maximum_idr": 1,
"platform_payout_destination_ref": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"updated_by": "<string>"
}{
"code": "unauthorized",
"message": "<string>",
"request_id": "<string>"
}{
"code": "unauthorized",
"message": "<string>",
"request_id": "<string>"
}{
"code": "unauthorized",
"message": "<string>",
"request_id": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Response
Policy updated and audited.
New value required on every update and copied to each enabled component policy version.
Required string length:
1 - 64Recorded approval state; production still requires the separate environment hard veto.
Required range:
x >= 0Required range:
x >= 0Available options:
fixed, percentage Required range:
x >= 0Decimal fraction; 0.05 equals 5 percent.
Required range:
0 <= x <= 1Maximum single course-completion award. Required above zero when referral is enabled.
Required range:
x >= 0Required range:
1 <= x <= 100Required range:
x >= 0Cumulative lifetime reward ceiling; cannot be reset through the policy API.
Required range:
x >= 0Required range:
x >= 0Required range:
x >= 0Required range:
0 <= x <= 720Required range:
0 <= x <= 10000Required range:
0 <= x <= 87600Available options:
price_after_discount_ex_tax Required range:
x >= 0Required range:
x >= 0Was this page helpful?