Create a charge Run in API Explorer
Create recurring charge for a given plan or client. Amount can be a fixed amount or a percentage of a plans value.
Body
-
Model type that can have charges added to them.
Values are
clientorplan. -
UUID of chargeable model.
-
Employee that will be earning the revenue for this charge
-
Who is expected to pay this.
Value Description client Client provider Provider unknown Unknown Values are
client,provider, orunknown. -
Expectation type.
Value Description fee Fee commission Commission Values are
feeorcommission. -
Expectation category.
Value Description adhoc Adhoc administration Administration adjustment Adjustment bond_renewal Bond Renewal clawback Clawback dss_rebate Dss Rebate fund Fund indemnity Indemnity initial_fee Initial Fee level Level non_indemnity Non Indemnity one_off One Off ongoing_fee Ongoing Fee other_fee Other Fee procuration_fee Procuration Fee protected_rights Protected Rights renewal Renewal switch Switch unknown Unknown Values are
adhoc,administration,adjustment,bond_renewal,clawback,dss_rebate,fund,indemnity,initial_fee,level,non_indemnity,one_off,ongoing_fee,other_fee,procuration_fee,protected_rights,renewal,switch, orunknown. -
Determines whether the charge recurs at a set frequency. False for a one off statement transactions
-
Charge frequency from the given start date.
Value Description daily Daily weekly Weekly fortnightly Fortnightly four_weekly Four Weekly monthly Monthly bimonthly Bimonthly quarterly Quarterly biannually Biannually annually Annually Values are
daily,weekly,fortnightly,four_weekly,monthly,bimonthly,quarterly,biannually, orannually. -
Date the recurring charge starts from.
-
Date the recurring statement transactions will stop. Leave blank for indefinitely or until charge schedule is deleted.
-
The fixed amount value as an integer in pennies. Required when not providing a percentage or when chargeable_type is client.
-
Percentage of plans value as a charge. Required when not providing a fixed amount. Cannot use percentage for a client chargeable_type.
Minimum value is
0.0, maximum value is100.0. -
Frequency that describes what the percentage is calculated from.
Value Description daily Daily weekly Weekly fortnightly Fortnightly four_weekly Four Weekly monthly Monthly bimonthly Bimonthly quarterly Quarterly biannually Biannually annually Annually Values are
daily,weekly,fortnightly,four_weekly,monthly,bimonthly,quarterly,biannually, orannually. -
Denotes whether the charge is exempt from tax.
-
Percentage tax to be added on to net amount of charge. Will use fims default tax rate if not provided and charge is not tax exempt.
Minimum value is
0.0, maximum value is100.0. -
Whether or not to exclude this charge and its expectations from RMAR reporting.
-
Advice type for the charge.
Value Description independent Independent restricted Restricted Values are
independentorrestricted. -
Service type for the charge. Recurring charges must be "ongoing"
Value Description initial Initial one_off One Off ongoing Ongoing Values are
initial,one_off, orongoing. -
RMAR type for the charge. Can only be set for adjustments and unknown charge categories. All other categories are automatically calculated. Recurring charges must be "ongoing"
Value Description adviser_charge Adviser Charge clawback Clawback commission Commission other_fee Other Fee unknown Unknown Values are
adviser_charge,clawback,commission,other_fee, orunknown. -
RMAR advice area values. Required for charges made directly on a client. All amounts are in pennies and must total the charge net amount.
-
Notes to add on to the charge.
curl \
--request POST 'https://api.plannrcrm.com/api/v1/charge' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
--data '{"chargeable_type":"client","chargeable_uuid":"8db4f81e-3004-49e0-830d-0eb3118aea8d","seller_uuid":"f487e284-2ab1-475e-a23c-d435f4313cf0","payment_origin":"client","type":"fee","category":"adhoc","recurring":true,"frequency":"daily","start_date":"2025-09-24","end_date":"2026-10-24","amount":10000,"percentage":11.0,"percentage_frequency":"daily","tax_exempt":true,"tax":17.5,"exclude_from_rmar":false,"advice_type":"independent","service_type":"initial","rmar_type":"adviser_charge","premium_uuid":"fc926157-d341-4054-a73a-5c282514e0cc","advice_area":{"deposit":7500,"unknown":0,"non_rmar":0,"non_regulated":0,"retail_investment":0,"regulated_mortgage":2500,"other_fca_regulated":0,"non_investment_insurance":0},"notes":"Note contents relevant to the charge."}'
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}
# Payload
{
"chargeable_type": "client",
"chargeable_uuid": "8db4f81e-3004-49e0-830d-0eb3118aea8d",
"seller_uuid": "f487e284-2ab1-475e-a23c-d435f4313cf0",
"payment_origin": "client",
"type": "fee",
"category": "adhoc",
"recurring": true,
"frequency": "daily",
"start_date": "2025-09-24",
"end_date": "2026-10-24",
"amount": 10000,
"percentage": 11.0,
"percentage_frequency": "daily",
"tax_exempt": true,
"tax": 17.5,
"exclude_from_rmar": false,
"advice_type": "independent",
"service_type": "initial",
"rmar_type": "adviser_charge",
"premium_uuid": "fc926157-d341-4054-a73a-5c282514e0cc",
"advice_area": {
"deposit": 7500,
"unknown": 0,
"non_rmar": 0,
"non_regulated": 0,
"retail_investment": 0,
"regulated_mortgage": 2500,
"other_fca_regulated": 0,
"non_investment_insurance": 0
},
"notes": "Note contents relevant to the charge."
}
{
"message": "Unauthenticated."
}