Stored receipt download

Example: use a supplied receipt link

Use sample runtimes. RECEIPT_USER_HASH and RECEIPT_FILE_HASH are placeholders for the supplied link's values; no real receipt or hash was used. WALLKIT_API_BASE remains scheme/host only. The three requests encode the same two query parameters.

cURL

curl "${WALLKIT_API_BASE}/api/v1/transaction/receipt/download" \
  --get \
  --data-urlencode "user=${RECEIPT_USER_HASH}" \
  --data-urlencode "file=${RECEIPT_FILE_HASH}" \
  --dump-header download-headers.txt \
  --output download-body.bin

Inspect download-headers.txt and HTTP status before treating download-body.bin as a PDF; the request can return JSON errors. These are illustrative local output filenames, not files created during authoring.

JavaScript

// Node.js 18+; built-in fetch. Separate binary from JSON errors.
async function main() {
  const url = new URL("/api/v1/transaction/receipt/download", process.env.WALLKIT_API_BASE);
  url.searchParams.set("user", process.env.RECEIPT_USER_HASH);
  url.searchParams.set("file", process.env.RECEIPT_FILE_HASH);
  const response = await fetch(url, { method: "GET", headers: {} });
  const mediaType = response.headers.get("content-type") || "";
  if (mediaType.includes("application/json")) {
    console.log(response.status, await response.json());
  } else if (!response.ok) {
    console.log(response.status, await response.text());
  } else {
    const bytes = await response.arrayBuffer();
    console.log(response.status, mediaType, bytes.byteLength);
  }
}
main().catch(console.error);

Python

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/transaction/receipt/download") + "?" + urlencode({"user": os.environ["RECEIPT_USER_HASH"], "file": os.environ["RECEIPT_FILE_HASH"]})
request = Request(url, headers={}, method="GET")
try:
    with urlopen(request) as response:
        media_type = response.headers.get("Content-Type", "")
        if "application/json" in media_type:
            print(response.status, json.load(response))
        else:
            print(response.status, media_type, len(response.read()))
except HTTPError as error:
    media_type = error.headers.get("Content-Type", "")
    if "application/json" in media_type:
        print(error.code, json.load(error))
    else:
        print(error.code, error.read().decode("utf-8", errors="replace"))

Successful response description: stored PDF receipt bytes with forwarded storage Content-Type (the documented uploader supplies pdf), with attachment filename from original_name. JSON primary response is N/A because this operation streams the file. Treat the counter change as activity, not proof of financial completion or a new access grant.