Create upfront commitment with true-up

1 min

POST

https://app.amberflo.io/payments/pricing/amberflo/customer-commitment/upfront_commitment_with_true_up

Creates a customer commitment contract with upfront payment and end-of-period true-up reconciliation.

This requires customers to pay in advance for committed usage levels, with upfront payments converting to service credits. At period end, the system reconciles actual vs. committed usage and applies billing adjustments as needed.

Use this for customers seeking discounted rates through upfront payment, organizations with predictable usage patterns, or volume discount scenarios requiring usage commitments with advance payments.

Under-consumption: May result in credit extensions or partial refunds
Over-consumption: Additional billing for usage beyond committed levels
Reward Fulfillment: Bonus credits awarded for meeting commitment targets

bodyobjectUpfront contract generator with prepaid input configuration, rewards, promotions, and true-up settings for advance payment commitments

200Upfront commitment with true-up successfully created

400Bad request - invalid upfront payment parameters or true-up configuration

403Forbidden - customer not eligible for upfront commitment terms

409Conflict - upfront commitment conflicts with existing customer agreements

curl --request POST \
     --url https://app.amberflo.io/payments/pricing/amberflo/customer-commitment/upfront_commitment_with_true_up \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "type": "upfront_commitment_with_true_up",
     "customerId": "",
     "planId": "",
     "planOverrideGenerator": {
     "type": "custom_pricing_plan",
     "id": "",
     "billingPeriod": {},
     "planName": "",
     "entitlements": [
     {
     "id": "",
     "apiName": ""
     }
     ],
     "priceGenerators": {
     "dimensionKeys": [],
     "productItemId": "",
     "priceTiers": [
     {
     "leafNodeType": ""
     }
     ],
     "type": "cost_plus_dimension"
     },
     "invoiceBasedFees": {
     "type": "constant_invoice_ratio_fee"
     }
     },
     "label": "",
     "cycles": 0,
     "trueup": {
     "minimumPayment": "",
     "interval": ""
     },
     "upfrontPayment": {
     "value": "",
     "label": ""
     },
     "reward": {
     "value": "",
     "label": ""
     },
     "exitClauses": {
     "type": "termination_grace_period",
     "gracePeriodInDays": 0
     }
     }'