Update a payment intent's amount | Monite Documentation

curl -X PATCH https://api.sandbox.monite.com/v1/payment_intents/payment_intent_id \
     -H "x-monite-version: 2024-05-25" \
     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "amount": 125000
}'

{
  "id": "id",
  "updated_at": "2024-01-15T09:30:00Z",
  "amount": 125000,
  "currency": "EUR",
  "payment_methods": [
    "sepa_credit",
    "card"
  ],
  "recipient": {
    "id": "id",
    "type": "entity",
    "bank_accounts": [
      {
        "id": "id",
        "account_holder_name": "Bob Jones",
        "account_number": "12345678",
        "bic": "DEUTDEFFXXX",
        "country": "AF",
        "currency": "AED",
        "display_name": "Primary account",
        "iban": "DE74500700100100000900",
        "is_default": true,
        "name": "Primary account",
        "routing_number": "routing_number",
        "sort_code": "123456",
        "was_created_by_user_id": "was_created_by_user_id"
      }
    ],
    "name": "name"
  },
  "status": "status",
  "application_fee_amount": 1,
  "batch_payment_id": "batch_payment_id",
  "invoice": {
    "due_date": "due_date",
    "file": {
      "mimetype": "application/pdf",
      "name": "INV-00042.pdf",
      "url": "https://example.com/path/to/invoice.pdf"
    },
    "issue_date": "issue_date"
  },
  "object": {
    "id": "id",
    "type": "payable"
  },
  "payer": {
    "id": "id",
    "type": "entity",
    "bank_accounts": [
      {
        "id": "id",
        "account_holder_name": "Bob Jones",
        "account_number": "12345678",
        "bic": "DEUTDEFFXXX",
        "country": "AF",
        "currency": "AED",
        "display_name": "Primary account",
        "iban": "DE74500700100100000900",
        "is_default": true,
        "name": "Primary account",
        "routing_number": "routing_number",
        "sort_code": "123456",
        "was_created_by_user_id": "was_created_by_user_id"
      }
    ],
    "name": "name"
  },
  "payment_link_id": "payment_link_id",
  "payment_reference": "PRJ/2025/0045",
  "provider": "provider",
  "selected_payment_method": "sepa_credit"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

payment_intent_idstringRequired

ID of an existing payment intent you want to update.

Request

This endpoint expects an object.

amountintegerRequired

The new payment amount in minor units.

The new payment amount in [minor units](https://docs.monite.com/references/currencies#minor-units).

Response

Successful Response

idstringformat: "uuid"

A unique ID of this payment intent.

updated_atdatetime

UTC date and time when this payment intent was last updated.

amountinteger

The payment amount in minor units.

currencystring

The payment currency, as a three-letter ISO currency code.

payment_methodslist of enums

recipientobject

The payment recipient - either the current entity (in case of accounts receivable invoice payments) or a counterpart (in case of accounts payable bill payments).

statusstring

The status of the payment intent.

application_fee_amountinteger

batch_payment_idstringformat: "uuid"

Reserved for internal use.

invoiceobject

objectobject

If the payment link was created for a payable or receivable invoice stored in Monite (rather than an external invoice or a one-off payment), this object contains the ID of that payable or receivable.

payerobject

payment_link_idstringformat: "uuid"

ID of the payment link associated with this payment intent. The payment link object contains the URL of the payment page.

payment_referencestring

The payment reference. If not provided explicitly by the client, Monite uses the invoice number (document_id) as the payment reference.

Note: Monite normalizes payment references for certain types of payments when passing information to the payment processing provider.

providerstring

Reserved for internal use.

selected_payment_methodenum

The payment method selected by the payer on the payment page, or null if the payment has not been initiated.

Errors

401

Patch Payment Intents ID Request Unauthorized Error

404

Patch Payment Intents ID Request Not Found Error

422

Patch Payment Intents ID Request Unprocessable Entity Error

429

Patch Payment Intents ID Request Too Many Requests Error

Authentication

Path parameters

Headers

Request

Response

Errors