Create a charge
Create recurring charge for a given plan or client. Amount can be a fixed amount or a percentage of a plans value.
Body
Required
-
Model type that can have charges added to them. Valid types are: client, plan
-
UUID of chargeable model.
-
Employee that will be earning the revenue for this charge
-
Who is expected to pay this. Values are: client, provider and unknown
-
Expectation type. Possible values are: fee and commission
-
Expectation category. Possible 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 and unknown
-
Determines whether the charge recurs at a set frequency. False for a one off statement transactions
-
Charge frequency from the given start date. Valid frequencies are: daily, weekly, fortnightly, four_weekly, monthly, bimonthly, quarterly, biannually, and annually
-
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.
-
Frequency that describes what the percentage is calculated from. Valid frequencies are: daily, weekly, fortnightly, four_weekly, monthly, bimonthly, quarterly, biannually, and annually
-
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.
-
Whether or not to exclude this charge and its expectations from RMAR reporting.
-
Advice type for the charge. Possible values are: independent and restricted
-
Service type for the charge. Possible values are: initial, one_off and ongoing. Recurring charges must be "ongoing"
-
RMAR type for the charge. Can only be set for adjustments and unknown charge categories. All other categories are automatically calculated. Possible values are: adviser_charge, clawback, commission, other_fee and unknown. Recurring charges must be "ongoing"
-
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":"plan","chargeable_uuid":"db95352e-a7fb-40a3-acc5-354b18541921","seller_uuid":"92d2174d-04cf-4642-af8f-3859ca992034","payment_origin":"3fd414f0-26fe-479a-8099-abd3ef1f7ce4","type":"fee","category":"ongoing_fee","recurring":true,"frequency":"monthly","start_date":"2025-03-26","end_date":"2026-04-26","amount":10000,"percentage":0.75,"percentage_frequency":"annually","tax_exempt":true,"tax":0.0,"exclude_from_rmar":"string","advice_type":"independent","service_type":"ongoing","rmar_type":"adviser_charge","premium_uuid":"6f394132-3a68-45ae-b451-1d88e623b54c","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":"Ut sunt et amet nulla tempor aliquip."}'
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}
# Payload
{
"chargeable_type": "plan",
"chargeable_uuid": "db95352e-a7fb-40a3-acc5-354b18541921",
"seller_uuid": "92d2174d-04cf-4642-af8f-3859ca992034",
"payment_origin": "3fd414f0-26fe-479a-8099-abd3ef1f7ce4",
"type": "fee",
"category": "ongoing_fee",
"recurring": true,
"frequency": "monthly",
"start_date": "2025-03-26",
"end_date": "2026-04-26",
"amount": 10000,
"percentage": 0.75,
"percentage_frequency": "annually",
"tax_exempt": true,
"tax": 0.0,
"exclude_from_rmar": "string",
"advice_type": "independent",
"service_type": "ongoing",
"rmar_type": "adviser_charge",
"premium_uuid": "6f394132-3a68-45ae-b451-1d88e623b54c",
"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": "Ut sunt et amet nulla tempor aliquip."
}
{
"message": "Unauthenticated."
}