---
title: "Refresh a payin quote"
method: POST
path: "/pay/{id}/rfq"
tags: ["Payins"]
---

# Refresh a payin quote

`POST /pay/{id}/rfq`

Refreshes an existing pay quote identified by its transaction ID.
This is used when a previously issued quote is near to expire and the platform wants a new rate for the same deposit address.
Already expired quotes can't be refreshed.

The response format is identical to `POST /pay/rfq` — it returns an updated rate, expiry timestamp, and the same deposit address.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- PostPayRfqByIdBody
  - `participant_code` string, required — The participant code for the shopper whose quote is being refreshed

## Response `200`

Pay quote refreshed successfully

- PostPayRfqResponse
  - `message` object
    - `request_id` string — The unique identifier for the request
    - `participant_code` string — The participant code tied to the payment
    - `pay_asset` string — The cryptocurrency asset to be deposited
    - `quoted_currency` string — The fiat currency for the payment
    - `quoted_total` string — The total fiat amount
    - `underlying_quantity` string — The crypto quantity required for the deposit
    - `rate` string — The conversion rate at which the deposit will be honored
    - `price_expire_ts` number, nullable — Unix timestamp (milliseconds) when the quoted price expires. Null for stablecoins and for static quotes.
    - `deposit_address` string — The wallet address where the crypto should be deposited
    - `transaction_id` string — Unique transaction identifier (UUID). Use this as the path parameter for POST /pay/{id}/rfq to refresh the quote
    - `client_reference_id` string, nullable — The client-provided reference ID (if provided in the request)
    - `is_static` boolean — Indicates whether this quote is static (no expiry, rate held by zerohash). Static quotes return `price_expire_ts: null`.
    - `merchant_participant_code` string — The merchant participant code associated with this payment. Only present when a merchant is linked to the transaction.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Transaction not found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)
