INinfini
Payment

Quote a payment without creating it

Changed on
post/payment/quote

Request

Headers

X-API-Key-IDstring required

32-character Base58 credential ID returned after public-key registration.

X-API-Timestampstring required

Unix timestamp in seconds; tolerance is ±300 seconds.

X-API-Noncestring required

16 cryptographically random bytes encoded as unpadded Base64URL; fresh on every attempt.

Digeststring required

SHA-256= followed by standard padded Base64 of SHA-256 of exact request body bytes. Required even for an empty body; included in the signing string.

Authorizationstring required

Use Ed25519 signature="BASE64_SIGNATURE", where BASE64_SIGNATURE is the standard padded Base64 signature. See /docs/en/4-authorization for the exact signing string.

Request body

order_idstring string required

Order ID

payment_methodinteger

Payment method

chainstring string required

Chain

token_idstring string required

Token identifier

Example request

{
  "order_id": "ord-123",
  "payment_method": 1,
  "chain": "ETHEREUM",
  "token_id": "USDT"
}

Response

amountstring string

USD-denominated amount the payer still owes (== due_amount)

due_amount_fiatstring string

Current payable amount in order currency

amount_confirmedstring string

USD-denominated amount already confirmed

amount_confirmingstring string

USD-denominated amount currently confirming

quoted_token_amountstring string

Amount shown to payer, in pay_currency units

quoted_token_currencystring string

Currency of quoted_token_amount (matches pay_currency)

quoted_token_price_usdcstring string

USDC-per-token snapshot at quote time; 0 for stablecoins

Example response

{
  "amount": "100.00",
  "due_amount_fiat": "100.00",
  "amount_confirmed": "0",
  "amount_confirming": "0",
  "quoted_token_amount": "100.00",
  "quoted_token_currency": "USDT",
  "quoted_token_price_usdc": "0"
}

Changes

  • 8ea57333da41Revision changes
    • breaking

      added the new required header request parameter X-API-Key-ID

    • breaking

      added the new required header request parameter X-API-Nonce

    • breaking

      added the new required header request parameter X-API-Timestamp

    • breaking

      the header request parameter Authorization became required

    • breaking

      the header request parameter Digest became required

    • warning

      deleted the header request parameter Date

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • ef0638d19a3aRevision changes
    • info

      endpoint added