---
title: "Update Charge"
method: PUT
path: "/charges/{charge_id}"
tags: ["charges"]
---

# Update Charge

`PUT /charges/{charge_id}`

Update an existing charge.

## Path parameters

- `charge_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Request body

- ChargeUpdate — Schema for updating a charge.
  - `reference` string, nullable — Reference provided by tenant

## Response `200`

Successful Response

- ChargeResponse — Schema for charge responses.
  - `org_id` string, uuid, required — ID of the organization
  - `instrument_id` string, uuid, nullable — ID of the payment instrument
  - `customer_id` string, uuid, nullable — ID of the customer
  - `amount` number, required — Charge amount
  - `currency` 'mxn' | 'cop' | 'brl' | 'usd' | 'eur' | 'gbp' — Currency enum.
  - `reference` string, nullable — Reference provided by tenant
  - `inline_instrument` object, nullable — Inline instrument data
  - `inline_customer` object, nullable — Inline customer data
  - `id` string, uuid, required
  - `status` 'verification_in_progress' | 'pending' | 'processing' | 'confirmed' | 'declined' | 'chargeback' | 'canceled', required — Charge status enum.
  - `declined_reason` 'insufficient_funds' | 'account_blocked' | 'undetermined' | 'risk_engine' | 'account_does_not_exist' | 'account_canceled' | 'account_in_other_currency' | 'account_not_belongs_to_bank' | 'transaction_duplicated' | 'client_order_declined_pay_to_issuer' | 'client_order_amount_is_more_than_authorized' | 'client_order_canceled' | 'client_service_not_authorized' | 'payment_order_expired' | 'client_rejected_charge' — Declined reason enum.
  - `declined_reason_rail` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `chargeback_at` string, date-time, nullable
  - `result_at` string, date-time, nullable
  - `risk_status` 'pending' | 'ok' | 'cancelled_by_risk' — Risk evaluation outcome for a charge.
  - `risk_evaluated_at` string, date-time, nullable
  - `risk_reasons` string[], nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/monato/apis/direct-debit-service.md) · [All operations](https://skmtc.net/monato/apis/direct-debit-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monato/direct-debit-service/versions/23bb85042119/schema)