---
title: "Update a Payment Intent"
method: PATCH
path: "/payment-intents/{id}"
tags: ["Payments"]
---

# Update a Payment Intent

`PATCH /payment-intents/{id}`

## Path parameters

- `id` string, uuid, required

## Headers

- `Trace-Id` string
- `End-User-Agent` string
- `End-User-Ip` string
- `End-User-OS` string
- `End-User-Device-Id` string
- `End-User-Device-Manufacturer` string
- `End-User-Device-Model` string

## Request body

- PatchPaymentIntentRequestPayload
  - `targetAmount` AmountDetails — Amount that will be credited to Recipient
    - `value` number, required — Value of the currency between 1 and 99999999.99
    - `currency` 'USD', required — Currency value
  - `details` PaymentDetails
    - `accountName` string — The name of the account. Used by the receiving entity for reconciling payments.
    - `accountNumber` string — The invoice or account number. Used by the receiving entity for reconciling payments.
    - `memo` string — Short description of the payment. Used by the receiving entity for reconciling payments.
    - `disbursementInformation` object — The disbursement bank account or originator account for the payment.
      - `accountLastFour` string — Last four digits of the disbursement bank account number
      - `routingNumber` string — Routing number for the disbursement bank account
      - `bankName` string — Name of the bank for the disbursement account
    - `traceInformation` object — The trace information for locating the payment.
      - `reference` string — Number or ID of the trace information.
  - `feeAmendments` object — Fee override of the fee rate charged on a single transaction
    - `PLASTIQ_SERVICE_FEE` FeeAmendmentDetails — Fee override details indicating the rate or price and a note
      - `rate` string — The rate of the fee to apply, expressed as a percentage.
  - `metadata` PaymentMetadata — additional payment information to support operational requirements
  - `payer` PayerId, required
    - `id` string, uuid, required
  - `isExpedited` boolean — Used to expedite a payment's delivery. If `true`, the delivery date will be set to the fastest available.
  - `deliveryDate` string, date — The date to deliver the payment by. Note: will override `isExpedited` flag.

## Response `200`

Payment Intent updated successfully

- PaymentIntent
  - `id` string, uuid
  - `fees` Fee[]
    - `amount` object — Amount that will be credited to Recipient
      - `value` number, required — Value of the currency between 1 and 99999999.99
      - `currency` 'USD', required — Currency value
    - `type` 'PLASTIQ_SERVICE_FEE' | 'PLASTIQ_CROSS_BORDER_FEE' | 'DELIVERY_FEE' | 'EXPEDITED_PROCESSING_FEE' | 'EXPEDITED_HANDLING_FEE' — The type of fee applied to the payment
    - `rate` string — The rate of the fee assessed, presented in percentage.
  - `sourceAmount` object — Amount that will be credited to Recipient
    - `value` number, required — Value of the currency between 1 and 99999999.99
    - `currency` 'USD', required — Currency value
  - `targetAmount` object — Amount that will be credited to Recipient
    - `value` number, required — Value of the currency between 1 and 99999999.99
    - `currency` 'USD', required — Currency value
  - `paymentMethod` PaymentMethodId
    - `id` string, uuid, required
  - `recipient` RecipientId
    - `id` string, uuid, required
  - `payer` PayerId
    - `id` string, uuid, required
  - `details` PaymentDetails
    - `accountName` string — The name of the account. Used by the receiving entity for reconciling payments.
    - `accountNumber` string — The invoice or account number. Used by the receiving entity for reconciling payments.
    - `memo` string — Short description of the payment. Used by the receiving entity for reconciling payments.
    - `disbursementInformation` object — The disbursement bank account or originator account for the payment.
      - `accountLastFour` string — Last four digits of the disbursement bank account number
      - `routingNumber` string — Routing number for the disbursement bank account
      - `bankName` string — Name of the bank for the disbursement account
    - `traceInformation` object — The trace information for locating the payment.
      - `reference` string — Number or ID of the trace information.
  - `status` 'CAPTURABLE' | 'CAPTURED' | 'EXPIRED' | 'UNCAPTURABLE'
  - `statusReasons` object[]
  - `warnings` Warning[]
    - `code` string, required
    - `message` string, required
  - `deliveryDate` string, date
  - `createdAt` string, date-time
  - `expiresAt` string, date-time
  - `deliveryOptions` DeliveryOption[]
    - `cutoffTime` string, date-time — The date and time in which the delivery date is valid for.
    - `deliveryDate` string, date — The date the payment can be delivered by.
    - `fees` Fee[]
      - `amount` object — Amount that will be credited to Recipient
        - `value` number, required — Value of the currency between 1 and 99999999.99
        - `currency` 'USD', required — Currency value
      - `type` 'PLASTIQ_SERVICE_FEE' | 'PLASTIQ_CROSS_BORDER_FEE' | 'DELIVERY_FEE' | 'EXPEDITED_PROCESSING_FEE' | 'EXPEDITED_HANDLING_FEE' — The type of fee applied to the payment
      - `rate` string — The rate of the fee assessed, presented in percentage.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/plastiq/apis/plastiq-public-api.md) · [All operations](https://skmtc.dev/plastiq/apis/plastiq-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastiq/plastiq-public-api/revisions/cfd776dd9ac5/schema)