View Issue Details

IDProjectCategoryView StatusLast Update
0010568Talerdocumentationpublic2025-11-09 22:06
Reporterhtgoebel Assigned ToChristian Grothoff  
PrioritynormalSeveritytextReproducibilityalways
Status resolvedResolutionfixed 
Product Version1.0 
Target Version1.2Fixed in Version1.2 
Summary0010568: Contradictory and confusing docs for GET [/instances/$INSTANCE]/orders/$ORDER_ID
DescriptionSeveral issues with the documentation for "Querying payment status" https://docs.taler.net/core/api-merchant.html#querying-payment-status

1. "This endpoint is for the wallet" — but the note in "Creating orders" linke here and thus implies that e.g. web-shops shall use this end-point, too, for querying the status.

    - What is the endpoint web-shops and ERPs shall use to query the status?
    - Maybe the note in "Ctreating orders" needs to point to the "private" endpoint?

2. "StatusUnpaidResponse …
  // Status URL, can be used as a redirect target for the browser
  // to show the order QR code / trigger the wallet.
  fulfillment_url?: string;"

   Well, the wallet is already open, as this is what queries this endpoint, isn't it? And "fulfillment" is not "status"

TagsNo tags attached.

Activities

Christian Grothoff

2025-11-09 22:03

manager   ~0026350

09f3e157..b53697f7 clarifies that both GET /orders/$ID and GET /private/orders/$ID can be used to get the order URL --- and that the public endpoint may also be used by non-wallets, basically any client that cannot authenticate must use it.

Christian Grothoff

2025-11-09 22:06

manager   ~0026351

b53697f7..fa1e3e5c improves the description of the fulfillment_url.

Issue History

Date Modified Username Field Change
2025-11-09 18:01 htgoebel New Issue
2025-11-09 22:03 Christian Grothoff Note Added: 0026350
2025-11-09 22:06 Christian Grothoff Note Added: 0026351
2025-11-09 22:06 Christian Grothoff Assigned To => Christian Grothoff
2025-11-09 22:06 Christian Grothoff Status new => resolved
2025-11-09 22:06 Christian Grothoff Resolution open => fixed
2025-11-09 22:06 Christian Grothoff Fixed in Version => 1.2
2025-11-09 22:06 Christian Grothoff Severity major => text
2025-11-09 22:06 Christian Grothoff Product Version => 1.0
2025-11-09 22:06 Christian Grothoff Target Version => 1.2