---
title: "Update an embedded payment request (amount and/or rewards) before payment initiation"
method: PATCH
path: "/api/v1/embedded/payment-requests"
tags: ["Embedded"]
---

# Update an embedded payment request (amount and/or rewards) before payment initiation

`PATCH /api/v1/embedded/payment-requests`

Update an embedded payment request (amount and/or rewards) before payment initiation

## Request body

- EmbeddedPaymentRequestUpdateInput
  - `merchant_id` string, uuid — Merchant ID. Defaults to the logged-in merchant if not provided. Required for admin tokens.
  - `payment_token` string, required — Payment token identifying the request to update
  - `amount` integer — Minor-unit amount (e.g. cents)
  - `rewards` object
    - `extra_rewards` number, required — Reward points for this transaction
    - `total_rewards` number — Total reward points including base and extra rewards
    - `description` string — Optional description of the reward offer

## Response `200`

Success

- EmbeddedPaymentRequestUpdateResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required
    - `payment_token` string, required — Same payment token (unchanged)
    - `amount` integer, required — Updated amount
    - `rewards` object
      - `extra_rewards` number, required — Updated reward points for this transaction
      - `total_rewards` number — Updated total reward points including base and extra rewards
      - `description` string — Updated description of the reward offer
    - `expires_in` integer, required — Remaining TTL in seconds

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/versions/f86d2bdbcb08/schema)