Skip to main content
PATCH
/
payment-requests
/
{paymentRequestId}
Update the authorized amount of a payment request
curl --request PATCH \
  --url https://api.venlyfinance.com/v1/payment-requests/{paymentRequestId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 20,
  "currency": "USD",
  "idempotencyKey": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
'
{
  "success": true,
  "result": {
    "id": "d4e5f6a7-b8c9-4012-8345-6789abcdef01",
    "accountId": "b2a1f0e9-8c7d-4e3a-9f21-0a1b2c3d4e5f",
    "amount": {
      "fiat": 20,
      "crypto": "20.000000"
    },
    "originalAmount": {
      "fiat": 25,
      "crypto": "25.000000"
    },
    "currency": "USD",
    "status": "RESERVED",
    "executions": [
      {
        "id": "c9d0e1f2-a3b4-4567-d89a-bcdef0123456",
        "walletPairId": "f6a7b8c9-d0e1-4234-a567-89abcdef0123",
        "type": "AUTHORIZATION_ADJUSTMENT",
        "chain": "BASE",
        "asset": "USDC",
        "amount": 5,
        "exchangeRate": 1,
        "status": "PENDING",
        "createdAt": "2026-01-15T09:45:00Z",
        "updatedAt": "2026-01-15T09:45:00Z"
      }
    ],
    "createdAt": "2026-01-15T09:30:00Z",
    "updatedAt": "2026-01-15T09:45:00Z"
  }
}
Sets a new absolute authorized amount on a reserved payment request. The execution that runs depends on how the new amount compares to the current one:
New amountExecution
Lower than currentAUTHORIZATION_ADJUSTMENT — releases the difference from escrow back to the account wallet
Higher than currentINCREMENTAL_AUTHORIZATION — pulls the additional funds from the account wallet into escrow
The call returns 200 OK. The request keeps status: RESERVED, amount reflects the new value, and originalAmount keeps the amount set at creation. Send a unique idempotencyKey. Concept guide: Payment requests

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow. Token endpoints:

Path Parameters

​
paymentRequestId
string<uuid>
required

Unique payment request identifier

Body

application/json

Sets a new absolute authorized amount on a payment request. A lower amount releases the difference from escrow back to the account wallet; a higher amount pulls the additional funds from the account wallet into escrow.

​
amount
number
required

New absolute authorized amount, in the authorized fiat currency

Required range: x >= 0
​
currency
string
required

Must match the authorized currency

Minimum string length: 1
​
idempotencyKey
string
required

Unique key to prevent duplicate operations on retry

Maximum string length: 255

Response

Amount adjustment accepted

​
success
boolean

Indicates whether the request was successful

​
result
object