@invonetwork/web-sdk 3.8.0 → 3.8.1
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/CHANGELOG.md +10 -0
- package/README.md +4 -4
- package/dist/server.cjs +1 -1
- package/dist/server.d.cts +1 -1
- package/dist/server.d.ts +1 -1
- package/dist/server.js +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 3.8.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Subscription docs: the per-charge ceiling is 25000.00, not 500.00, and it is
|
|
8
|
+
per CHARGE rather than per month. An annual plan bills the whole year in one
|
|
9
|
+
go, so a $500 a month plan sold as a 12-month plan is a single $6,000 charge
|
|
10
|
+
and is chargeable. The old number quietly refused every annual plan above
|
|
11
|
+
$41.66 a month.
|
|
12
|
+
|
|
3
13
|
## 3.8.0
|
|
4
14
|
|
|
5
15
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -659,7 +659,7 @@ const r = await server.subscriptions.create({
|
|
|
659
659
|
playerName: "Member", // used only if the player is created
|
|
660
660
|
itemId: "guild-42-membership", // your entitlement handle; one live subscription per (player, item)
|
|
661
661
|
itemName: "Guild 42 membership",
|
|
662
|
-
amountUsd: "9.99", // 0.01..999999.99; keep it <=
|
|
662
|
+
amountUsd: "9.99", // 0.01..999999.99; keep it <= 25000.00 PER CHARGE or it is never charged
|
|
663
663
|
interval: "month", // "month" (default) | "year"
|
|
664
664
|
// intervalCount: 3, // quarterly; 1..36
|
|
665
665
|
// trialDays: 7, // or trialEnd: "2026-10-01T00:00:00Z"
|
|
@@ -793,7 +793,7 @@ export const POST = createWebhookHandler({
|
|
|
793
793
|
| Should I revoke access? | only on `subscription.expired` (at `final_period_end`) or `subscription.canceled` (at `access_until`); **never** on `payment_failed`, `past_due` or `authentication_required` |
|
|
794
794
|
| What did I earn? | `split.partner_revenue_usd` on `subscription.renewed`, minus `refund.partner_revenue_reversed_usd` on any `subscription.refunded` |
|
|
795
795
|
|
|
796
|
-
A few renewal outcomes are **deferrals**, not failures, with no event and no retry consumed (a price above the
|
|
796
|
+
A few renewal outcomes are **deferrals**, not failures, with no event and no retry consumed (a price above the 25000.00 per-charge ceiling; wallet value that cannot be spent in this game; on Steam, your billing setup or Steam configuration being unusable). You see them on `get` as an unchanged (or `past_due`) status with `nextChargeAt` about 24 hours out.
|
|
797
797
|
|
|
798
798
|
### Reading, cancelling, repricing, changing the card
|
|
799
799
|
|
|
@@ -809,7 +809,7 @@ const c = await server.subscriptions.cancel(id, { atPeriodEnd: true, reason: "me
|
|
|
809
809
|
|
|
810
810
|
const a = await server.subscriptions.changeAmount(id, "14.99");
|
|
811
811
|
// Staged: the current window bills at the old price, the new price applies from a.appliesFromPeriodSeq. No proration.
|
|
812
|
-
// Sending the current price clears a staged change. More than double, or above
|
|
812
|
+
// Sending the current price clears a staged change. More than double, or above 25000.00, stays pending forever.
|
|
813
813
|
|
|
814
814
|
await server.subscriptions.setPaymentMethod(id, { playerCardId: 43 }); // used from the next charge, incl. a pending retry
|
|
815
815
|
await server.subscriptions.setPaymentMethod(id, { playerCardId: 43, walletOnly: false }); // convert a wallet-only subscription back
|
|
@@ -902,7 +902,7 @@ Client-side guards (missing key, a `sub_`-prefixed key, a bad amount, a non-E.16
|
|
|
902
902
|
9. **Period numbers differ by road.** `subscription.periodSeq` after a paid charge is the *next* period; `firstCharge.paidPeriodSeq` and the webhook's `period_seq` are the period *just paid*. Key entitlement on the latter.
|
|
903
903
|
10. **A card saved without off-session consent cannot back a subscription.** Hosted checkout and `savedCardId` purchases do not save one; use `cards.beginSetup` or a `save_card: true` purchase.
|
|
904
904
|
11. **`walletOnly` is absolute.** A card attached later is ignored until you pass `walletOnly: false` on `setPaymentMethod`.
|
|
905
|
-
12. **Price changes apply next period, and big jumps never apply.** More than double, or above
|
|
905
|
+
12. **Price changes apply next period, and big jumps never apply.** More than double, or above 25000.00, stays pending.
|
|
906
906
|
13. **`sub_` is reserved** as a prefix for every idempotency key on the platform.
|
|
907
907
|
14. **Do not store or log `confirmationUrl`** beside anything you publish. It is a bearer link.
|
|
908
908
|
15. **Steam: finalize is your call**, the member has 24 hours, `web` needs `playerIp` and a top-level window, match the client callback on `steamOrderId`, show `amountCoins` (country-dependent, fixed at init), and `split.total_usd` on a Steam renewal is *not* the price.
|
package/dist/server.cjs
CHANGED
|
@@ -1909,7 +1909,7 @@ var SubscriptionsServer = class {
|
|
|
1909
1909
|
*
|
|
1910
1910
|
* Steam: an increase is refused (`err.isSteamReauthorizationRequired`; start a new
|
|
1911
1911
|
* Steam subscription at the new price), a decrease stages. An increase to more than
|
|
1912
|
-
* double the last agreed price, or above
|
|
1912
|
+
* double the last agreed price, or above 25000.00, is staged but never applied: raise
|
|
1913
1913
|
* prices in steps. `err.isSubscriptionTerminal` on a canceled/expired row.
|
|
1914
1914
|
*/
|
|
1915
1915
|
async changeAmount(subscriptionId, amountUsd, opts) {
|
package/dist/server.d.cts
CHANGED
|
@@ -565,7 +565,7 @@ declare class SubscriptionsServer {
|
|
|
565
565
|
*
|
|
566
566
|
* Steam: an increase is refused (`err.isSteamReauthorizationRequired`; start a new
|
|
567
567
|
* Steam subscription at the new price), a decrease stages. An increase to more than
|
|
568
|
-
* double the last agreed price, or above
|
|
568
|
+
* double the last agreed price, or above 25000.00, is staged but never applied: raise
|
|
569
569
|
* prices in steps. `err.isSubscriptionTerminal` on a canceled/expired row.
|
|
570
570
|
*/
|
|
571
571
|
changeAmount(subscriptionId: string, amountUsd: string | number, opts?: CallOptions): Promise<ChangeAmountResult>;
|
package/dist/server.d.ts
CHANGED
|
@@ -565,7 +565,7 @@ declare class SubscriptionsServer {
|
|
|
565
565
|
*
|
|
566
566
|
* Steam: an increase is refused (`err.isSteamReauthorizationRequired`; start a new
|
|
567
567
|
* Steam subscription at the new price), a decrease stages. An increase to more than
|
|
568
|
-
* double the last agreed price, or above
|
|
568
|
+
* double the last agreed price, or above 25000.00, is staged but never applied: raise
|
|
569
569
|
* prices in steps. `err.isSubscriptionTerminal` on a canceled/expired row.
|
|
570
570
|
*/
|
|
571
571
|
changeAmount(subscriptionId: string, amountUsd: string | number, opts?: CallOptions): Promise<ChangeAmountResult>;
|
package/dist/server.js
CHANGED
|
@@ -1062,7 +1062,7 @@ var SubscriptionsServer = class {
|
|
|
1062
1062
|
*
|
|
1063
1063
|
* Steam: an increase is refused (`err.isSteamReauthorizationRequired`; start a new
|
|
1064
1064
|
* Steam subscription at the new price), a decrease stages. An increase to more than
|
|
1065
|
-
* double the last agreed price, or above
|
|
1065
|
+
* double the last agreed price, or above 25000.00, is staged but never applied: raise
|
|
1066
1066
|
* prices in steps. `err.isSubscriptionTerminal` on a canceled/expired row.
|
|
1067
1067
|
*/
|
|
1068
1068
|
async changeAmount(subscriptionId, amountUsd, opts) {
|
package/package.json
CHANGED