View Issue Details

IDProjectCategoryView StatusLast Update
0010545Talerspecificationpublic2026-04-06 17:45
Reportersebasjm 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
PriorityhighSeveritytextReproducibilityalways
Status informingResolutionfixed 
Product Version1.0 
Target Version1.6Fixed in Version1.6 
Summary0010545: add error code in merchant spec
DescriptionIn order to handle failure gracefully.

Right now we are only showing the hint that comes from the server which is not good for end users. Maybe good for admins.

We need the same that we did on libeufin: all the possible error codes must be on the spec. Any code returned by the server that is not part of the spec will fall back to the present behavior which shows a generic error and the hint from the server.

With this enumeration the client must cover this path with a meaningful error with i18n or event create special ui to handle the failure better.

For example:

$ curl 'http://merchant.taler.test/private/orders' -H 'Authorization: Bearer secret-token:CEQDN7P9217ZWEDG46PKFKXGXMVY3P6VFFJX6ZCYNFG2SXETF3N0' --data-raw '{"order":{"amount":"KUDOS:2","summary":"w","products":[],"pay_deadline":{"t_s":1762289268},"wire_transfer_deadline":{"t_s":1762454868},"refund_deadline":{"t_s":1762454868}},"inventory_products":[],"create_token":true}'
{
  "code": 2500,
  "hint": "The merchant instance has no active bank accounts configured. However, at least one bank account must be available to create new orders."
}

https://docs.taler.net/core/api-merchant.html#post-[-instances-$INSTANCE]-private-orders

TagsNo tags attached.

Required notifications

Address or linkRemarkAdded byNotifiedActions

Relationships

related to 0011104 closedChristian Grothoff backend return 500 when script failed, spec mandate 502 
related to 0010546 closedChristian Grothoff merchant backend should report the status of each exchange for each bank account [3d] 

Activities

Christian Grothoff

2026-04-06 17:45

manager   ~0028377

Most error codes should now be in the spec. There might be a few missing, but the big work is IMO done.

Issue History

Date ModifiedUsernameFieldChange
2025-11-04 18:56sebasjmNew Issue
2025-11-04 19:20Christian GrothoffAssigned To => Christian Grothoff
2025-11-04 19:20Christian GrothoffStatusnew => assigned
2025-11-04 19:21Christian GrothoffTarget Version => 1.5
2025-11-04 21:01Christian GrothoffRelationship addedrelated to 0010546
2025-11-11 11:25Christian GrothoffSummaryadd error code in merchant spec => add error code in merchant spec [30d]
2025-11-15 17:51Christian GrothoffTarget Version1.5 => 1.7
2025-11-15 17:51Christian GrothoffStatusassigned => implementing
2025-11-18 20:31StefanRelationship addedrelated to 0010630
2025-12-03 09:32StefanRelationship deletedrelated to 0010630
2025-12-21 19:03Christian GrothoffAssigned ToChristian Grothoff =>
2025-12-21 19:03Christian GrothoffSeveritymajor => text
2025-12-21 19:03Christian GrothoffProduct Version => 1.0
2026-02-18 17:24sebasjmRelationship addedrelated to 0011104
2026-04-02 16:00Christian GrothoffAssigned To => Christian Grothoff
2026-04-02 16:00Christian GrothoffStatusimplementing => assigned
2026-04-02 16:01Christian GrothoffSummaryadd error code in merchant spec [30d] => add error code in merchant spec [15d]
2026-04-02 22:51Christian GrothoffSummaryadd error code in merchant spec [15d] => add error code in merchant spec [10d]
2026-04-06 17:45Christian GrothoffStatusassigned => informing
2026-04-06 17:45Christian GrothoffResolutionopen => fixed
2026-04-06 17:45Christian GrothoffFixed in Version => 1.6
2026-04-06 17:45Christian GrothoffNote Added: 0028377
2026-04-06 17:45Christian GrothoffTarget Version1.7 => 1.6
2026-04-06 17:45Christian GrothoffSummaryadd error code in merchant spec [10d] => add error code in merchant spec