Change a charge | Fleetwire

curl -X PATCH https://api.fleetwire.io/api/partners/v1/companies/9b1d6c3e-2f4a-4b8e-9c71-5d0e8a3f2b11/charges/tc_8812 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "status": "voided",
  "reason": "Agency reversed the toll"
}'

{
  "data": {
    "charge_id": "string",
    "external_id": "string",
    "kind": "toll",
    "rental_id": "string",
    "match": "provided",
    "status": "unmatched",
    "amount_cents": 1,
    "provider_fee_cents": 1,
    "currency": "string",
    "occurred_at": "2024-01-15T09:30:00Z",
    "has_document": true,
    "authority_status": "paid_at_authority",
    "created_at": "2024-01-15T09:30:00Z",
    "voided_at": "2024-01-15T09:30:00Z"
  }
}

`status`	Also send	Effect
`voided`	`reason`?	Taken off the renter’s bill. If they already paid, they’re refunded on a new invoice.
`amount_changed`	`amount_cents`, `reason`?	Re-billed at the new amount (`0` voids it). A paid amount is refunded and re-billed, never edited in place.
`paid_at_authority`		Recorded; shown as `authority_status`.
`disputed`		Recorded; shown as `authority_status`.
`dispute_resolved`	`amount_cents`	`0` voids the charge; another amount re-bills it.

Authentication

AuthorizationBearer

Your partner key, starting with fwp_, sent as Authorization: Bearer fwp_…. Keep it server-side. Fleetwire can rotate it at any time; the old key stops working as soon as a new one is issued.

Path parameters

company_idstringRequiredformat: "uuid"

The Fleetwire company ID from GET /companies.

external_idstringRequired<=191 characters

Your external_id for the charge.

Request

This endpoint expects an object.

statusenumRequired

Allowed values:

amount_centsintegerOptional0-10000000

Required for amount_changed and dispute_resolved. 0 voids the charge.

reasonstringOptional<=200 characters

Response

The updated charge.

dataobject

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error