@endora-commerce/mod-payments 0.107.0 → 0.109.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/backend/services/receive-payment-handler.d.ts.map +1 -1
- package/dist/backend/services/receive-payment-handler.js +40 -3
- package/dist/backend/services/receive-payment-handler.js.map +1 -1
- package/dist/manifest.d.ts +3 -1
- package/dist/manifest.d.ts.map +1 -1
- package/docs/payments.md +12 -0
- package/package.json +12 -12
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"receive-payment-handler.d.ts","sourceRoot":"","sources":["../../../src/backend/services/receive-payment-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,
|
|
1
|
+
{"version":3,"file":"receive-payment-handler.d.ts","sourceRoot":"","sources":["../../../src/backend/services/receive-payment-handler.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { randomUUID } from 'crypto';
|
|
2
|
-
import { ERROR_CODES, ORDER_STATUS_ON_HOLD } from '@endora-commerce/contracts';
|
|
2
|
+
import { ERROR_CODES, ORDER_STATUS_ON_HOLD, decimalText, hasAtMostTwoDecimals, roundHalfUp, } from '@endora-commerce/contracts';
|
|
3
3
|
import { HttpError } from '@endora-commerce/platform/http';
|
|
4
4
|
import { Payment } from '../entities/payment.entity.js';
|
|
5
5
|
/**
|
|
@@ -258,7 +258,30 @@ export class ReceivePaymentHandler {
|
|
|
258
258
|
const payment = await this.resolvePaymentForRefund(tx, input);
|
|
259
259
|
if (!payment)
|
|
260
260
|
return null;
|
|
261
|
-
|
|
261
|
+
// An amount with more than two decimal places is refused, never rounded
|
|
262
|
+
// (issue #428; nothing is rounded silently). Nothing about the payment's
|
|
263
|
+
// money or status moves and the order is not asked; the payment carries
|
|
264
|
+
// the refusal for an operator to settle by hand, and the call answers
|
|
265
|
+
// normally — a throw would answer the gateway's webhook with an error,
|
|
266
|
+
// which the gateway redelivers, and every delivery would be refused again.
|
|
267
|
+
if (!hasAtMostTwoDecimals(input.refundedAmount)) {
|
|
268
|
+
const reported = decimalText(input.refundedAmount);
|
|
269
|
+
payment.providerDetails = {
|
|
270
|
+
...(payment.providerDetails ?? {}),
|
|
271
|
+
refundAnomaly: {
|
|
272
|
+
reason: 'amount_precision_exceeded',
|
|
273
|
+
reportedRefundedAmount: reported,
|
|
274
|
+
currency: input.currency,
|
|
275
|
+
fullyRefunded: input.fullyRefunded,
|
|
276
|
+
externalRefundId: input.externalRefundId ?? null,
|
|
277
|
+
reportedAt: new Date().toISOString(),
|
|
278
|
+
},
|
|
279
|
+
};
|
|
280
|
+
await tx.flush();
|
|
281
|
+
return { payment, changed: false, holdsTheOrder: false, refused: reported };
|
|
282
|
+
}
|
|
283
|
+
// Exact on its decimal digits (issue #417); `toFixed(2)` rounded the double.
|
|
284
|
+
const newRefunded = roundHalfUp(input.refundedAmount);
|
|
262
285
|
const nextStatus = input.fullyRefunded
|
|
263
286
|
? 'refunded'
|
|
264
287
|
: input.refundedAmount > 0 && payment.status !== 'refunded'
|
|
@@ -289,10 +312,24 @@ export class ReceivePaymentHandler {
|
|
|
289
312
|
: null;
|
|
290
313
|
const holdsTheOrder = refunded !== null;
|
|
291
314
|
await tx.flush();
|
|
292
|
-
return { payment, changed, holdsTheOrder };
|
|
315
|
+
return { payment, changed, holdsTheOrder, refused: null };
|
|
293
316
|
});
|
|
294
317
|
if (!result)
|
|
295
318
|
return null;
|
|
319
|
+
if (result.refused !== null) {
|
|
320
|
+
this.log.warn({
|
|
321
|
+
paymentId: result.payment.id,
|
|
322
|
+
orderId: result.payment.orderId,
|
|
323
|
+
externalReference: result.payment.externalReference ?? null,
|
|
324
|
+
reportedRefundedAmount: result.refused,
|
|
325
|
+
recordedRefundedAmount: result.payment.refundedAmount,
|
|
326
|
+
currency: input.currency,
|
|
327
|
+
fullyRefunded: input.fullyRefunded,
|
|
328
|
+
externalRefundId: input.externalRefundId ?? null,
|
|
329
|
+
}, 'payments: the gateway reported a refund amount with more than two decimal places; it was not ' +
|
|
330
|
+
'recorded, and the payment is marked for manual attention (providerDetails.refundAnomaly)');
|
|
331
|
+
return { paymentId: result.payment.id, changed: false };
|
|
332
|
+
}
|
|
296
333
|
/**
|
|
297
334
|
* The hold goes through the lifecycle too, after the commit, for the same
|
|
298
335
|
* reason `receive()` does (feature 085 Phase D). This was the third of the
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"receive-payment-handler.js","sourceRoot":"","sources":["../../../src/backend/services/receive-payment-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,
|
|
1
|
+
{"version":3,"file":"receive-payment-handler.js","sourceRoot":"","sources":["../../../src/backend/services/receive-payment-handler.ts"],"names":[],"mappings":"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"}
|
package/dist/manifest.d.ts
CHANGED
|
@@ -118,6 +118,7 @@ export declare const manifest: {
|
|
|
118
118
|
weight: number;
|
|
119
119
|
descriptionKey?: string | undefined;
|
|
120
120
|
requiredPermission?: string | undefined;
|
|
121
|
+
keywordsKey?: string | undefined;
|
|
121
122
|
}[] | undefined;
|
|
122
123
|
permissions?: {
|
|
123
124
|
code: string;
|
|
@@ -133,6 +134,7 @@ export declare const manifest: {
|
|
|
133
134
|
key: string;
|
|
134
135
|
label: string;
|
|
135
136
|
sampleValue?: string | undefined;
|
|
137
|
+
sampleValueKey?: string | undefined;
|
|
136
138
|
description?: string | undefined;
|
|
137
139
|
}[];
|
|
138
140
|
description?: string | undefined;
|
|
@@ -153,7 +155,7 @@ export declare const manifest: {
|
|
|
153
155
|
category: string;
|
|
154
156
|
contexts: ("email" | "cms" | "invoice" | "newsletter" | "document")[];
|
|
155
157
|
fields: Record<string, {
|
|
156
|
-
type: "number" | "object" | "array" | "uuid" | "text" | "
|
|
158
|
+
type: "number" | "object" | "array" | "uuid" | "text" | "external" | "textarea" | "select" | "radio" | "richtext";
|
|
157
159
|
label?: string | undefined;
|
|
158
160
|
required?: boolean | undefined;
|
|
159
161
|
options?: {
|
package/dist/manifest.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB;;;;CAI7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;CAmBnC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ
|
|
1
|
+
{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB;;;;CAI7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;CAmBnC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsInB,CAAC"}
|
package/docs/payments.md
CHANGED
|
@@ -56,6 +56,18 @@ Beyond the routes, orders consume the drivers via
|
|
|
56
56
|
The buyer's own retry (`POST /api/v1/orders/:orderId/payments/retry`) is a
|
|
57
57
|
customer route and authorises through `requireCustomer`, not a permission.
|
|
58
58
|
|
|
59
|
+
## Gateway refunds
|
|
60
|
+
|
|
61
|
+
A gateway reports each refund — made from its dashboard or by a return
|
|
62
|
+
settlement — through its webhook, with the cumulative refunded amount, and the
|
|
63
|
+
payment records it. An amount with more than two decimal places is **refused,
|
|
64
|
+
not rounded**: the payment's refunded amount and status stay as they were, the
|
|
65
|
+
refusal is logged with the payment, the order, the reported amount and the
|
|
66
|
+
gateway's refund reference, and the payment is marked for manual attention
|
|
67
|
+
(`providerDetails.refundAnomaly` in the payment history). The webhook is still
|
|
68
|
+
acknowledged, so the gateway does not deliver it again; an operator checks the
|
|
69
|
+
refund with the gateway and settles it by hand.
|
|
70
|
+
|
|
59
71
|
## Events emitted
|
|
60
72
|
|
|
61
73
|
`payment.received.v1`, `payment.failed.v1`, `payment.refunded.v1`. These are
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@endora-commerce/mod-payments",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.109.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"sideEffects": false,
|
|
6
6
|
"description": "The platform payment capability: the built-in payment adapters (bank transfer, in-person pickup, credit limit, gateway), the payment record every order carries, and the settlement lifecycle that PSP integrations plug into. Switched off, checkout offers no payment method and the shop takes no orders.",
|
|
@@ -53,11 +53,11 @@
|
|
|
53
53
|
"fastify": "^5.11.0",
|
|
54
54
|
"lucide-react": "^1",
|
|
55
55
|
"react": "^19",
|
|
56
|
-
"@endora-commerce/admin-kit": "0.
|
|
57
|
-
"@endora-commerce/
|
|
58
|
-
"@endora-commerce/email-components": "0.
|
|
59
|
-
"@endora-commerce/
|
|
60
|
-
"@endora-commerce/
|
|
56
|
+
"@endora-commerce/admin-kit": "0.109.0",
|
|
57
|
+
"@endora-commerce/contracts": "0.109.0",
|
|
58
|
+
"@endora-commerce/email-components": "0.109.0",
|
|
59
|
+
"@endora-commerce/mod-orders": "0.109.0",
|
|
60
|
+
"@endora-commerce/platform": "0.109.0"
|
|
61
61
|
},
|
|
62
62
|
"peerDependenciesMeta": {
|
|
63
63
|
"@endora-commerce/admin-kit": {
|
|
@@ -81,14 +81,14 @@
|
|
|
81
81
|
"react": "^19.2.5",
|
|
82
82
|
"typescript": "^5.9.3",
|
|
83
83
|
"vitest": "^4.1.11",
|
|
84
|
-
"@endora-commerce/admin-kit": "0.
|
|
85
|
-
"@endora-commerce/
|
|
86
|
-
"@endora-commerce/
|
|
87
|
-
"@endora-commerce/mod-orders": "0.
|
|
88
|
-
"@endora-commerce/
|
|
84
|
+
"@endora-commerce/admin-kit": "0.109.0",
|
|
85
|
+
"@endora-commerce/contracts": "0.109.0",
|
|
86
|
+
"@endora-commerce/platform": "0.109.0",
|
|
87
|
+
"@endora-commerce/mod-orders": "0.109.0",
|
|
88
|
+
"@endora-commerce/email-components": "0.109.0"
|
|
89
89
|
},
|
|
90
90
|
"scripts": {
|
|
91
|
-
"build": "tsc -p tsconfig.build.json && tsc -p tsconfig.ui.json",
|
|
91
|
+
"build": "node ../../../scripts/clean-package-dist.mjs --src src --out dist && tsc -p tsconfig.build.json && tsc -p tsconfig.ui.build.json",
|
|
92
92
|
"typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.ui.json --noEmit",
|
|
93
93
|
"lint": "eslint src",
|
|
94
94
|
"test": "vitest run"
|