@antelopejs/interface-payment 0.0.2 → 0.2.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/README.md CHANGED
@@ -1,11 +1,16 @@
1
- # @antelopejs/interface-payment
1
+ # `@antelopejs/interface-payment`
2
2
 
3
- [![npm version](https://img.shields.io/npm/v/@antelopejs/interface-payment.svg)](https://www.npmjs.com/package/@antelopejs/interface-payment)
4
- [![license](https://img.shields.io/npm/l/@antelopejs/interface-payment.svg)](./LICENSE)
3
+ <div align="center">
4
+ <a href="https://www.npmjs.com/package/@antelopejs/interface-payment"><img data-illustration alt="npm" src="https://img.shields.io/npm/v/@antelopejs/interface-payment?style=for-the-badge&labelColor=000000&color=000000"></a>
5
+ <a href="./LICENSE"><img data-illustration alt="License" src="https://img.shields.io/npm/l/@antelopejs/interface-payment?style=for-the-badge&labelColor=000000&color=000000"></a>
6
+ <a href="https://discord.gg/g4pFt6eXqu"><img data-illustration alt="Discord" src="https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000"></a>
7
+ <a href="./docs/1.introduction.md"><img data-illustration alt="Docs" src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000"></a>
8
+ </div>
5
9
 
6
- Provider-agnostic payment interface for AntelopeJS. Take payments, refund them,
7
- save payment methods and react to settlement events without naming a provider —
8
- and change provider by swapping the module wired underneath.
10
+ The provider-agnostic payment interface for AntelopeJS. You take payments,
11
+ refund them, save payment methods, and react to settlement events without naming
12
+ a provider. To change provider, you swap the module that implements the
13
+ interface.
9
14
 
10
15
  ## Installation
11
16
 
@@ -14,7 +19,8 @@ pnpm add @antelopejs/interface-payment
14
19
  ```
15
20
 
16
21
  This package declares the contract and ships no provider logic. Wire a module
17
- that implements it — `@antelopejs/stripe` — in your Antelope config.
22
+ that implements it, such as `@antelopejs/stripe`, in your AntelopeJS project
23
+ config.
18
24
 
19
25
  ## What it covers
20
26
 
@@ -26,9 +32,9 @@ that implements it — `@antelopejs/stripe` — in your Antelope config.
26
32
  | Customers and saved methods | `CreateCustomer`, `GetCustomer`, `DeleteCustomer`, `ListPaymentMethods`, `DetachPaymentMethod` |
27
33
  | Webhooks | `VerifyWebhook` |
28
34
 
29
- Subscriptions, marketplace split payments, dispute management, payment links and
30
- in-person terminals are deliberately out of scope — they are where providers
31
- diverge most. For anything beyond this contract, use the provider's own interface
35
+ Subscriptions, marketplace split payments, dispute management, payment links,
36
+ and in-person terminals are out of scope on purpose. Providers differ most in
37
+ those areas. For anything beyond this contract, use the provider's own interface
32
38
  (`@antelopejs/interface-stripe`) alongside this one.
33
39
 
34
40
  ## Quick start
@@ -49,17 +55,19 @@ export async function startCheckout(orderId: string, idempotencyKey: string) {
49
55
  }
50
56
  ```
51
57
 
52
- Generate and persist one idempotency key per checkout attempt, and reuse it on
53
- retries. Call `startCheckout` from your authenticated checkout route, persist the
54
- returned session ID against the order, and redirect the payer to `redirectUrl`.
55
- Use your own return URLs and configure the provider credentials and webhook route.
58
+ Generate one idempotency key per checkout attempt, persist it, and reuse it on
59
+ retries. Call `startCheckout` from your authenticated checkout route. Persist the
60
+ returned session ID against the order, then redirect the payer to
61
+ `redirectUrl`. Use your own return URLs, and configure the provider credentials
62
+ and the webhook route.
56
63
 
57
64
  Fulfil the order from the `payment.succeeded` webhook, not from the payer's
58
- return — the browser is not a trustworthy reporter.
65
+ return. The payer's browser can reach `successUrl` without a payment behind it.
59
66
 
60
67
  Replay protection lasts only for the provider-defined replay window. Persist
61
- operation keys and provider IDs; after expiration, reconcile uncertain payments
62
- with provider records before retrying. A reused key can otherwise charge again.
68
+ operation keys and provider IDs. After the window expires, reconcile uncertain
69
+ payments with the provider's records before you retry. Otherwise a reused key
70
+ can charge the payer again.
63
71
 
64
72
  ## Choose a task
65
73
 
@@ -67,52 +75,55 @@ with provider records before retrying. A reused key can otherwise charge again.
67
75
  - Save a method or charge off-session: [customers and methods](./docs/3.customers-and-methods.md).
68
76
  - Confirm settlement safely: [webhooks](./docs/4.webhooks.md).
69
77
  - Add a provider: [capabilities and conformance](./docs/5.provider-capability-matrix.md).
70
- - Add recurring billing: use Stripe's native subscriptions through
71
- `@antelopejs/interface-subscriptions` when using Stripe. Choose
72
- `@antelopejs/payment-subscriptions` explicitly when you want a generic renewal
73
- clock instead; do not run both clocks for the same subscription.
78
+ - Add recurring billing with Stripe: use Stripe's native subscriptions through
79
+ `@antelopejs/interface-subscriptions`. To run a generic renewal clock instead,
80
+ choose `@antelopejs/payment-subscriptions` explicitly. Do not run both clocks
81
+ for the same subscription.
74
82
 
75
83
  ## Compatibility
76
84
 
77
- <!-- docs-compat: ./package.json#peerDependencies -->
85
+ <!-- antelopejs-docs-compat:start -->
78
86
 
79
- | Package | Range |
80
- | ---------------------------- | ---------------- |
81
- | `@antelopejs/interface-core` | `>=0.0.3 <1.0.0` |
87
+ | Package | Supported | Tested with |
88
+ | ---------------------------- | ---------------- | ----------- |
89
+ | `@antelopejs/interface-core` | `>=0.0.3 <1.0.0` | `0.0.12` |
82
90
 
83
- These are the peer requirements in `package.json`, not development or test-tool
84
- ranges. The implementing module may impose additional requirements.
91
+ <!-- antelopejs-docs-compat:end -->
92
+
93
+ The table lists the peer requirements in `package.json`, not the development or
94
+ test-tool ranges. The implementing module can add requirements of its own.
85
95
 
86
96
  ## Conventions
87
97
 
88
98
  - **Integer minor units.** `{ value: 1050, currency: "EUR" }` is €10.50, never a float.
89
- - **An idempotency key on every mutating call**, positionally after the request.
99
+ - **An idempotency key on every mutating call.** The key is the positional argument after the request.
90
100
  - **Opaque provider identifiers.** Do not parse them.
91
101
  - **A decline is a result, not an exception.** `CreatePayment` resolves with
92
- `status: "failed"`; it rejects only when the call could not be made.
93
- - **An optional trailing `provider`** selects between configured accounts.
102
+ `status: "failed"`. It rejects only when the call itself could not be made.
103
+ - **An optional trailing `provider` argument.** It selects one of several configured accounts.
94
104
 
95
105
  ## Documentation
96
106
 
97
- | Document | Contents |
98
- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
99
- | [Introduction](./docs/1.introduction.md) | Scope, conventions, installation |
100
- | [Payments](./docs/2.payments.md) | Checkout, direct payments, authorize/capture, errors |
101
- | [Customers and methods](./docs/3.customers-and-methods.md) | Saved methods, off-session and recurring charges |
102
- | [Webhooks](./docs/4.webhooks.md) | Verification, the event set, handling |
103
- | [Provider capability matrix](./docs/5.provider-capability-matrix.md) | What each provider family does behind each call, and why the scope is what it is |
107
+ | Document | Contents |
108
+ | -------------------------------------------------------------------- | ------------------------------------------------------------------------- |
109
+ | [Introduction](./docs/1.introduction.md) | Scope, conventions, and installation |
110
+ | [Payments](./docs/2.payments.md) | Checkout, direct payments, authorize and capture, refunds, and errors |
111
+ | [Customers and methods](./docs/3.customers-and-methods.md) | Saved methods, and off-session and recurring charges |
112
+ | [Webhooks](./docs/4.webhooks.md) | Verification, the event set, and handling |
113
+ | [Provider capability matrix](./docs/5.provider-capability-matrix.md) | What each provider family does behind each call, and why the scope is set |
104
114
 
105
115
  ## Conformance suite
106
116
 
107
- `src/tests/payment.test.ts` ships in the package and runs against whichever
108
- provider module is wired in. It is written against the contract, not against any
109
- one provider's behaviour, and it is what a new provider implementation is held
110
- to.
117
+ The package ships a conformance suite, `src/tests/payment.test.ts` and
118
+ `src/tests/payment-charges.test.ts`. The build publishes it as
119
+ `@antelopejs/interface-payment/tests/*`, and it runs against whichever provider
120
+ module is wired in. The suite tests the contract, not one provider's behavior. A
121
+ new provider implementation must pass it.
111
122
 
112
- Session creation, customer lifecycle, idempotency replay, unknown-identifier
113
- errors and webhook rejection need no fixture and cannot pass without a live
114
- provider — with nothing implementing the interface the proxies queue and the
115
- suite times out rather than reporting green.
123
+ Session creation, the customer lifecycle, idempotency replay, unknown-identifier
124
+ errors, and webhook rejection need no fixture. They also cannot pass without a
125
+ live provider. With nothing implementing the interface, the calls queue and the
126
+ suite times out instead of reporting green.
116
127
 
117
128
  The charge tests need a provider test token, because there is no portable way to
118
129
  mint a chargeable payment method:
@@ -123,6 +134,23 @@ mint a chargeable payment method:
123
134
  | `ANTELOPE_PAYMENT_TEST_METHOD_DECLINED` | A token the provider declines. Without it the decline block skips. |
124
135
  | `ANTELOPE_PAYMENT_TEST_CURRENCY` | ISO-4217 code to run against. Defaults to `EUR`. |
125
136
 
137
+ ## Contributing
138
+
139
+ Read [CONTRIBUTING.md](./CONTRIBUTING.md). Use the Node.js version in `.nvmrc`
140
+ and the pnpm version in the `packageManager` field of `package.json`:
141
+
142
+ ```bash
143
+ pnpm install --frozen-lockfile
144
+ pnpm test
145
+ pnpm lint
146
+ pnpm format:check
147
+ pnpm knip
148
+ ```
149
+
150
+ `pnpm test` runs the local contract tests through the AntelopeJS runner, with no
151
+ payment provider and no credentials. The provider conformance suite above is a
152
+ separate integration check.
153
+
126
154
  ## License
127
155
 
128
- Apache-2.0
156
+ [Apache-2.0](./LICENSE)
@@ -15,7 +15,7 @@ describe(`direct payments (${support_1.CHARGEABLE})`, function () {
15
15
  it("charges a saved method off-session", async () => {
16
16
  const value = (0, support_1.amount)(support_1.CHARGE_VALUE);
17
17
  const payment = await (0, support_1.charge)();
18
- (0, support_1.assertPaymentShape)(payment, value);
18
+ (0, support_1.assertPaymentContract)(payment, value);
19
19
  strict_1.default.notEqual(payment.status, "requires_action", "an off-session charge must not ask an absent payer to act");
20
20
  const read = await (0, support_1.settle)(payment.id, "succeeded");
21
21
  strict_1.default.equal(read.id, payment.id);
@@ -99,7 +99,7 @@ describe(`authorize and capture (${support_1.CHARGEABLE})`, function () {
99
99
  offSession: true,
100
100
  authorizeOnly: true,
101
101
  }, (0, support_1.key)());
102
- (0, support_1.assertPaymentShape)(authorized, value);
102
+ (0, support_1.assertPaymentContract)(authorized, value);
103
103
  strict_1.default.equal(authorized.status, "authorized");
104
104
  strict_1.default.equal(authorized.amountCaptured.value, 0, "nothing is captured by an authorization");
105
105
  const partial = (0, support_1.amount)(support_1.PARTIAL_VALUE);
@@ -144,7 +144,7 @@ describe(`declines (${support_1.DECLINABLE})`, function () {
144
144
  paymentMethod: support_1.TEST_METHOD_DECLINED,
145
145
  offSession: true,
146
146
  }, (0, support_1.key)());
147
- (0, support_1.assertPaymentShape)(payment, value);
147
+ (0, support_1.assertPaymentContract)(payment, value);
148
148
  strict_1.default.equal(payment.status, "failed");
149
149
  strict_1.default.ok(payment.failure, "a failed payment must say why");
150
150
  strict_1.default.ok(payment.failure.message.length > 0);
@@ -1 +1 @@
1
- {"version":3,"file":"payment-charges.test.js","sourceRoot":"","sources":["../../src/tests/payment-charges.test.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"payment-charges.test.js","sourceRoot":"","sources":["../../src/tests/payment-charges.test.ts"],"names":[],"mappings":"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"}
@@ -37,7 +37,7 @@ describe("hosted checkout", function () {
37
37
  strict_1.default.equal(read.status, created.status);
38
38
  if (created.payment !== undefined) {
39
39
  strict_1.default.equal(read.payment, created.payment);
40
- (0, support_1.assertPaymentShape)(await (0, index_1.GetPayment)(created.payment), value);
40
+ (0, support_1.assertPaymentContract)(await (0, index_1.GetPayment)(created.payment), value);
41
41
  }
42
42
  });
43
43
  it("returns the first session when an idempotency key is replayed", async () => {
@@ -1 +1 @@
1
- {"version":3,"file":"payment.test.js","sourceRoot":"","sources":["../../src/tests/payment.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,6CAAyC;AAEzC,uCAamB;AACnB,oCAckB;AAElB,QAAQ,CAAC,iBAAiB,EAAE;IAC1B,IAAI,CAAC,OAAO,CAAC,uBAAa,CAAC,CAAC;IAE5B,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAqB,EACzC;YACE,MAAM,EAAE,IAAA,gBAAM,EAAC,sBAAY,CAAC;YAC5B,SAAS,EAAE,IAAA,mBAAS,GAAE;YACtB,UAAU,EAAE,qBAAW;YACvB,SAAS,EAAE,oBAAU;YACrB,WAAW,EAAE,sBAAsB;SACpC,EACD,IAAA,aAAG,GAAE,CACN,CAAC;QAEF,gBAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,8BAA8B,CAAC,CAAC;QACjE,gBAAM,CAAC,YAAY,CACjB,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAClC,qCAAqC,CACtC,CAAC;QACF,gBAAM,CAAC,EAAE,CACP,CAAC,IAAA,+BAAuB,EAAC,OAAO,CAAC,MAAM,CAAC,EACxC,6CAA6C,OAAO,CAAC,MAAM,EAAE,CAC9D,CAAC;QACF,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,gBAAM,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,yBAAyB,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,KAAK,GAAG,IAAA,gBAAM,EAAC,sBAAY,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAqB,EACzC;YACE,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,IAAA,mBAAS,GAAE;YACtB,UAAU,EAAE,qBAAW;YACvB,SAAS,EAAE,oBAAU;SACtB,EACD,IAAA,aAAG,GAAE,CACN,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,IAAA,0BAAkB,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClD,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAA,4BAAkB,EAAC,MAAM,IAAA,kBAAU,EAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,cAAc,GAAG,IAAA,aAAG,GAAE,CAAC;QAC7B,MAAM,OAAO,GAAG;YACd,MAAM,EAAE,IAAA,gBAAM,EAAC,sBAAY,CAAC;YAC5B,SAAS,EAAE,IAAA,mBAAS,GAAE;YACtB,UAAU,EAAE,qBAAW;YACvB,SAAS,EAAE,oBAAU;SACtB,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,IAAA,6BAAqB,EAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAqB,EAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAEpE,gBAAM,CAAC,KAAK,CACV,MAAM,CAAC,EAAE,EACT,KAAK,CAAC,EAAE,EACR,iDAAiD,CAClD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE;IAC9C,IAAI,CAAC,OAAO,CAAC,uBAAa,CAAC,CAAC;IAE5B,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAW,GAAE,CAAC;QACrC,gBAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,+BAA+B,CAAC,CAAC;QAEnE,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAW,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5C,gBAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEnC,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAkB,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACtD,gBAAM,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,EAAE,qCAAqC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,cAAc,GAAG,IAAA,aAAG,GAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,GAAG,IAAA,wBAAU,GAAE,mBAAmB,EAAE,CAAC;QAE9D,MAAM,KAAK,GAAG,IAAA,eAAK,EAAC,MAAM,IAAA,sBAAc,EAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,IAAA,eAAK,EAAC,MAAM,IAAA,sBAAc,EAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAEpE,gBAAM,CAAC,KAAK,CACV,MAAM,CAAC,EAAE,EACT,KAAK,CAAC,EAAE,EACR,kDAAkD,CACnD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,QAAQ,GAAG,IAAA,eAAK,EAAC,MAAM,IAAA,sBAAc,EAAC,EAAE,EAAE,IAAA,aAAG,GAAE,CAAC,CAAC,CAAC;QACxD,MAAM,IAAA,sBAAc,EAAC,QAAQ,CAAC,EAAE,EAAE,IAAA,aAAG,GAAE,CAAC,CAAC;QAEzC,MAAM,gBAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAA,mBAAW,EAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,6BAAqB,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE;IAC9B,IAAI,CAAC,OAAO,CAAC,uBAAa,CAAC,CAAC;IAE5B,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,gBAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAA,kBAAU,EAAC,mBAAS,CAAC,EAAE,4BAAoB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,gBAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAA,iBAAS,EAAC,mBAAS,CAAC,EAAE,4BAAoB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,gBAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CAAC,IAAA,0BAAkB,EAAC,mBAAS,CAAC,EACnC,4BAAoB,CACrB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,gBAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAA,mBAAW,EAAC,mBAAS,CAAC,EAAE,6BAAqB,CAAC,CAAC;QAC1E,MAAM,gBAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CAAC,IAAA,0BAAkB,EAAC,mBAAS,CAAC,EACnC,6BAAqB,CACtB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,UAAU,EAAE;IACnB,IAAI,CAAC,OAAO,CAAC,uBAAa,CAAC,CAAC;IAE5B,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,gBAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CACH,IAAA,qBAAa,EAAC;YACZ,IAAI,EAAE,MAAM,CAAC,IAAI,CACf,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAA,wBAAU,GAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAChE;YACD,OAAO,EAAE;gBACP,sBAAsB,EAAE,2BAAiB;gBACzC,cAAc,EAAE,kBAAkB;gBAClC,yBAAyB,EAAE,2BAAiB;gBAC5C,kBAAkB,EAAE,2BAAiB;aACtC;SACF,CAAC,EACJ,gCAAwB,EACxB,0DAA0D,CAC3D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,gBAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CACH,IAAA,qBAAa,EAAC;YACZ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,EACJ,gCAAwB,CACzB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"payment.test.js","sourceRoot":"","sources":["../../src/tests/payment.test.ts"],"names":[],"mappings":"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"}
@@ -40,7 +40,16 @@ export declare function reference(): string;
40
40
  */
41
41
  export declare function assertEpochMillis(value: number, label: string): void;
42
42
  export declare function assertAmount(actual: Amount, expected: Amount, label: string): void;
43
- export declare function assertPaymentShape(payment: Payment, expected: Amount): void;
43
+ /**
44
+ * Asserts a payment obeys the invariants the contract promises: a non-empty id,
45
+ * a status inside {@link PAYMENT_STATUSES}, the expected amount, one currency
46
+ * across the amounts, integer minor units, epoch-millisecond `createdAt`, and
47
+ * `redirectUrl` and `failure` present exactly when the status calls for them.
48
+ *
49
+ * @param payment - The payment a provider returned
50
+ * @param expected - The amount the payment was created for
51
+ */
52
+ export declare function assertPaymentContract(payment: Payment, expected: Amount): void;
44
53
  /**
45
54
  * Polls until the payment leaves the states it can leave on its own.
46
55
  *
@@ -9,7 +9,7 @@ exports.key = key;
9
9
  exports.reference = reference;
10
10
  exports.assertEpochMillis = assertEpochMillis;
11
11
  exports.assertAmount = assertAmount;
12
- exports.assertPaymentShape = assertPaymentShape;
12
+ exports.assertPaymentContract = assertPaymentContract;
13
13
  exports.settle = settle;
14
14
  exports.track = track;
15
15
  exports.newCustomer = newCustomer;
@@ -78,7 +78,16 @@ function assertAmount(actual, expected, label) {
78
78
  strict_1.default.equal(actual.value, expected.value, `${label} value`);
79
79
  strict_1.default.equal(actual.currency, expected.currency, `${label} currency`);
80
80
  }
81
- function assertPaymentShape(payment, expected) {
81
+ /**
82
+ * Asserts a payment obeys the invariants the contract promises: a non-empty id,
83
+ * a status inside {@link PAYMENT_STATUSES}, the expected amount, one currency
84
+ * across the amounts, integer minor units, epoch-millisecond `createdAt`, and
85
+ * `redirectUrl` and `failure` present exactly when the status calls for them.
86
+ *
87
+ * @param payment - The payment a provider returned
88
+ * @param expected - The amount the payment was created for
89
+ */
90
+ function assertPaymentContract(payment, expected) {
82
91
  strict_1.default.ok(payment.id.length > 0, "payment id must be non-empty");
83
92
  strict_1.default.ok(index_1.PAYMENT_STATUSES.includes(payment.status), `status ${payment.status} is outside the contract`);
84
93
  assertAmount(payment.amount, expected, "payment amount");
@@ -1 +1 @@
1
- {"version":3,"file":"support.js","sourceRoot":"","sources":["../../src/tests/support.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"support.js","sourceRoot":"","sources":["../../src/tests/support.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -150,6 +150,18 @@ export interface PaymentRequest {
150
150
  /** Round-tripped opaque key/value pairs. */
151
151
  metadata?: Record<string, string>;
152
152
  }
153
+ /**
154
+ * Every value {@link PaymentLocale} can take: the hosted page languages
155
+ * Stripe Checkout accepts. `auto` lets the provider pick from the payer's
156
+ * browser.
157
+ */
158
+ export declare const PAYMENT_LOCALES: readonly ["auto", "bg", "cs", "da", "de", "el", "en", "en-GB", "es", "es-419", "et", "fi", "fil", "fr", "fr-CA", "hr", "hu", "id", "it", "ja", "ko", "lt", "lv", "ms", "mt", "nb", "nl", "pl", "pt", "pt-BR", "ro", "ru", "sk", "sl", "sv", "th", "tr", "vi", "zh", "zh-HK", "zh-TW"];
159
+ /**
160
+ * Language of a hosted checkout page. Providers that name their languages
161
+ * differently map each value to their own code, and fall back to their own
162
+ * default where they have no match.
163
+ */
164
+ export type PaymentLocale = (typeof PAYMENT_LOCALES)[number];
153
165
  /**
154
166
  * Parameters for {@link CreateCheckoutSession}.
155
167
  */
@@ -178,8 +190,8 @@ export interface CheckoutSessionRequest {
178
190
  savePaymentMethod?: boolean;
179
191
  /** Shown to the payer where supported. */
180
192
  description?: string;
181
- /** BCP-47 language tag for the hosted page, where supported. */
182
- locale?: string;
193
+ /** Language of the hosted page, where supported. */
194
+ locale?: PaymentLocale;
183
195
  /** Round-tripped opaque key/value pairs. */
184
196
  metadata?: Record<string, string>;
185
197
  }
package/dist/types.js CHANGED
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.PAYMENT_EVENT_TYPES = exports.PAYMENT_METHOD_TYPES = exports.REFUND_REASONS = exports.REFUND_STATUSES = exports.PAYMENT_FAILURE_CODES = exports.TERMINAL_PAYMENT_STATUSES = exports.PAYMENT_STATUSES = void 0;
3
+ exports.PAYMENT_EVENT_TYPES = exports.PAYMENT_METHOD_TYPES = exports.REFUND_REASONS = exports.REFUND_STATUSES = exports.PAYMENT_LOCALES = exports.PAYMENT_FAILURE_CODES = exports.TERMINAL_PAYMENT_STATUSES = exports.PAYMENT_STATUSES = void 0;
4
4
  exports.isTerminalPaymentStatus = isTerminalPaymentStatus;
5
5
  /**
6
6
  * Every value {@link PaymentStatus} can take, in lifecycle order.
@@ -45,6 +45,54 @@ exports.PAYMENT_FAILURE_CODES = Object.freeze([
45
45
  "expired",
46
46
  "processing_error",
47
47
  ]);
48
+ /**
49
+ * Every value {@link PaymentLocale} can take: the hosted page languages
50
+ * Stripe Checkout accepts. `auto` lets the provider pick from the payer's
51
+ * browser.
52
+ */
53
+ exports.PAYMENT_LOCALES = Object.freeze([
54
+ "auto",
55
+ "bg",
56
+ "cs",
57
+ "da",
58
+ "de",
59
+ "el",
60
+ "en",
61
+ "en-GB",
62
+ "es",
63
+ "es-419",
64
+ "et",
65
+ "fi",
66
+ "fil",
67
+ "fr",
68
+ "fr-CA",
69
+ "hr",
70
+ "hu",
71
+ "id",
72
+ "it",
73
+ "ja",
74
+ "ko",
75
+ "lt",
76
+ "lv",
77
+ "ms",
78
+ "mt",
79
+ "nb",
80
+ "nl",
81
+ "pl",
82
+ "pt",
83
+ "pt-BR",
84
+ "ro",
85
+ "ru",
86
+ "sk",
87
+ "sl",
88
+ "sv",
89
+ "th",
90
+ "tr",
91
+ "vi",
92
+ "zh",
93
+ "zh-HK",
94
+ "zh-TW",
95
+ ]);
48
96
  /** Normalised refund lifecycle. */
49
97
  exports.REFUND_STATUSES = Object.freeze([
50
98
  "pending",
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAwDA,0DAEC;AA3CD;;GAEG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,SAAS;IACT,iBAAiB;IACjB,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,UAAU;CACF,CAAC,CAAC;AAgBZ;;GAEG;AACU,QAAA,yBAAyB,GACpC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAErD;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CAAC,MAAqB;IAC3D,OAAO,iCAAyB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,UAAU;IACV,oBAAoB;IACpB,cAAc;IACd,mBAAmB;IACnB,uBAAuB;IACvB,mBAAmB;IACnB,SAAS;IACT,kBAAkB;CACV,CAAC,CAAC;AAkKZ,mCAAmC;AACtB,QAAA,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,SAAS;IACT,WAAW;IACX,QAAQ;CACA,CAAC,CAAC;AAUZ;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,WAAW;IACX,YAAY;IACZ,uBAAuB;IACvB,OAAO;CACC,CAAC,CAAC;AAwEZ,gDAAgD;AACnC,QAAA,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,MAAM;IACN,QAAQ;IACR,cAAc;IACd,OAAO;CACC,CAAC,CAAC;AAyDZ;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,iBAAiB;IACjB,oBAAoB;IACpB,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,gBAAgB;CACR,CAAC,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAwDA,0DAEC;AA3CD;;GAEG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,SAAS;IACT,iBAAiB;IACjB,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,UAAU;CACF,CAAC,CAAC;AAgBZ;;GAEG;AACU,QAAA,yBAAyB,GACpC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAErD;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CAAC,MAAqB;IAC3D,OAAO,iCAAyB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,UAAU;IACV,oBAAoB;IACpB,cAAc;IACd,mBAAmB;IACnB,uBAAuB;IACvB,mBAAmB;IACnB,SAAS;IACT,kBAAkB;CACV,CAAC,CAAC;AA0GZ;;;;GAIG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,OAAO;IACP,OAAO;CACC,CAAC,CAAC;AAiEZ,mCAAmC;AACtB,QAAA,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,SAAS;IACT,WAAW;IACX,QAAQ;CACA,CAAC,CAAC;AAUZ;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,WAAW;IACX,YAAY;IACZ,uBAAuB;IACvB,OAAO;CACC,CAAC,CAAC;AAwEZ,gDAAgD;AACnC,QAAA,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,MAAM;IACN,QAAQ;IACR,cAAc;IACd,OAAO;CACC,CAAC,CAAC;AAyDZ;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,iBAAiB;IACjB,oBAAoB;IACpB,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,gBAAgB;CACR,CAAC,CAAC"}
@@ -1,9 +1,13 @@
1
- # Introduction
1
+ ---
2
+ title: Introduction
3
+ description: What the payment interface covers, what it leaves out and why, and the conventions every function follows.
4
+ mode: explanation
5
+ ---
2
6
 
3
7
  `@antelopejs/interface-payment` defines a provider-agnostic payment interface for
4
8
  AntelopeJS applications. A backend written against it takes payments, refunds
5
- them, saves payment methods and reacts to settlement events without naming a
6
- provider, and can change provider by swapping the module wired underneath.
9
+ them, saves payment methods, and reacts to settlement events without naming a
10
+ provider. To change provider, it swaps the module that implements the interface.
7
11
 
8
12
  ## What it covers
9
13
 
@@ -17,24 +21,28 @@ provider, and can change provider by swapping the module wired underneath.
17
21
 
18
22
  ## What it deliberately does not cover
19
23
 
20
- Subscriptions, invoicing, proration, dunning, tax and coupons; marketplace split
21
- payments; dispute _management_; payment links; in-person terminals.
24
+ The interface leaves out these areas:
22
25
 
23
- These are where providers diverge most, and modelling them would mean an
24
- interface most implementations could only decline. For recurring access, use
25
- `@antelopejs/interface-subscriptions`: Stripe native billing is recommended with
26
- Stripe. Choose `@antelopejs/payment-subscriptions` explicitly when you need a
27
- generic clock on saved methods and off-session charges. Each subscription must
28
- have one renewal owner; provider-specific billing features remain outside the
29
- portable contract.
30
- [Provider capability matrix](./5.provider-capability-matrix.md) has the reasoning
31
- per feature.
26
+ - subscriptions, invoicing, proration, dunning, tax, and coupons
27
+ - marketplace split payments
28
+ - dispute _management_
29
+ - payment links
30
+ - in-person terminals
31
+
32
+ Providers differ most in these areas. Modelling them would produce an interface
33
+ that most implementations could only decline. For recurring access, use
34
+ `@antelopejs/interface-subscriptions`. With Stripe, use Stripe's native billing.
35
+ Choose `@antelopejs/payment-subscriptions` explicitly when you need a generic
36
+ renewal clock on saved methods and off-session charges. Give each subscription
37
+ one renewal owner. Billing features specific to one provider stay outside the
38
+ portable contract. The [provider capability matrix](./5.provider-capability-matrix.md)
39
+ gives the reasoning for each feature.
32
40
 
33
41
  When a backend needs something beyond this contract, it uses the provider's own
34
- interface — `@antelopejs/interface-stripe` for Stripe — alongside this one. That
35
- is the escape hatch, and it is why this interface does not have one of its own:
36
- an escape hatch here would hand back a provider-shaped object and quietly undo
37
- the portability the interface exists for.
42
+ interface alongside this one, such as `@antelopejs/interface-stripe` for Stripe.
43
+ That is the way out of the contract, so this interface has no escape hatch of
44
+ its own. An escape hatch here would return an object shaped by one provider, and
45
+ code that used it would no longer be portable.
38
46
 
39
47
  ## Installation
40
48
 
@@ -42,50 +50,57 @@ the portability the interface exists for.
42
50
  pnpm add @antelopejs/interface-payment
43
51
  ```
44
52
 
45
- Add a module that implements it to your Antelope config; this package declares
46
- the contract and ships no provider logic.
53
+ This package declares the contract and ships no provider logic. Add a module that
54
+ implements it to your AntelopeJS project config.
47
55
 
48
56
  ## Conventions
49
57
 
50
- These hold across every function, and an implementation that breaks one is
51
- non-conformant.
58
+ These conventions hold for every function. An implementation that breaks one
59
+ does not conform to the contract.
52
60
 
53
61
  **Amounts are integer minor units.** `{ value: 1050, currency: "EUR" }` is €10.50.
54
- Never a float: binary floating point cannot represent most decimal amounts, and
55
- providers round differently when you hand them one. `JPY` has no subunit, so
62
+ Never use a float. Binary floating point cannot represent most decimal amounts,
63
+ and providers round a float differently. `JPY` has no subunit, so
56
64
  `{ value: 1050, currency: "JPY" }` is ¥1050. `KWD` has three decimal places.
57
- Every derived amount on a `Payment` — `amountCaptured`, `amountRefunded` — is in
65
+ The derived amounts on a `Payment`, `amountCaptured` and `amountRefunded`, are in
58
66
  the same currency as `amount`.
59
67
 
60
- **Every mutating call takes an idempotency key.** Payments are the canonical case
61
- where a retried request must not do the work twice. Generate one key per
62
- logical operation, store it with your own record, and reuse it on retry: the
63
- provider returns the original result within its provider-defined replay window.
64
- Reads take no key. After expiration, applications must reconcile uncertain
65
- payments with provider records before retrying; a reused key can charge again.
68
+ **Every mutating call takes an idempotency key.** A retried payment request must
69
+ not do the work twice. Generate one key per logical operation, store it with your
70
+ own record, and reuse it on retry. Within its provider-defined replay window, the
71
+ provider returns the original result. Reads take no key. After the window
72
+ expires, reconcile uncertain payments with the provider's records before you
73
+ retry, because a reused key can charge again.
66
74
 
67
75
  **Provider identifiers are opaque.** `Payment.id`, `Refund.id`, `Customer.id`,
68
- `PaymentMethod.id` and `CheckoutSession.id` are the provider's own strings. Do
69
- not parse them, do not infer a type from a prefix, and do not assume two
70
- providers shape them alike. Correlate with your own records through
76
+ `PaymentMethod.id`, and `CheckoutSession.id` are the provider's own strings. Do
77
+ not parse them, do not infer a type from a prefix, and do not assume that two
78
+ providers shape them alike. Correlate them with your own records through
71
79
  `reference` and `metadata`.
72
80
 
73
81
  **A failed payment is not a thrown error.** `CreatePayment` resolves with a
74
- `Payment` whose status is `failed`; it rejects only when the call itself could
82
+ `Payment` whose status is `failed`. It rejects only when the call itself could
75
83
  not be made. See [Payments](./2.payments.md).
76
84
 
77
85
  **Settlement is asynchronous.** Every provider this interface targets settles
78
- some payments after the call returns, and some after the payer has left. A
79
- terminal state is learned from `VerifyWebhook`, not from the payer's return to
80
- your `successUrl`. See [Webhooks](./4.webhooks.md).
86
+ some payments after the call returns, and some after the payer has left. Your
87
+ backend learns a terminal state from `VerifyWebhook`, not from the payer's return
88
+ to your `successUrl`. See [Webhooks](./4.webhooks.md).
81
89
 
82
90
  ## Multi-account setups
83
91
 
84
- Every function takes an optional trailing `provider` argument naming which
85
- configured account to use, for a backend running more than one merchant account
86
- or more than one provider at once. Omit it for the default.
92
+ Every function takes an optional trailing `provider` argument. It names the
93
+ configured account to use, for a backend that runs more than one merchant
94
+ account or more than one provider at once. Omit it for the default account.
87
95
 
88
96
  ```ts
89
- await CreatePayment(request, key); // default account
90
- await CreatePayment(request, key, "marketplace"); // a named one
97
+ import {
98
+ CreatePayment,
99
+ type PaymentRequest,
100
+ } from "@antelopejs/interface-payment";
101
+
102
+ export async function charge(request: PaymentRequest, key: string) {
103
+ await CreatePayment(request, key); // default account
104
+ await CreatePayment(request, key, "marketplace"); // a named one
105
+ }
91
106
  ```