Trade

The check desk: every signature check reported, nothing delivered

Send exactly the headers and body you would send to the order door. All four checks run and each is reported — headers present, provider key, clock skew, nonce shape, whether the HMAC verified under the secret in service or the previous one — with the sha256 of the signing string we computed so you can compare bytes. No nonce is consumed, nothing is delivered, no money moves. On the sandbox account the expected signature is printed, since that secret is public.

post/api/trade/{partner}/check

Request

  • Base URL: https://scvd.store
  • URL: https://scvd.store/api/trade/{partner}/check
  • Auth: none required

Path parameters

partnerstring required

The account id; use sandbox to test against the published secret.

Headers

X-Trade-Timestampstring required

As you would send it to the order door.

X-Trade-Noncestring

As you would send it.

X-Trade-Signaturestring

As you would send it.

X-Trade-Keystring

As you would send it, where the dialect has one.

Request body

inputsobject

Optional envelope for the item's fields.

order_refstring

Your order id. A retry carrying the same order_ref within a day returns the original delivery and bills nothing twice.

agent_namestring
purposestring
callback_urlstring uri

Optional. A public https URL; after the response, the signed delivery receipt (certificate, signature, verify_url) is POSTed there once, with Web Bot Auth headers on the request. The outcome is written on your statement row.

urlstring uri

For the probe items: a public https door.

summarystring

context_anchor: the state to remember.

digeststring

bitcoin_anchor: a sha256 you computed.

labelstring
addressstring

provenance_check: an EVM address or Solana pubkey.

max_usdnumber

good_buyer: the client's declared per-payment cap.

no_spend_controlsboolean

Response

OK

what_this_isstring required
accountstring required
dialectobject
account_provisionedboolean

False while the account's secret is not set on this side; the checks that need none still run.

notestring
would_passboolean required
first_failurestring nullable required
expected_signaturestring
body_bytesinteger

Changes

No recorded changes to this operation across all 1 revision of this API.