aboutsummaryrefslogtreecommitdiff
path: root/gnu-taler-error-codes/registry.rec
blob: 7a4bda1981dd2cd14d76cd4cfff0f6c9ea58c16c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
# -*- mode: rec -*-
#
# Registry for HTTP status codes
#
%rec: TalerErrorCode
%key: Value
%typedef: ValueRange_t range 0 9999
%constraint: ( Value < 100 ) || ( Value > 999 )
%type: Value ValueRange_t
%mandatory: Value
%typedef: Description_t regexp |^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-][abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_\(\)\.,;!"':#\/ -]*$|
%type: Description Description_t
%mandatory: Description
%typedef: Name_t regexp /^[ABCDEFGHIJKLMNOPQRSTUVWXYZ_][ABCDEFGHIJKLMNOPQRSTUVWXYZ_0123456789]*$/
%type: Name Name_t
%unique: Name
%mandatory: Name
# A status of 0 means not an HTTP status (i.e. created client-side)
%typedef: HttpStatus_t range 0 599
%type: HttpStatus rec HttpStatusCode
%mandatory: HttpStatus
%sort: Value

# 0 - 99: Reserved for GENERIC error codes

Value: 0
Name: NONE
Description: Special code to indicate success (no error).
HttpStatus: 0

# We could not get the error code.

Value: 1
Name: INVALID
Description: A non-integer error code was returned in the JSON response.
HttpStatus: 0


# Fundamental problems detected client-side (10-19)

Value: 10
Name: GENERIC_INVALID_RESPONSE
Description: The response we got from the server was not even in JSON format.
HttpStatus: 0

Value: 11
Name: GENERIC_TIMEOUT
Description: An operation timed out.
HttpStatus: 0

Value: 12
Name: GENERIC_VERSION_MALFORMED
Description: The version string given does not follow the expected CURRENT:REVISION:AGE Format.
HttpStatus: 0

Value: 13
Name: GENERIC_REPLY_MALFORMED
Description: The service responded with a reply that was in JSON but did not satsify the protocol. Note that invalid cryptographic signatures should have signature-specific error codes.
HttpStatus: 0

# Fundamental client-side protocol problems (20-29)
# (fundamental: cannot be helped, client is very broken)

Value: 20
Name: GENERIC_METHOD_INVALID
Description: The HTTP method used is invalid for this endpoint.
HttpStatus: 405

Value: 21
Name: GENERIC_ENDPOINT_UNKNOWN
Description: There is no endpoint defined for the URL provided by the client.
HttpStatus: 404

Value: 22
Name: GENERIC_JSON_INVALID
Description: The JSON in the client's request was malformed (generic parse error).
HttpStatus: 400

Value: 24
Name: GENERIC_PAYTO_URI_MALFORMED
Description: The payto:// URI provided by the client is malformed.
HttpStatus: 400

Value: 25
Name: GENERIC_PARAMETER_MISSING
Description: A required parameter in the request was missing.
HttpStatus: 400

Value: 26
Name: GENERIC_PARAMETER_MALFORMED
Description: A parameter in the request was malformed.
HttpStatus: 400


# Circumstantial client-side protocol problems (30-39)
# (Circumstantial == may work with another server, but not this one)

Value: 30
Name: GENERIC_CURRENCY_MISMATCH
Description: The currencies involved in the operation do not match.
HttpStatus: 400

Value: 31
Name: GENERIC_URI_TOO_LONG
Description: The URI is longer than the longest URI the HTTP server is willing to parse.
HttpStatus: 414

Value: 32
Name: GENERIC_UPLOAD_EXCEEDS_LIMIT
Description: The body is too large to be permissible for the endpoint.
HttpStatus: 413


# 40-49: available for future use



# Server-side database problems (50-59)

Value: 50
Name: GENERIC_DB_SETUP_FAILED
Description: The service failed initialize its connection to the database.
HttpStatus: 500

Value: 51
Name: GENERIC_DB_START_FAILED
Description: The service encountered an error event to just start the database transaction.
HttpStatus: 500

Value: 52
Name: GENERIC_DB_STORE_FAILED
Description: The service failed to store information in its database.
HttpStatus: 500

Value: 53
Name: GENERIC_DB_FETCH_FAILED
Description: The service failed to fetch information from its database.
HttpStatus: 500

Value: 54
Name: GENERIC_DB_COMMIT_FAILED
Description: The service encountered an error event to commit the database transaction (hard, unrecoverable error).
HttpStatus: 500

Value: 55
Name: GENERIC_DB_SOFT_FAILURE
Description: The service encountered an error event to commit the database transaction, even after repeatedly retrying it there was always a conflicting transaction. (This indicates a repeated serialization error; should only happen if some client maliciously tries to create conflicting concurrent transactions.)
HttpStatus: 500

Value: 56
Name: GENERIC_DB_INVARIANT_FAILURE
Description: The service's database is inconsistent and violates service-internal invariants.
HttpStatus: 500


# Server-side computational problems (60-69)

Value: 60
Name: GENERIC_INTERNAL_INVARIANT_FAILURE
Description: The HTTP server experienced an internal invariant failure (bug).
HttpStatus: 500

Value: 61
Name: GENERIC_FAILED_COMPUTE_JSON_HASH
Description: The service could not compute a cryptographic hash over some JSON value.
HttpStatus: 500


# Server-side resource problems (70-79)

Value: 70
Name: GENERIC_PARSER_OUT_OF_MEMORY
Description: The HTTP server had insufficient memory to parse the request.
HttpStatus: 500

Value: 71
Name: GENERIC_ALLOCATION_FAILURE
Description: The HTTP server failed to allocate memory.
HttpStatus: 500

Value: 72
Name: GENERIC_JSON_ALLOCATION_FAILURE
Description: The HTTP server failed to allocate memory for building JSON reply.
HttpStatus: 500

# 80-99: available for future use



# 100 - 999: VERBOTEN due to confusion with HTTP status codes (at least 100-599).

# 1000 - 1999: Reserved for exchange
# 1000 - 1099: Reserved for EXCHANGE_GENERIC

Value: 1000
Name: EXCHANGE_GENERIC_BAD_CONFIGURATION
Description: Exchange is badly configured and thus cannot operate.
HttpStatus: 500

Value: 1001
Name: EXCHANGE_GENERIC_OPERATION_UNKNOWN
Description: Operation specified unknown for this endpoint.
HttpStatus: 404

Value: 1002
Name: EXCHANGE_GENERIC_WRONG_NUMBER_OF_SEGMENTS
Description: The number of segments included in the URI does not match the number of segments expected by the endpoint.
HttpStatus: 404

Value: 1003
Name: EXCHANGE_GENERIC_COIN_CONFLICTING_DENOMINATION_KEY
Description: The same coin was already used with a different denomination previously.
HttpStatus: 409

Value: 1004
Name: EXCHANGE_GENERIC_COINS_INVALID_COIN_PUB
Description: The public key of given to a "/coins/" endpoint of the exchange was malformed.
HttpStatus: 400

Value: 1005
Name: EXCHANGE_GENERIC_DENOMINATION_KEY_UNKNOWN
Description: The exchange is not aware of the denomination key the wallet requested for the operation.
HttpStatus: 404

Value: 1006
Name: EXCHANGE_DENOMINATION_SIGNATURE_INVALID
Description: The signature of the denomination key over the coin is not valid.
HttpStatus: 403

Value: 1007
Name: EXCHANGE_GENERIC_KEYS_MISSING
Description: The exchange failed to perform the operation as it could not find the private keys. This is a problem with the exchange setup, not with the client's request.
HttpStatus: 500

Value: 1008
Name: EXCHANGE_GENERIC_DENOMINATION_VALIDITY_IN_FUTURE
Description: Validity period of the denomination lies in the future.
HttpStatus: 412

Value: 1009
Name: EXCHANGE_GENERIC_DENOMINATION_EXPIRED
Description: Denomination key of the coin is past its expiration time for the requested operation.
HttpStatus: 410

Value: 1010
Name: EXCHANGE_GENERIC_DENOMINATION_REVOKED
Description: Denomination key of the coin has been revoked.
HttpStatus: 410

Value: 1100
Name: EXCHANGE_DEPOSITS_GET_NOT_FOUND
Description: The exchange did not find information about the specified transaction in the database.
HttpStatus: 404

Value: 1101
Name: EXCHANGE_DEPOSITS_GET_INVALID_H_WIRE
Description: The wire hash of given to a "/deposits/" handler was malformed.
HttpStatus: 400

Value: 1102
Name: EXCHANGE_DEPOSITS_GET_INVALID_MERCHANT_PUB
Description: The merchant key of given to a "/deposits/" handler was malformed.
HttpStatus: 400

Value: 1103
Name: EXCHANGE_DEPOSITS_GET_INVALID_H_CONTRACT_TERMS
Description: The hash of the contract terms given to a "/deposits/" handler was malformed.
HttpStatus: 400

Value: 1104
Name: EXCHANGE_DEPOSITS_GET_INVALID_COIN_PUB
Description: The coin public key of given to a "/deposits/" handler was malformed.
HttpStatus: 400

Value: 1105
Name: EXCHANGE_DEPOSITS_GET_INVALID_SIGNATURE_BY_EXCHANGE
Description: The signature returned by the exchange in a /deposits/ request was malformed.
HttpStatus: 0

Value: 1106
Name: EXCHANGE_DEPOSITS_GET_MERCHANT_SIGNATURE_INVALID
Description: The signature of the merchant is invalid.
HttpStatus: 403

Value: 1150
Name: EXCHANGE_WITHDRAW_INSUFFICIENT_FUNDS
Description: The given reserve does not have sufficient funds to admit the requested withdraw operation at this time.  The response includes the current "balance" of the reserve as well as the transaction "history" that lead to this balance.
HttpStatus: 409

Value: 1151
Name: EXCHANGE_WITHDRAW_RESERVE_UNKNOWN
Description: The exchange has no information about the "reserve_pub" that was given.
HttpStatus: 404

Value: 1152
Name: EXCHANGE_WITHDRAW_AMOUNT_FEE_OVERFLOW
Description: The amount to withdraw together with the fee exceeds the numeric range for Taler amounts.  This is not a client failure, as the coin value and fees come from the exchange's configuration.
HttpStatus: 500

Value: 1153
Name: EXCHANGE_WITHDRAW_SIGNATURE_FAILED
Description: The exchange failed to create the signature using the denomination key.
HttpStatus: 500

Value: 1154
Name: EXCHANGE_WITHDRAW_RESERVE_SIGNATURE_INVALID
Description: The signature of the reserve is not valid.
HttpStatus: 403

Value: 1155
Name: EXCHANGE_WITHDRAW_HISTORY_ERROR_INSUFFICIENT_FUNDS
Description: When computing the reserve history, we ended up with a negative overall balance, which should be impossible.
HttpStatus: 500

Value: 1158
Name: EXCHANGE_WITHDRAW_DENOMINATION_KEY_LOST
Description: Withdraw period of the coin to be withdrawn is in the past.
HttpStatus: 410

Value: 1159
Name: EXCHANGE_WITHDRAW_UNBLIND_FAILURE
Description: The client failed to unblind the blind signature.
HttpStatus: 0

Value: 1200
Name: EXCHANGE_DEPOSIT_INSUFFICIENT_FUNDS
Description: The respective coin did not have sufficient residual value for the /deposit operation (i.e. due to double spending). The "history" in the response provides the transaction history of the coin proving this fact.
HttpStatus: 409

Value: 1205
Name: EXCHANGE_DEPOSIT_COIN_SIGNATURE_INVALID
Description: The signature made by the coin over the deposit permission is not valid.
HttpStatus: 403

Value: 1207
Name: EXCHANGE_DEPOSIT_NEGATIVE_VALUE_AFTER_FEE
Description: The stated value of the coin after the deposit fee is subtracted would be negative.
HttpStatus: 400

Value: 1208
Name: EXCHANGE_DEPOSIT_REFUND_DEADLINE_AFTER_WIRE_DEADLINE
Description: The stated refund deadline is after the wire deadline.
HttpStatus: 400

Value: 1210
Name: EXCHANGE_DEPOSIT_INVALID_WIRE_FORMAT_JSON
Description: The exchange failed to canonicalize and hash the given wire format. For example, the merchant failed to provide the "salt" or a valid payto:// URI in the wire details.  Note that while the exchange will do some basic sanity checking on the wire details, it cannot warrant that the banking system will ultimately be able to route to the specified address, even if this check passed.
HttpStatus: 400

Value: 1211
Name: EXCHANGE_DEPOSIT_INVALID_WIRE_FORMAT_CONTRACT_HASH_CONFLICT
Description: The hash of the given wire address does not match the wire hash specified in the proposal data.
HttpStatus: 400

Value: 1221
Name: EXCHANGE_DEPOSIT_INVALID_SIGNATURE_BY_EXCHANGE
Description: The signature provided by the exchange is not valid.
HttpStatus: 0

Value: 1250
Name: EXCHANGE_RESERVES_GET_STATUS_UNKNOWN
Description: The reserve status was requested using a unknown key.
HttpStatus: 404

Value: 1300
Name: EXCHANGE_MELT_INSUFFICIENT_FUNDS
Description: The respective coin did not have sufficient residual value for the /refresh/melt operation.  The "history" in this response provdes the "residual_value" of the coin, which may be less than its "original_value".
HttpStatus: 409

Value: 1301
Name: EXCHANGE_MELT_COIN_HISTORY_COMPUTATION_FAILED
Description: The exchange had an internal error reconstructing the transaction history of the coin that was being melted.
HttpStatus: 500

Value: 1302
Name: EXCHANGE_MELT_FEES_EXCEED_CONTRIBUTION
Description: The exchange encountered melt fees exceeding the melted coin's contribution.
HttpStatus: 400

Value: 1303
Name: EXCHANGE_MELT_COIN_SIGNATURE_INVALID
Description: The signature made with the coin to be melted is invalid.
HttpStatus: 403

Value: 1304
Name: EXCHANGE_MELT_HISTORY_DB_ERROR_INSUFFICIENT_FUNDS
Description: The exchange failed to obtain the transaction history of the given coin from the database while generating an insufficient funds errors.
HttpStatus: 500

Value: 1305
Name: EXCHANGE_MELT_COIN_EXPIRED_NO_ZOMBIE
Description: The denomination of the given coin has past its expiration date and it is also not a valid zombie (that is, was not refreshed with the fresh coin being subjected to recoup).
HttpStatus: 400

Value: 1306
Name: EXCHANGE_MELT_INVALID_SIGNATURE_BY_EXCHANGE
Description: The signature returned by the exchange in a melt request was malformed.
HttpStatus: 0


Value: 1353
Name: EXCHANGE_REFRESHES_REVEAL_COMMITMENT_VIOLATION
Description: The provided transfer keys do not match up with the original commitment.  Information about the original commitment is included in the response.
HttpStatus: 409

Value: 1354
Name: EXCHANGE_REFRESHES_REVEAL_SIGNING_ERROR
Description: Failed to produce the blinded signatures over the coins to be returned.
HttpStatus: 500

Value: 1355
Name: EXCHANGE_REFRESHES_REVEAL_SESSION_UNKNOWN
Description: The exchange is unaware of the refresh session specified in the request.
HttpStatus: 404

Value: 1356
Name: EXCHANGE_REFRESHES_REVEAL_CNC_TRANSFER_ARRAY_SIZE_INVALID
Description: The size of the cut-and-choose dimension of the private transfer keys request does not match #TALER_CNC_KAPPA - 1.
HttpStatus: 400

Value: 1357
Name: EXCHANGE_REFRESHES_REVEAL_NEW_DENOMS_ARRAY_SIZE_EXCESSIVE
Description: The number of coins to be created in refresh exceeds the limits of the exchange. private transfer keys request does not match #TALER_CNC_KAPPA - 1.
HttpStatus: 400

Value: 1358
Name: EXCHANGE_REFRESHES_REVEAL_NEW_DENOMS_ARRAY_SIZE_MISMATCH
Description: The number of envelopes given does not match the number of denomination keys given.
HttpStatus: 400

Value: 1359
Name: EXCHANGE_REFRESHES_REVEAL_COST_CALCULATION_OVERFLOW
Description: The exchange encountered a numeric overflow totaling up the cost for the refresh operation.
HttpStatus: 500

Value: 1360
Name: EXCHANGE_REFRESHES_REVEAL_AMOUNT_INSUFFICIENT
Description: The exchange's cost calculation shows that the melt amount is below the costs of the transaction.
HttpStatus: 400

Value: 1361
Name: EXCHANGE_REFRESHES_REVEAL_LINK_SIGNATURE_INVALID
Description: The signature made with the coin over the link data is invalid.
HttpStatus: 403

Value: 1362
Name: EXCHANGE_REFRESHES_REVEAL_INVALID_RCH
Description: The refresh session hash given to a /refreshes/ handler was malformed.
HttpStatus: 400

Value: 1363
Name: EXCHANGE_REFRESHES_REVEAL_OPERATION_INVALID
Description: Operation specified invalid for this endpoint.
HttpStatus: 400

Value: 1400
Name: EXCHANGE_LINK_COIN_UNKNOWN
Description: The coin specified in the link request is unknown to the exchange.
HttpStatus: 404

Value: 1450
Name: EXCHANGE_TRANSFERS_GET_WTID_MALFORMED
Description: The public key of given to a /transfers/ handler was malformed.
HttpStatus: 400

Value: 1451
Name: EXCHANGE_TRANSFERS_GET_WTID_NOT_FOUND
Description: The exchange did not find information about the specified wire transfer identifier in the database.
HttpStatus: 404

Value: 1452
Name: EXCHANGE_TRANSFERS_GET_WIRE_FEE_NOT_FOUND
Description: The exchange did not find information about the wire transfer fees it charged.
HttpStatus: 500

Value: 1453
Name: EXCHANGE_TRANSFERS_GET_WIRE_FEE_INCONSISTENT
Description: The exchange found a wire fee that was above the total transfer value (and thus could not have been charged).
HttpStatus: 500


Value: 1500
Name: EXCHANGE_REFUND_COIN_NOT_FOUND
Description: The exchange knows literally nothing about the coin we were asked to refund. But without a transaction history, we cannot issue a refund. This is kind-of OK, the owner should just refresh it directly without executing the refund.
HttpStatus: 404

Value: 1501
Name: EXCHANGE_REFUND_CONFLICT_DEPOSIT_INSUFFICIENT
Description: We could not process the refund request as the coin's transaction history does not permit the requested refund because then refunds would exceed the deposit amount.  The "history" in the response proves this.
HttpStatus: 409

Value: 1502
Name: EXCHANGE_REFUND_DEPOSIT_NOT_FOUND
Description: The exchange knows about the coin we were asked to refund, but not about the specific /deposit operation.  Hence, we cannot issue a refund (as we do not know if this merchant public key is authorized to do a refund).
HttpStatus: 404

Value: 1503
Name: EXCHANGE_REFUND_MERCHANT_ALREADY_PAID
Description: The exchange can no longer refund the customer/coin as the money was already transferred (paid out) to the merchant. (It should be past the refund deadline.)
HttpStatus: 410

Value: 1504
Name: EXCHANGE_REFUND_FEE_TOO_LOW
Description: The refund fee specified for the request is lower than the refund fee charged by the exchange for the given denomination key of the refunded coin.
HttpStatus: 400

Value: 1505
Name: EXCHANGE_REFUND_FEE_ABOVE_AMOUNT
Description: The refunded amount is smaller than the refund fee, which would result in a negative refund.
HttpStatus: 400

Value: 1506
Name: EXCHANGE_REFUND_MERCHANT_SIGNATURE_INVALID
Description: The signature of the merchant is invalid.
HttpStatus: 403

Value: 1507
Name: EXCHANGE_REFUND_MERCHANT_SIGNING_FAILED
Description: Merchant backend failed to create the refund confirmation signature.
HttpStatus: 500

Value: 1508
Name: EXCHANGE_REFUND_INVALID_SIGNATURE_BY_EXCHANGE
Description: The signature returned by the exchange in a refund request was malformed.
HttpStatus: 0

Value: 1509
Name: EXCHANGE_REFUND_INVALID_FAILURE_PROOF_BY_EXCHANGE
Description: The failure proof returned by the exchange is incorrect.
HttpStatus: 0

Value: 1510
Name: EXCHANGE_REFUND_INCONSISTENT_AMOUNT
Description: Conflicting refund granted before with different amount but same refund transaction ID.
HttpStatus: 424

Value: 1550
Name: EXCHANGE_RECOUP_SIGNATURE_INVALID
Description: The given coin signature is invalid for the request.
HttpStatus: 403

Value: 1551
Name: EXCHANGE_RECOUP_WITHDRAW_NOT_FOUND
Description: The exchange could not find the corresponding withdraw operation. The request is denied.
HttpStatus: 404

Value: 1552
Name: EXCHANGE_RECOUP_COIN_BALANCE_ZERO
Description: The coin's remaining balance is zero.  The request is denied.
HttpStatus: 403

Value: 1553
Name: EXCHANGE_RECOUP_BLINDING_FAILED
Description: The exchange failed to reproduce the coin's blinding.
HttpStatus: 500

Value: 1554
Name: EXCHANGE_RECOUP_COIN_BALANCE_NEGATIVE
Description: The coin's remaining balance is zero.  The request is denied.
HttpStatus: 500

Value: 1555
Name: EXCHANGE_RECOUP_NOT_ELIGIBLE
Description: The coin's denomination has not been revoked yet.
HttpStatus: 404


Value: 1600
Name: EXCHANGE_KEYS_TIMETRAVEL_FORBIDDEN
Description: This exchange does not allow clients to request /keys for times other than the current (exchange) time.
HttpStatus: 403

Value: 1650
Name: EXCHANGE_WIRE_SIGNATURE_INVALID
Description: A signature in the server's response was malformed.
HttpStatus: 0


Value: 1700
Name: EXCHANGE_DENOMINATION_HELPER_UNAVAILABLE
Description: The exchange failed to talk to the process responsible for its private denomination keys.
HttpStatus: 500

Value: 1701
Name: EXCHANGE_DENOMINATION_HELPER_BUG
Description: The response from the denomination key helper process was malformed.
HttpStatus: 500

Value: 1702
Name: EXCHANGE_DENOMINATION_HELPER_TOO_EARLY
Description: The helper refuses to sign with the key, because it is too early: the validity period has not yet started.
HttpStatus: 400

Value: 1750
Name: EXCHANGE_SIGNKEY_HELPER_UNAVAILABLE
Description: The exchange failed to talk to the process responsible for its private signing keys.
HttpStatus: 500

Value: 1751
Name: EXCHANGE_SIGNKEY_HELPER_BUG
Description: The response from the online signing key helper process was malformed.
HttpStatus: 500

Value: 1752
Name: EXCHANGE_SIGNKEY_HELPER_TOO_EARLY
Description: The helper refuses to sign with the key, because it is too early: the validity period has not yet started.
HttpStatus: 400


Value: 1800
Name: EXCHANGE_MANAGEMENT_AUDITOR_NOT_FOUND
Description: The auditor that was supposed to be disabled is unknown to this exchange.
HttpStatus: 404

Value: 1801
Name: EXCHANGE_MANAGEMENT_AUDITOR_MORE_RECENT_PRESENT
Description: The exchange has a more recently signed conflicting instruction and is thus refusing the current change (replay detected).
HttpStatus: 409

Value: 1802
Name: EXCHANGE_MANAGEMENT_AUDITOR_ADD_SIGNATURE_INVALID
Description: The signature to add or enable the auditor does not validate.
HttpStatus: 403

Value: 1803
Name: EXCHANGE_MANAGEMENT_AUDITOR_DEL_SIGNATURE_INVALID
Description: The signature to disable the auditor does not validate.
HttpStatus: 403

Value: 1804
Name: EXCHANGE_MANAGEMENT_DENOMINATION_REVOKE_SIGNATURE_INVALID
Description: The signature to revoke the denomination does not validate.
HttpStatus: 403

Value: 1805
Name: EXCHANGE_MANAGEMENT_SIGNKEY_REVOKE_SIGNATURE_INVALID
Description: The signature to revoke the online signing key does not validate.
HttpStatus: 403

Value: 1806
Name: EXCHANGE_MANAGEMENT_WIRE_MORE_RECENT_PRESENT
Description: The exchange has a more recently signed conflicting instruction and is thus refusing the current change (replay detected).
HttpStatus: 409

Value: 1807
Name: EXCHANGE_MANAGEMENT_KEYS_SIGNKEY_UNKNOWN
Description: The signingkey specified is unknown to the exchange.
HttpStatus: 404

Value: 1808
Name: EXCHANGE_MANAGEMENT_WIRE_DETAILS_SIGNATURE_INVALID
Description: The signature to publish wire account does not validate.
HttpStatus: 403

Value: 1809
Name: EXCHANGE_MANAGEMENT_WIRE_ADD_SIGNATURE_INVALID
Description: The signature to add the wire account does not validate.
HttpStatus: 403

Value: 1810
Name: EXCHANGE_MANAGEMENT_WIRE_DEL_SIGNATURE_INVALID
Description: The signature to disable the wire account does not validate.
HttpStatus: 403

Value: 1811
Name: EXCHANGE_MANAGEMENT_WIRE_NOT_FOUND
Description: The wire account to be disabled is unknown to the exchange.
HttpStatus: 404

Value: 1812
Name: EXCHANGE_MANAGEMENT_WIRE_FEE_SIGNATURE_INVALID
Description: The signature to affirm wire fees does not validate.
HttpStatus: 403

Value: 1813
Name: EXCHANGE_MANAGEMENT_WIRE_FEE_MISMATCH
Description: The signature conflicts with a previous signature affirming different fees.
HttpStatus: 409

Value: 1814
Name: EXCHANGE_MANAGEMENT_KEYS_DENOMKEY_ADD_SIGNATURE_INVALID
Description: The signature affirming the denomination key is invalid.
HttpStatus: 403

Value: 1815
Name: EXCHANGE_MANAGEMENT_KEYS_SIGNKEY_ADD_SIGNATURE_INVALID
Description: The signature affirming the signing key is invalid.
HttpStatus: 403


Value: 1900
Name: EXCHANGE_AUDITORS_AUDITOR_SIGNATURE_INVALID
Description: The auditor signature over the denomination meta data is invalid.
HttpStatus: 403

Value: 1901
Name: EXCHANGE_AUDITORS_AUDITOR_UNKNOWN
Description: The auditor that was specified is unknown to this exchange.
HttpStatus: 412

Value: 1902
Name: EXCHANGE_AUDITORS_AUDITOR_INACTIVE
Description: The auditor that was specified is no longer used by this exchange.
HttpStatus: 410




# 2000 - 2999: Reserved for merchant
# 2000 - 2099: Reserved for MERCHANT_GENERIC

Value: 2000
Name: MERCHANT_GENERIC_INSTANCE_UNKNOWN
Description: The backend could not find the merchant instance specified in the request.
HttpStatus: 404

Value: 2001
Name: MERCHANT_GENERIC_HOLE_IN_WIRE_FEE_STRUCTURE
Description: The start and end-times in the wire fee structure leave a hole. This is not allowed.
HttpStatus: 0

Value: 2002
Name: MERCHANT_GENERIC_RESERVE_PUB_MALFORMED
Description: The reserve key of given to a /reserves/ handler was malformed.
HttpStatus: 400

Value: 2003
Name: MERCHANT_GENERIC_FAILED_TO_LOAD_TEMPLATE
Description: The backend could not locate a required template to generate an HTML reply.
HttpStatus: 406

Value: 2004
Name: MERCHANT_GENERIC_FAILED_TO_EXPAND_TEMPLATE
Description: The backend could not expand the template to generate an HTML reply.
HttpStatus: 500

Value: 2005
Name: MERCHANT_GENERIC_ORDER_UNKNOWN
Description: The proposal is not known to the backend.
HttpStatus: 404

Value: 2006
Name: MERCHANT_GENERIC_PRODUCT_UNKNOWN
Description: The order provided to the backend could not be completed, because a product to be completed via inventory data is not actually in our inventory.
HttpStatus: 404

Value: 2007
Name: MERCHANT_GENERIC_TIP_ID_UNKNOWN
Description: The tip ID is unknown.  This could happen if the tip has expired.
HttpStatus: 404

Value: 2008
Name: MERCHANT_GENERIC_DB_CONTRACT_CONTENT_INVALID
Description: The contract obtained from the merchant backend was malformed.
HttpStatus: 500

Value: 2009
Name: MERCHANT_GENERIC_CONTRACT_HASH_DOES_NOT_MATCH_ORDER
Description: The order we found does not match the provided contract hash.
HttpStatus: 403

Value: 2010
Name: MERCHANT_GENERIC_EXCHANGE_KEYS_FAILURE
Description: The exchange failed to provide a valid response to the merchant's /keys request.
HttpStatus: 502

Value: 2011
Name: MERCHANT_GENERIC_EXCHANGE_TIMEOUT
Description: The exchange failed to respond to the merchant on time.
HttpStatus: 504

Value: 2012
Name: MERCHANT_GENERIC_EXCHANGE_CONNECT_FAILURE
Description: The merchant failed to talk to the exchange.
HttpStatus: 500

Value: 2013
Name: MERCHANT_GENERIC_EXCHANGE_REPLY_MALFORMED
Description: The exchange returned a maformed response.
HttpStatus: 502

Value: 2014
Name: MERCHANT_GENERIC_EXCHANGE_UNEXPECTED_STATUS
Description: The exchange returned an unexpected response status.
HttpStatus: 502

Value: 2015
Name: MERCHANT_GENERIC_UNAUTHORIZED
Description: The merchant refused the request due to lack of authorization.
HttpStatus: 401



# 2100-2499: public API
# 2100-2149: get orders endpoint

Value: 2100
Name: MERCHANT_GET_ORDERS_EXCHANGE_TRACKING_FAILURE
Description: The exchange failed to provide a valid answer to the tracking request, thus those details are not in the response.
HttpStatus: 200


Value: 2103
Name: MERCHANT_GET_ORDERS_ID_EXCHANGE_REQUEST_FAILURE
Description: The merchant backend failed to construct the request for tracking to the exchange, thus tracking details are not in the response.
HttpStatus: 500

Value: 2104
Name: MERCHANT_GET_ORDERS_ID_EXCHANGE_LOOKUP_START_FAILURE
Description: The merchant backend failed trying to contact the exchange for tracking details, thus those details are not in the response.
HttpStatus: 500

Value: 2105
Name: MERCHANT_GET_ORDERS_ID_INVALID_TOKEN
Description: The token used to authenticate the client is invalid for this order.
HttpStatus: 403

# 2150-2199: post orders ID pay endpoint

Value: 2150
Name: MERCHANT_POST_ORDERS_ID_PAY_INSUFFICIENT_FUNDS
Description: The exchange responded saying that funds were insufficient (for example, due to double-spending).
HttpStatus: 409

Value: 2151
Name: MERCHANT_POST_ORDERS_ID_PAY_DENOMINATION_KEY_NOT_FOUND
Description: The denomination key used for payment is not listed among the denomination keys of the exchange.
HttpStatus: 400

Value: 2152
Name: MERCHANT_POST_ORDERS_ID_PAY_DENOMINATION_KEY_AUDITOR_FAILURE
Description: The denomination key used for payment is not audited by an auditor approved by the merchant.
HttpStatus: 400

Value: 2153
Name: MERCHANT_POST_ORDERS_ID_PAY_AMOUNT_OVERFLOW
Description: There was an integer overflow totaling up the amounts or deposit fees in the payment.
HttpStatus: 500

Value: 2154
Name: MERCHANT_POST_ORDERS_ID_PAY_FEES_EXCEED_PAYMENT
Description: The deposit fees exceed the total value of the payment.
HttpStatus: 400

Value: 2155
Name: MERCHANT_POST_ORDERS_ID_PAY_INSUFFICIENT_DUE_TO_FEES
Description: After considering deposit and wire fees, the payment is insufficient to satisfy the required amount for the contract.  The client should revisit the logic used to calculate fees it must cover.
HttpStatus: 406

Value: 2156
Name: MERCHANT_POST_ORDERS_ID_PAY_PAYMENT_INSUFFICIENT
Description: Even if we do not consider deposit and wire fees, the payment is insufficient to satisfy the required amount for the contract.
HttpStatus: 406

Value: 2157
Name: MERCHANT_POST_ORDERS_ID_PAY_COIN_SIGNATURE_INVALID
Description: The signature over the contract of one of the coins was invalid.
HttpStatus: 403

Value: 2158
Name: MERCHANT_POST_ORDERS_ID_PAY_EXCHANGE_LOOKUP_FAILED
Description: When we tried to find information about the exchange to issue the deposit, we failed.  This usually only happens if the merchant backend is somehow unable to get its own HTTP client logic to work.
HttpStatus: 500

Value: 2159
Name: MERCHANT_POST_ORDERS_ID_PAY_REFUND_DEADLINE_PAST_WIRE_TRANSFER_DEADLINE
Description: The refund deadline in the contract is after the transfer deadline.
HttpStatus: 500


Value: 2161
Name: MERCHANT_POST_ORDERS_ID_PAY_OFFER_EXPIRED
Description: The payment is too late, the offer has expired.
HttpStatus: 410

Value: 2162
Name: MERCHANT_POST_ORDERS_ID_PAY_MERCHANT_FIELD_MISSING
Description: The "merchant" field is missing in the proposal data. This is an internal error as the proposal is from the merchant's own database at this point.
HttpStatus: 500

Value: 2163
Name: MERCHANT_POST_ORDERS_ID_PAY_WIRE_HASH_UNKNOWN
Description: Failed to locate merchant's account information matching the wire hash given in the proposal.
HttpStatus: 500

Value: 2165
Name: MERCHANT_POST_ORDERS_ID_PAY_DENOMINATION_DEPOSIT_EXPIRED
Description: The deposit time for the denomination has expired.
HttpStatus: 410

Value: 2166
Name: MERCHANT_POST_ORDERS_ID_PAY_EXCHANGE_WIRE_FEE_ADDITION_FAILED
Description: The exchange of the deposited coin charges a wire fee that could not be added to the total (total amount too high).
HttpStatus: 500

Value: 2167
Name: MERCHANT_POST_ORDERS_ID_PAY_REFUNDED
Description: The contract was not fully paid because of refunds. Note that clients MAY treat this as paid if, for example, contracts must be executed despite of refunds.
HttpStatus: 402

Value: 2168
Name: MERCHANT_POST_ORDERS_ID_PAY_REFUNDS_EXCEED_PAYMENTS
Description: According to our database, we have refunded more than we were paid (which should not be possible).
HttpStatus: 500

Value: 2169
Name: DEAD_QQQ_PAY_MERCHANT_POST_ORDERS_ID_ABORT_REFUND_REFUSED_PAYMENT_COMPLETE
Description: Legacy stuff. Remove me with protocol v1.
HttpStatus: 0

Value: 2170
Name: MERCHANT_POST_ORDERS_ID_PAY_EXCHANGE_FAILED
Description: The payment failed at the exchange.
HttpStatus: 502

# 2200-2249: post orders ID paid endpoint

Value: 2200
Name: MERCHANT_POST_ORDERS_ID_PAID_CONTRACT_HASH_MISMATCH
Description: The contract hash does not match the given order ID.
HttpStatus: 409

Value: 2201
Name: MERCHANT_POST_ORDERS_ID_PAID_COIN_SIGNATURE_INVALID
Description: The signature of the merchant is not valid for the given contract hash.
HttpStatus: 403

# 2250-2299: post orders ID abort endpoint


Value: 2251
Name: MERCHANT_POST_ORDERS_ID_ABORT_EXCHANGE_REFUND_FAILED
Description: The merchant failed to send the exchange the refund request.
HttpStatus: 500

Value: 2252
Name: MERCHANT_POST_ORDERS_ID_ABORT_EXCHANGE_LOOKUP_FAILED
Description: The merchant failed to find the exchange to process the lookup.
HttpStatus: 500

Value: 2253
Name: MERCHANT_POST_ORDERS_ID_ABORT_CONTRACT_NOT_FOUND
Description: The merchant could not find the contract.
HttpStatus: 404

Value: 2254
Name: MERCHANT_POST_ORDERS_ID_ABORT_REFUND_REFUSED_PAYMENT_COMPLETE
Description: The payment was already completed and thus cannot be aborted anymore.
HttpStatus: 412

Value: 2255
Name: MERCHANT_POST_ORDERS_ID_ABORT_CONTRACT_HASH_MISSMATCH
Description: The hash provided by the wallet does not match the order.
HttpStatus: 403

Value: 2256
Name: MERCHANT_POST_ORDERS_ID_ABORT_COINS_ARRAY_EMPTY
Description: The array of coins cannot be empty.
HttpStatus: 400

# 2300-2349: post orders ID claim endpoint

Value: 2300
Name: MERCHANT_POST_ORDERS_ID_CLAIM_NOT_FOUND
Description: We could not claim the order because the backend is unaware of it.
HttpStatus: 404

Value: 2301
Name: MERCHANT_POST_ORDERS_ID_CLAIM_ALREADY_CLAIMED
Description: We could not claim the order because someone else claimed it first.
HttpStatus: 409

Value: 2302
Name: MERCHANT_POST_ORDERS_ID_CLAIM_CLIENT_INTERNAL_FAILURE
Description: The client-side experienced an internal failure.
HttpStatus: 0

# 2350-2399: post orders ID refund endpoint

Value: 2350
Name: MERCHANT_POST_ORDERS_ID_REFUND_SIGNATURE_FAILED
Description: The backend failed to sign the refund request.
HttpStatus: 0

# 2400-2449: tip pickup endpoint

Value: 2400
Name: MERCHANT_TIP_PICKUP_UNBLIND_FAILURE
Description: The client failed to unblind the signature returned by the merchant.
HttpStatus: 0



Value: 2403
Name: MERCHANT_TIP_PICKUP_EXCHANGE_ERROR
Description: The exchange returned a failure code for the withdraw operation.
HttpStatus: 502


Value: 2404
Name: MERCHANT_TIP_PICKUP_SUMMATION_FAILED
Description: The merchant failed to add up the amounts to compute the pick up value.
HttpStatus: 500

Value: 2405
Name: MERCHANT_TIP_PICKUP_HAS_EXPIRED
Description: The tip expired.
HttpStatus: 410

Value: 2406
Name: MERCHANT_TIP_PICKUP_AMOUNT_EXCEEDS_TIP_REMAINING
Description: The requested withdraw amount exceeds the amount remaining to be picked up.
HttpStatus: 400

Value: 2407
Name: MERCHANT_TIP_PICKUP_DENOMINATION_UNKNOWN
Description: The merchant did not find the specified denomination key in the exchange's key set.
HttpStatus: 409

# 2450-2499: available for future public endpoint

# 2500-2999: private API
# 2500-2549: order operations

Value: 2500
Name: MERCHANT_PRIVATE_POST_ORDERS_INSTANCE_CONFIGURATION_LACKS_WIRE
Description: The backend lacks a wire transfer method configuration option for the given instance. Thus, this instance is unavailable (not findable for creating new orders).
HttpStatus: 404

Value: 2501
Name: MERCHANT_PRIVATE_POST_ORDERS_NO_LOCALTIME
Description: The proposal had no timestamp and the backend failed to obtain the local time. Likely to be an internal error.
HttpStatus: 500

Value: 2502
Name: MERCHANT_PRIVATE_POST_ORDERS_PROPOSAL_PARSE_ERROR
Description: The order provided to the backend could not be parsed, some required fields were missing or ill-formed.
HttpStatus: 400

Value: 2503
Name: MERCHANT_PRIVATE_POST_ORDERS_ALREADY_EXISTS
Description: The backend encountered an error: the proposal already exists.
HttpStatus: 409

Value: 2510
Name: MERCHANT_PRIVATE_PATCH_ORDERS_ID_FORGET_PATH_SYNTAX_INCORRECT
Description: One of the paths to forget is malformed.
HttpStatus: 400

Value: 2511
Name: MERCHANT_PRIVATE_PATCH_ORDERS_ID_FORGET_PATH_NOT_FORGETTABLE
Description: One of the paths to forget was not marked as forgettable.
HttpStatus: 409

Value: 2520
Name: MERCHANT_PRIVATE_DELETE_ORDERS_AWAITING_PAYMENT
Description: The order provided to the backend could not be deleted, our offer is still valid and awaiting payment.
HttpStatus: 409

Value: 2530
Name: MERCHANT_PRIVATE_POST_ORDERS_ID_REFUND_INCONSISTENT_AMOUNT
Description: The amount to be refunded is inconsistent: either is lower than the previous amount being awarded, or it is too big to be paid back. In this second case, the fault stays on the business dept. side.
HttpStatus: 409

Value: 2531
Name: MERCHANT_PRIVATE_POST_ORDERS_ID_REFUND_ORDER_UNPAID
Description: The frontend gave an unpaid order id to issue the refund to.
HttpStatus: 409

Value: 2532
Name: MERCHANT_PRIVATE_POST_ORDERS_ID_REFUND_NOT_ALLOWED_BY_CONTRACT
Description: The refund delay was set to 0 and thus no refunds are allowed for this order.
HttpStatus: 403



# 2550-2599: transfer operations


Value: 2551
Name: MERCHANT_PRIVATE_POST_TRANSFERS_REQUEST_ERROR
Description: We internally failed to execute the /track/transfer request.
HttpStatus: 500

Value: 2553
Name: MERCHANT_PRIVATE_POST_TRANSFERS_CONFLICTING_REPORTS
Description: The exchange gave conflicting information about a coin which has been wire transferred.
HttpStatus: 409

Value: 2554
Name: MERCHANT_PRIVATE_POST_TRANSFERS_BAD_WIRE_FEE
Description: The exchange charged a different wire fee than what it originally advertised, and it is higher.
HttpStatus: 502

Value: 2555
Name: MERCHANT_PRIVATE_POST_TRANSFERS_ACCOUNT_NOT_FOUND
Description: We did not find the account that the transfer was made to.
HttpStatus: 404

# 2600-2649: instance operations

Value: 2600
Name: MERCHANT_PRIVATE_POST_INSTANCES_ALREADY_EXISTS
Description: The merchant backend cannot create an instance under the given identifier as one already exists. Use PATCH to modify the existing entry.
HttpStatus: 409


# 2650-2699: product operations

Value: 2650
Name: MERCHANT_PRIVATE_POST_PRODUCTS_CONFLICT_PRODUCT_EXISTS
Description: The product ID exists.
HttpStatus: 409

Value: 2660
Name: MERCHANT_PRIVATE_PATCH_PRODUCTS_TOTAL_LOST_REDUCED
Description: The update would have reduced the total amount of product lost, which is not allowed.
HttpStatus: 409

Value: 2661
Name: MERCHANT_PRIVATE_PATCH_PRODUCTS_TOTAL_LOST_EXCEEDS_STOCKS
Description: The update would have mean that more stocks were lost than what remains from total inventory after sales, which is not allowed.
HttpStatus: 409

Value: 2662
Name: MERCHANT_PRIVATE_PATCH_PRODUCTS_TOTAL_STOCKED_REDUCED
Description: The update would have reduced the total amount of product in stock, which is not allowed.
HttpStatus: 409

Value: 2670
Name: MERCHANT_PRIVATE_POST_PRODUCTS_LOCK_INSUFFICIENT_STOCKS
Description: The lock request is for more products than we have left (unlocked) in stock.
HttpStatus: 410

Value: 2680
Name: MERCHANT_PRIVATE_DELETE_PRODUCTS_CONFLICTING_LOCK
Description: The deletion request is for a product that is locked.
HttpStatus: 409

# 2700-2749: reserve operations

Value: 2700
Name: MERCHANT_PRIVATE_POST_RESERVES_UNSUPPORTED_WIRE_METHOD
Description: The requested wire method is not supported by the exchange.
HttpStatus: 409

Value: 2710
Name: MERCHANT_PRIVATE_DELETE_RESERVES_NO_SUCH_RESERVE
Description: The reserve could not be deleted because it is unknown.
HttpStatus: 404

# 2750-2799: tip authorization

Value: 2750
Name: MERCHANT_PRIVATE_POST_TIP_AUTHORIZE_RESERVE_EXPIRED
Description: The reserve that was used to fund the tips has expired.
HttpStatus: 410

Value: 2751
Name: MERCHANT_PRIVATE_POST_TIP_AUTHORIZE_RESERVE_UNKNOWN
Description: The reserve that was used to fund the tips was not found in the DB.
HttpStatus: 503

Value: 2752
Name: MERCHANT_PRIVATE_POST_TIP_AUTHORIZE_INSUFFICIENT_FUNDS
Description: The backend knows the instance that was supposed to support the tip, and it was configured for tipping. However, the funds remaining are insufficient to cover the tip, and the merchant should top up the reserve.
HttpStatus: 0

Value: 2753
Name: MERCHANT_PRIVATE_POST_TIP_AUTHORIZE_RESERVE_NOT_FOUND
Description: The backend failed to find a reserve needed to authorize the tip.
HttpStatus: 503

Value: 2800
Name: MERCHANT_PRIVATE_GET_ORDERS_ID_AMOUNT_ARITHMETIC_FAILURE
Description: The merchant backend encountered a failure in computing the deposit total.
HttpStatus: 200




# 3000 - 3999: Reserved for auditor
# 3000 - 3099: Reserved for AUDITOR_GENERIC

Value: 3100
Name: AUDITOR_DEPOSIT_CONFIRMATION_SIGNATURE_INVALID
Description: The signature from the exchange on the deposit confirmation is invalid.
HttpStatus: 403

Value: 3101
Name: AUDITOR_EXCHANGE_SIGNING_KEY_REVOKED
Description: The exchange key used for the signature on the deposit confirmation was revoked.
HttpStatus: 410


# 5000 - 5999: Reserved for bank
# 5000 - 5099: Reserved for BANK_GENERIC

Value: 5101
Name: BANK_SAME_ACCOUNT
Description: Wire transfer attempted with credit and debit party being the same bank account.
HttpStatus: 0

Value: 5102
Name: BANK_UNALLOWED_DEBIT
Description: Wire transfer impossible, due to financial limitation of the party that attempted the payment.
HttpStatus: 0

Value: 5103
Name: BANK_NEGATIVE_NUMBER_AMOUNT
Description: Negative number was used (as value and/or fraction) to initiate a Amount object.
HttpStatus: 0

Value: 5104
Name: BANK_NUMBER_TOO_BIG
Description: A number too big was used (as value and/or fraction) to initiate a amount object.
HttpStatus: 0

Value: 5105
Name: BANK_LOGIN_FAILED
Description: Could not login for the requested operation.
HttpStatus: 0

Value: 5106
Name: BANK_UNKNOWN_ACCOUNT
Description: The bank account referenced in the requested operation was not found. Returned along "400 Not found".
HttpStatus: 0

Value: 5107
Name: BANK_TRANSACTION_NOT_FOUND
Description: The transaction referenced in the requested operation (typically a reject operation), was not found.
HttpStatus: 0

Value: 5108
Name: BANK_BAD_FORMAT_AMOUNT
Description: Bank received a malformed amount string.
HttpStatus: 0

Value: 5109
Name: BANK_REJECT_NO_RIGHTS
Description: The client does not own the account credited by the transaction which is to be rejected, so it has no rights do reject it.  To be returned along HTTP 403 Forbidden.
HttpStatus: 0

Value: 5110
Name: BANK_UNMANAGED_EXCEPTION
Description: This error code is returned when no known exception types captured the exception, and comes along with a 500 Internal Server Error.
HttpStatus: 0

Value: 5111
Name: BANK_SOFT_EXCEPTION
Description: This error code is used for all those exceptions that do not really need a specific error code to return to the client, but need to signal the middleware that the bank is not responding with 500 Internal Server Error.  Used for example when a client is trying to register with a unavailable username.
HttpStatus: 0

Value: 5112
Name: BANK_TRANSFER_REQUEST_UID_REUSED
Description: The request UID for a request to transfer funds has already been used, but with different details for the transfer.
HttpStatus: 409

Value: 5113
Name: BANK_WITHDRAWAL_OPERATION_RESERVE_SELECTION_CONFLICT
Description: The withdrawal operation already has a reserve selected.  The current request conflicts with the existing selection.
HttpStatus: 409

# 6000 - 6999: Reserved for sync
# 6000 - 6099: Reserved for SYNC_GENERIC

Value: 6100
Name: SYNC_ACCOUNT_UNKNOWN
Description: The sync service failed find the account in its database.
HttpStatus: 404

Value: 6101
Name: SYNC_BAD_IF_NONE_MATCH
Description: The SHA-512 hash provided in the If-None-Match header is malformed.
HttpStatus: 400

Value: 6102
Name: SYNC_BAD_IF_MATCH
Description: The SHA-512 hash provided in the If-Match header is malformed or missing.
HttpStatus: 400

Value: 6103
Name: SYNC_BAD_SYNC_SIGNATURE
Description: The signature provided in the "Sync-Signature" header is malformed or missing.
HttpStatus: 400

Value: 6104
Name: SYNC_INVALID_SIGNATURE
Description: The signature provided in the "Sync-Signature" header does not match the account, old or new Etags.
HttpStatus: 403

Value: 6105
Name: SYNC_MALFORMED_CONTENT_LENGTH
Description: The "Content-length" field for the upload is not a number.
HttpStatus: 400

Value: 6106
Name: SYNC_EXCESSIVE_CONTENT_LENGTH
Description: The "Content-length" field for the upload is too big based on the server's terms of service.
HttpStatus: 413

Value: 6107
Name: SYNC_OUT_OF_MEMORY_ON_CONTENT_LENGTH
Description: The server is out of memory to handle the upload. Trying again later may succeed.
HttpStatus: 413

Value: 6108
Name: SYNC_INVALID_UPLOAD
Description: The uploaded data does not match the Etag.
HttpStatus: 400

Value: 6109
Name: SYNC_PAYMENT_GENERIC_TIMEOUT
Description: HTTP server experienced a timeout while awaiting promised payment.
HttpStatus: 408

Value: 6110
Name: SYNC_PAYMENT_CREATE_BACKEND_ERROR
Description: Sync could not setup the payment request with its own backend.
HttpStatus: 500

Value: 6111
Name: SYNC_PREVIOUS_BACKUP_UNKNOWN
Description: The sync service failed find the backup to be updated in its database.
HttpStatus: 404

Value: 6112
Name: SYNC_MISSING_CONTENT_LENGTH
Description: The "Content-length" field for the upload is missing.
HttpStatus: 400


# 7000 - 7999: Reserved for wallet

Value: 7000
Name: WALLET_EXCHANGE_PROTOCOL_VERSION_INCOMPATIBLE
Description: The wallet does not implement a version of the exchange protocol that is compatible with the protocol version of the exchange.
HttpStatus: 501

Value: 7001
Name: WALLET_UNEXPECTED_EXCEPTION
Description: The wallet encountered an unexpected exception.  This is likely a bug in the wallet implementation.
HttpStatus: 500

Value: 7002
Name: WALLET_RECEIVED_MALFORMED_RESPONSE
Description: The wallet received a response from a server, but the response can't be parsed.
HttpStatus: 0

Value: 7003
Name: WALLET_NETWORK_ERROR
Description: The wallet tried to make a network request, but it received no response.
HttpStatus: 0

Value: 7004
Name: WALLET_HTTP_REQUEST_THROTTLED
Description: The wallet tried to make a network request, but it was throttled.
HttpStatus: 0

Value: 7005
Name: WALLET_UNEXPECTED_REQUEST_ERROR
Description: The wallet made a request to a service, but received an error response it does not know how to handle.
HttpStatus: 0

Value: 7006
Name: WALLET_EXCHANGE_DENOMINATIONS_INSUFFICIENT
Description: The denominations offered by the exchange are insufficient.  Likely the exchange is badly configured or not maintained.
HttpStatus: 0

Value: 7007
Name: WALLET_CORE_API_OPERATION_UNKNOWN
Description: The wallet does not support the operation requested by a client.
HttpStatus: 0

Value: 7008
Name: WALLET_INVALID_TALER_PAY_URI
Description: The given taler://pay URI is invalid.
HttpStatus: 0

Value: 7009
Name: WALLET_EXCHANGE_COIN_SIGNATURE_INVALID
Description: The signature on a coin by the exchange's denomination key is invalid after unblinding it.
HttpStatus: 0

Value: 7010
Name: WALLET_EXCHANGE_WITHDRAW_RESERVE_UNKNOWN_AT_EXCHANGE
Description: The exchange does not know about the reserve (yet), and thus withdrawal can't progress.
HttpStatus: 404

Value: 7011
Name: WALLET_CORE_NOT_AVAILABLE
Description: The wallet core service is not available.
HttpStatus: 0

Value: 7012
Name: WALLET_WITHDRAWAL_OPERATION_ABORTED_BY_BANK
Description: The bank has aborted a withdrawal operation, and thus a withdrawal can't complete.
HttpStatus: 0

Value: 7013
Name: WALLET_HTTP_REQUEST_GENERIC_TIMEOUT
Description: An HTTP request made by the wallet timed out.
HttpStatus: 0

Value: 7014
Name: WALLET_ORDER_ALREADY_CLAIMED
Description: The order has already been claimed by another wallet.
HttpStatus: 0

Value: 7015
Name: WALLET_WITHDRAWAL_GROUP_INCOMPLETE
Description: A group of withdrawal operations (typically for the same reserve at the same exchange) has errors and will be tried again later.
HttpStatus: 0

Value: 7016
Name: WALLET_TIPPING_COIN_SIGNATURE_INVALID
Description: The signature on a coin by the exchange's denomination key (obtained through the merchant via tipping) is invalid after unblinding it.
HttpStatus: 0

Value: 7017
Name: WALLET_BANK_INTEGRATION_PROTOCOL_VERSION_INCOMPATIBLE
Description: The wallet does not implement a version of the bank integration API that is compatible with the version offered by the bank.
HttpStatus: 0

Value: 7018
Name: WALLET_CONTRACT_TERMS_BASE_URL_MISMATCH
Description: The wallet processed a taler://pay URI, but the merchant base URL in the downloaded contract terms does not match the merchant base URL derived from the URI.
HttpStatus: 0

Value: 7019
Name: WALLET_CONTRACT_TERMS_SIGNATURE_INVALID
Description: The merchant's signature on the contract terms is invalid.
HttpStatus: 0

# 8000 - 8999: Reserved for Anastasis

Value: 8000
Name: ANASTASIS_GENERIC_BACKEND_TIMEOUT
Description: We encountered a timeout with our payment backend.
HttpStatus: 504

Value: 8001
Name: ANASTASIS_GENERIC_INVALID_PAYMENT_REQUEST
Description: The backend requested payment, but the request is malformed.
HttpStatus: 0

Value: 8100
Name: ANASTASIS_REDUCER_ACTION_INVALID
Description: The given action is invalid for the current state of the reducer.
HttpStatus: 0

Value: 8101
Name: ANASTASIS_POLICY_BAD_IF_NONE_MATCH
Description: The given if-none-match header is malformed.
HttpStatus: 400

Value: 8102
Name: ANASTASIS_POLICY_MISSING_CONTENT_LENGTH
Description: The "Content-length" field for the upload is missing.
HttpStatus: 400

Value: 8103
Name: ANASTASIS_POLICY_MALFORMED_CONTENT_LENGTH
Description: The "Content-length" field for the upload is malformed.
HttpStatus: 400

Value: 8104
Name: ANASTASIS_POLICY_OUT_OF_MEMORY_ON_CONTENT_LENGTH
Description: The server is out of memory to handle the upload. Trying again later may succeed.
HttpStatus: 413

Value: 8105
Name: ANASTASIS_POLICY_BAD_SIGNATURE
Description: The signature provided in the "Anastasis-Policy-Signature" header is malformed or missing.
HttpStatus: 400

Value: 8106
Name: ANASTASIS_POLICY_BAD_IF_MATCH
Description: The given if-match header is malformed.
HttpStatus: 400

Value: 8107
Name: ANASTASIS_POLICY_INVALID_UPLOAD
Description: The uploaded data does not match the Etag.
HttpStatus: 400

Value: 8108
Name: ANASTASIS_TRUTH_UNKNOWN
Description: The truth public key is unknown to the provider.
HttpStatus: 404

Value: 8109
Name: ANASTASIS_TRUTH_AUTHORIZATION_METHOD_NO_LONGER_SUPPORTED
Description: The authorization method used by the truth is no longer supported by the provider.
HttpStatus: 500

Value: 8110
Name: ANASTASIS_TRUTH_CHALLENGE_RESPONSE_REQUIRED
Description: The client needs to respond to the challenge.
HttpStatus: 403

Value: 8111
Name: ANASTASIS_TRUTH_CHALLENGE_FAILED
Description: The client's response to the challenge was invalid.
HttpStatus: 403

Value: 8112
Name: ANASTASIS_TRUTH_CHALLENGE_UNKNOWN
Description: The service is unaware of having issued a challenge.
HttpStatus: 410

Value: 8113
Name: ANASTASIS_TRUTH_CHALLENGE_ACTIVE
Description: A challenge is already active, the service is thus not issuing a new one.
HttpStatus: 208

Value: 8114
Name: ANASTASIS_TRUTH_AUTHORIZATION_START_FAILED
Description: The backend failed to initiate the authorization process.
HttpStatus: 500

Value: 8115
Name: ANASTASIS_TRUTH_KEY_SHARE_GONE
Description: The authorization succeeded, but the key share is no longer available.
HttpStatus: 404

Value: 8116
Name: ANASTASIS_TRUTH_ORDER_DISAPPEARED
Description: The backend forgot the order we asked the client to pay for
HttpStatus: 502

Value: 8117
Name: ANASTASIS_TRUTH_BACKEND_EXCHANGE_BAD
Description: The backend itself reported a bad exchange interaction.
HttpStatus: 502

Value: 8118
Name: ANASTASIS_TRUTH_UNEXPECTED_PAYMENT_STATUS
Description: The backend reported a payment status we did not expect.
HttpStatus: 500

Value: 8119
Name: ANASTASIS_TRUTH_PAYMENT_CREATE_BACKEND_ERROR
Description: The backend failed to setup the order for payment.
HttpStatus: 502



Value: 8200
Name: ANASTASIS_SMS_PHONE_INVALID
Description: The provided phone number is not an acceptable number.
HttpStatus: 417

Value: 8201
Name: ANASTASIS_SMS_HELPER_EXEC_FAILED
Description: Failed to run the SMS transmission helper process.
HttpStatus: 500

Value: 8202
Name: ANASTASIS_SMS_HELPER_COMMAND_FAILED
Description: Helper terminated with a non-successful result.
HttpStatus: 500




# 9000 - 9998: Unallocated.


Value: 9999
Name: END
Description: End of error code range.
HttpStatus: 0