ZEzerohash
Payins

Refresh a payin quote

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.

post/pay/{id}/rfq

Request

  • Base URL
    https://api.cert.zerohash.com
  • URL
    https://api.cert.zerohash.com/pay/{id}/rfq
  • Auth
    API key in header X-SCX-API-KEY and API key in header X-SCX-PASSPHRASE

Path parameters

idstring uuid required

The transaction ID (UUID) returned from the original POST /pay/rfq call

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required
Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Request body

participant_codestring required

The participant code for the shopper whose quote is being refreshed

Example request

{
  "participant_code": "ABCDEF"
}

Response

Pay quote refreshed successfully

Example response

{
  "message": {
    "request_id": "14f8ebb8-7530-4aa4-bef9-9d73d56313f3",
    "participant_code": "ABCDEF",
    "pay_asset": "BTC",
    "quoted_currency": "USD",
    "quoted_total": "100.00",
    "underlying_quantity": "0.00152307",
    "rate": "65658.42",
    "price_expire_ts": 1712757000000,
    "deposit_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
    "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
    "client_reference_id": "order-12345",
    "merchant_participant_code": "MERCH01"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.