Update Quote
PATCH/v1/crossborder/quotes/:id
Update an existing crossborder quote. Only the description field can be updated.
Request
Path Parameters
Quote ID.
Header Parameters
- If there's no value: The default protection checks that the values in this request are equal: { method, params, path, query, body, userId }. This means that if a request repeats the same values, it will be blocked.
- 'nonce': The nonce and { method, params, path, query, body, userId } value are checked. When the protection schema is this, requests will be OK if this nonce value is different in each request.
- 'x-transaction-uuid': The transactionId and { method, params, path, query, body, userId } value are checked. Requests will be OK if this x-transaction-uuid value is different in each request.
- 'x-transaction-uuid&nonce' or 'nonce&x-transaction-uuid': The nonce, transactionId value and { method, params, path, query, body, userId } are checked, i.e. if requests are repeated the same value in both fields, they will be blocked. But if any field has a different value, the request is OK.
The replay-protection-schema allows the user to choose between 3 options:
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
- application/json
Body
required
Description.
Responses
- 200
- 400
- 401
- 422
Quote updated successfully.
- application/json
- Schema
- Example (from schema)
Schema
Quote ID.
Rate ID.
Client ID.
Client name.
Counterparty ID.
Counterparty name.
Possible values: [PENDING, APPROVED, REJECTED, PAID, CANCELED]
Quote status.
Base currency symbol.
Quote currency symbol.
Base amount in cents.
Quote amount in cents.
Possible values: [buy, sell]
Quote side (buy or sell).
Foreign exchange rate.
Spread in basis points (bps).
Tax amount in cents.
VET (tax/fee) in cents.
Description.
Possible values: [D1, D2, D3]
Settlement type.
Settlement date.
Paid date.
Quote created date.
Quote updated date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"rate_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"client_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"client_name": "John Doe",
"counterparty_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"counterparty_name": "Jane Smith",
"status": "PENDING",
"base_currency": "USD",
"quote_currency": "BRL",
"base_amount": 10000,
"quote_amount": 50000,
"side": "buy",
"fx_rate": 50000,
"spread": 100,
"tax": 50,
"vet": 100,
"description": "Payment for services",
"settlement_type": "D1",
"settlement_at": "2026-02-13T19:26:56.557Z",
"paid_at": "2026-02-13T19:26:56.557Z",
"created_at": "2026-02-13T19:26:56.557Z",
"updated_at": "2026-02-13T19:26:56.557Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.