Trade

Recover a delivery by order_ref (signed)

For the marketplace's customer who lost the receipt: the account asks, signed over the empty body like a statement read, with ?order_ref= naming the order, and gets the ledger row and the signed certificate back. A bounded, newest-first search of the account's rows.

get/api/trade/{partner}/claim

Request

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

Path parameters

partnerstring required

The account id.

Query parameters

order_refstring required

The order_ref the delivery was ordered with.

Headers

X-Trade-Timestampstring required

Unix seconds at signing.

X-Trade-Noncestring required

32 hex characters, fresh per request.

X-Trade-Signaturestring required

sha256=<hex of HMAC-SHA256(secret, timestamp.nonce.)> — the body is empty.

X-Trade-Keystring

The provider key, where the account's dialect sends one.

Response

OK

what_this_isstring required
rowobject required
certificateobject nullable
signaturestring
signature_jcsstring
public_keystring
verify_urlstring uri
notestring

Changes

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