@blockmoblabs/cryptopay 0.2.1 → 0.2.2

package/README.md

@@ -50,9 +50,9 @@ Non-2xx responses throw `CryptoPayError` with `status` and `body`.
 
 ## Subscriptions
 
-Crypto cannot be pulled from a wallet, so a subscription is a recurring invoice. Three days before
-each due date the customer is emailed a payment link, then reminded once a day. If it is still
-unpaid three days after the due date, the subscription lapses.
+Crypto cannot be pulled from a wallet, so a subscription is a recurring invoice. `noticeDays` before
+each due date (default 3) the customer is emailed a payment link, then reminded once a day. If it is
+still unpaid `graceDays` after the due date (default 3), the subscription lapses.
 
 ```ts
 const sub = await cryptopay.createSubscription({
@@ -62,6 +62,8 @@ const sub = await cryptopay.createSubscription({
   firstDueAt: '2026-11-02',           // later payments stay on the 2nd
   reference: 'sub_221',               // comes back as customer.subscriptionRef
   description: 'Pro plan',            // shown to the customer in the emails
+  noticeDays: 5,                      // optional, 1-14: first email 5 days before each due date
+  graceDays: 3,                       // optional, 0-14: lapses 3 days after it if unpaid
 });
 ```
 

package/dist/index.d.ts

@@ -42,9 +42,10 @@ export declare class CryptoPay {
         nextCursor: string | null;
     }>;
     /**
-     * Bill a customer on a schedule. Three days before each due date they are emailed a payment link,
-     * then reminded daily; unpaid three days after it, the subscription lapses. Each payment arrives
-     * as an ordinary `payment.completed` webhook carrying your `reference` as `subscriptionRef`.
+     * Bill a customer on a schedule. `noticeDays` (default 3) before each due date they are emailed a
+     * payment link, then reminded daily; unpaid `graceDays` (default 3) after it, the subscription
+     * lapses. Each payment arrives as an ordinary `payment.completed` webhook carrying your
+     * `reference` as `subscriptionRef`.
      */
     createSubscription(input: CreateSubscriptionInput): Promise<Subscription>;
     getSubscription(id: string): Promise<Subscription>;

package/dist/index.js

@@ -54,9 +54,10 @@ export class CryptoPay {
         return this.request('GET', `/payment-intents${suffix ? `?${suffix}` : ''}`);
     }
     /**
-     * Bill a customer on a schedule. Three days before each due date they are emailed a payment link,
-     * then reminded daily; unpaid three days after it, the subscription lapses. Each payment arrives
-     * as an ordinary `payment.completed` webhook carrying your `reference` as `subscriptionRef`.
+     * Bill a customer on a schedule. `noticeDays` (default 3) before each due date they are emailed a
+     * payment link, then reminded daily; unpaid `graceDays` (default 3) after it, the subscription
+     * lapses. Each payment arrives as an ordinary `payment.completed` webhook carrying your
+     * `reference` as `subscriptionRef`.
      */
     createSubscription(input) {
         return this.request('POST', '/subscriptions', { body: input });

package/dist/types.d.ts

@@ -85,6 +85,10 @@ export type CreateSubscriptionInput = {
     interval: 'week' | 'month' | 'year';
     /** When the first payment is due (ISO date). Left out: now. Later ones keep the same day. */
     firstDueAt?: string;
+    /** Days before each due date the customer is first emailed. 1 to 14, default 3. */
+    noticeDays?: number;
+    /** Days after the due date an unpaid subscription lapses. 0 to 14, default 3. */
+    graceDays?: number;
     customerRef?: string;
     /** Your own id for this subscription. Comes back as `customer.subscriptionRef` on every payment. */
     reference?: string;
@@ -102,6 +106,8 @@ export type Subscription = {
     description: string | null;
     amountUsd: number;
     interval: 'week' | 'month' | 'year';
+    noticeDays: number;
+    graceDays: number;
     /** When the period now being collected is due. Null once the subscription has ended. */
     dueAt: string | null;
     periodsPaid: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockmoblabs/cryptopay",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "CryptoPay crypto payment infrastructure: create payment intents, open the checkout, verify webhooks.",
   "license": "MIT",
   "type": "module",