View Issue Details

IDProjectCategoryView StatusLast Update
0010568Talerdocumentationpublic2025-11-22 22:06
Reporterhtgoebel Assigned ToChristian Grothoff Resolution deadline
ImplementerReviewer 
Release signed byDeployed by 
VerifierCommunicator 
Data protection authority notification requiredNo  
CSIRT notification requiredNo  
Estimated effort (hours)Actual effort (hours)0 
Fast-trackNo
Work packagenone
PrioritynormalSeveritytextReproducibilityalways
Status closedResolutionfixed 
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.

Required notifications

Address or linkRemarkAdded byNotifiedActions

Activities

Christian Grothoff

2025-11-09 21: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 21:06

manager   ~0026351

b53697f7..fa1e3e5c improves the description of the fulfillment_url.

Issue History

Date ModifiedUsernameFieldChange
2025-11-09 17:01htgoebelNew Issue
2025-11-09 21:03Christian GrothoffNote Added: 0026350
2025-11-09 21:06Christian GrothoffNote Added: 0026351
2025-11-09 21:06Christian GrothoffAssigned To => Christian Grothoff
2025-11-09 21:06Christian GrothoffStatusnew => informing
2025-11-09 21:06Christian GrothoffResolutionopen => fixed
2025-11-09 21:06Christian GrothoffFixed in Version => 1.2
2025-11-09 21:06Christian GrothoffSeveritymajor => text
2025-11-09 21:06Christian GrothoffProduct Version => 1.0
2025-11-09 21:06Christian GrothoffTarget Version => 1.2
2025-11-22 22:06Christian GrothoffStatusinforming => closed