chargefy-js 1.1.6 → 1.1.9

package/README.md

@@ -112,6 +112,17 @@ const result = await chargefy.products.create({
   prices: [{ amount: 4900 }], // R$ 49,00/month
 })
 
+// Create product with referenceId (upsert: update if exists for org)
+const result = await chargefy.products.create({
+  organizationId: 'org_xxx',
+  name: 'My Product',
+  referenceId: 'my-product-123', // Your internal ID
+  prices: [{ amount: 9900 }],
+})
+
+// Get product by reference_id (OAT uses token's org)
+const result = await chargefy.products.getByReferenceId('my-product-123')
+
 // Update product
 const result = await chargefy.products.update({
   id: 'prod_xxx',
@@ -120,6 +131,10 @@ const result = await chargefy.products.update({
 })
 ```
 
+| Create/Update field | Type | Description |
+|---------------------|------|-------------|
+| `referenceId` | `string \| null` | Optional. Your internal product ID. When set on create, upserts: if a product with this `referenceId` exists for the org, it updates; else creates. Unique per org. |
+
 ---
 
 ## Checkout Links
@@ -143,14 +158,36 @@ const result = await chargefy.checkoutLinks.create({
 })
 // result.value.url → share this URL with buyers
 
+// Create checkout link with custom price (override product's default)
+const result = await chargefy.checkoutLinks.create({
+  organizationId: 'org_xxx',
+  productId: 'prod_xxx',
+  successUrl: 'https://mysite.com/thank-you',
+  customPriceAmount: 7900, // R$ 79,00 in cents — buyers pay this instead of product price
+})
+
 // Update checkout link
 const result = await chargefy.checkoutLinks.update({
   id: 'cl_xxx',
   successUrl: 'https://mysite.com/new-success-page',
   allowDiscountCodes: true,
 })
+
+// Update checkout link price (or clear with null)
+const result = await chargefy.checkoutLinks.update({
+  id: 'cl_xxx',
+  customPriceAmount: 9900, // R$ 99,00 — override for this link only
+})
+
+// Get shareable URL (convenience)
+const urlResult = await chargefy.checkoutLinks.getLink('cl_xxx')
+// urlResult.value → full redirect URL to share with buyers
 ```
 
+| Create/Update field | Type | Description |
+|---------------------|------|-------------|
+| `customPriceAmount` | `number \| null` | Optional. Price override in cents. When set, buyers pay this amount instead of the product's default. Pass `null` on update to clear. |
+
 ---
 
 ## Sub-Organizations
@@ -187,6 +224,14 @@ const result = await chargefy.subOrganizations.createProduct('org_child_xxx', {
   prices: [{ amountType: 'fixed', priceAmount: 9900, priceCurrency: 'brl' }],
 })
 
+// Create product with referenceId (upsert for child org)
+const result = await chargefy.subOrganizations.createProduct('org_child_xxx', {
+  feePercent: 5,
+  name: 'Child Product',
+  referenceId: 'child-prod-123',
+  prices: [{ amountType: 'fixed', priceAmount: 9900, priceCurrency: 'brl' }],
+})
+
 // List/create/revoke child's API keys
 const tokens = await chargefy.subOrganizations.listApiKeys('org_child_xxx')
 const newToken = await chargefy.subOrganizations.createApiKey('org_child_xxx', { comment: 'Marketing' })
@@ -195,6 +240,40 @@ await chargefy.subOrganizations.revokeApiKey('org_child_xxx', 'token_id')
 
 ---
 
+## Sub-Organization Administration
+
+Child organizations can manage their own products and checkout links using their **OAT** (Organization Access Token). Use the same `products` and `checkoutLinks` namespaces with the child's token:
+
+```ts
+// Initialize with child org's OAT (from createApiKey or parent's dashboard)
+const childChargefy = new Chargefy({
+  accessToken: 'chargefy_oat_CHILD_TOKEN',
+  server: 'production',
+})
+
+// Child creates products (org inferred from token)
+const product = await childChargefy.products.create({
+  organizationId: 'org_child_xxx', // Same as token's org
+  name: 'My Product',
+  referenceId: 'my-internal-id',
+  prices: [{ amount: 9900 }],
+})
+
+// Child creates checkout link with custom price
+const link = await childChargefy.checkoutLinks.create({
+  organizationId: 'org_child_xxx',
+  productId: product.value.id,
+  successUrl: 'https://child-site.com/thanks',
+  customPriceAmount: 7900,
+})
+
+// Get shareable URL
+const urlResult = await childChargefy.checkoutLinks.getLink(link.value.id)
+console.log('Share:', urlResult.value)
+```
+
+---
+
 ## Onboarding Links
 
 Create reusable embed onboarding links. **OAT required.**

package/dist/core.d.ts

@@ -20,6 +20,8 @@ export interface ChargefyCoreOptions {
     serverURL?: string;
     /** Request timeout in milliseconds. Default: 30000. */
     timeout?: number;
+    /** Extra headers sent with every request (e.g. X-Chargefy-Source: embed). */
+    headers?: Record<string, string>;
 }
 export type APIError = ResourceNotFound | ExpiredCheckoutError | HTTPValidationError | PaymentError | NotOpenCheckout | AlreadyActiveSubscriptionError | PaymentNotReady | SDKError | UnexpectedClientError | InvalidRequestError | RequestAbortedError | RequestTimeoutError | ConnectionError;
 interface RequestOptions {
@@ -36,6 +38,7 @@ export declare class ChargefyCore {
     readonly serverURL: string;
     readonly accessToken: string | undefined;
     readonly timeout: number;
+    readonly headers: Record<string, string>;
     constructor(options?: ChargefyCoreOptions);
     request<T>(options: RequestOptions): Promise<Result<T, APIError>>;
 }

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAA;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACjC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,mBAAmB,GACnB,YAAY,GACZ,eAAe,GACf,8BAA8B,GAC9B,eAAe,GACf,QAAQ,GACR,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,CAAA;AAEnB,UAAU,cAAc;IACtB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,oFAAoF;IACpF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;IACpE,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;gBAEZ,OAAO,GAAE,mBAAwB;IAgBvC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;CA+DxE"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAA;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACjC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,mBAAmB,GACnB,YAAY,GACZ,eAAe,GACf,8BAA8B,GAC9B,eAAe,GACf,QAAQ,GACR,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,CAAA;AAEnB,UAAU,cAAc;IACtB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,oFAAoF;IACpF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;IACpE,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBAE5B,OAAO,GAAE,mBAAwB;IAiBvC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;CAgExE"}

package/dist/core.js

@@ -9,6 +9,7 @@ export class ChargefyCore {
     serverURL;
     accessToken;
     timeout;
+    headers;
     constructor(options = {}) {
         if (options.serverURL) {
             this.serverURL = options.serverURL.replace(/\/$/, '');
@@ -26,6 +27,7 @@ export class ChargefyCore {
         }
         this.accessToken = options.accessToken;
         this.timeout = options.timeout ?? 30000;
+        this.headers = options.headers ?? {};
     }
     async request(options) {
         const { method, path, body, bodyIsFormData, query, auth = true } = options;
@@ -48,6 +50,7 @@ export class ChargefyCore {
         if (auth && this.accessToken) {
             headers['Authorization'] = `Bearer ${this.accessToken}`;
         }
+        Object.assign(headers, this.headers);
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeout);
         try {

package/dist/models/checkoutLink.d.ts

@@ -9,6 +9,8 @@ export interface CheckoutLink {
     allowDiscountCodes: boolean;
     isArchived: boolean;
     metadata?: Record<string, unknown>;
+    /** Optional price override in cents. When set, used instead of product price when buyer opens the link. */
+    customPriceAmount?: number | null;
     createdAt: string;
 }
 export interface CreateCheckoutLinkRequest {
@@ -19,11 +21,15 @@ export interface CreateCheckoutLinkRequest {
     successUrl?: string;
     allowDiscountCodes?: boolean;
     metadata?: Record<string, unknown>;
+    /** Optional price override in cents. When set, buyers pay this amount instead of the product's default price. */
+    customPriceAmount?: number | null;
 }
 export interface UpdateCheckoutLinkRequest {
     id: string;
     successUrl?: string;
     allowDiscountCodes?: boolean;
     metadata?: Record<string, unknown>;
+    /** Optional price override in cents. When set, buyers pay this amount instead of the product's default price. Pass null to clear. */
+    customPriceAmount?: number | null;
 }
 //# sourceMappingURL=checkoutLink.d.ts.map

package/dist/models/checkoutLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkoutLink.d.ts","sourceRoot":"","sources":["../../src/models/checkoutLink.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC"}
+{"version":3,"file":"checkoutLink.d.ts","sourceRoot":"","sources":["../../src/models/checkoutLink.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,2GAA2G;IAC3G,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,iHAAiH;IACjH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,qIAAqI;IACrI,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC"}

package/dist/models/product.d.ts

@@ -18,6 +18,8 @@ export interface Product {
     prices: ProductPrice[];
     createdAt: string;
     metadata?: Record<string, unknown>;
+    /** Customer-side product ID; unique per org; enables upsert and lookup */
+    referenceId?: string | null;
 }
 export interface CreateProductRequest {
     organizationId: string;
@@ -33,6 +35,8 @@ export interface CreateProductRequest {
         currency?: string;
     }>;
     metadata?: Record<string, unknown>;
+    /** Customer-side product ID. When set, upserts: if exists for org, updates; else creates. */
+    referenceId?: string | null;
 }
 export interface UpdateProductRequest {
     id: string;
@@ -40,5 +44,6 @@ export interface UpdateProductRequest {
     description?: string;
     isArchived?: boolean;
     metadata?: Record<string, unknown>;
+    referenceId?: string | null;
 }
 //# sourceMappingURL=product.d.ts.map

package/dist/models/product.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/models/product.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,sCAAsC;IACtC,MAAM,EAAE,KAAK,CAAC;QACZ,oDAAoD;QACpD,MAAM,EAAE,MAAM,CAAA;QACd,8CAA8C;QAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC"}
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/models/product.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3C,sCAAsC;IACtC,MAAM,EAAE,KAAK,CAAC;QACZ,oDAAoD;QACpD,MAAM,EAAE,MAAM,CAAA;QACd,8CAA8C;QAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B"}

package/dist/models/sub-organization.d.ts

@@ -108,6 +108,8 @@ export interface CreateProductForChildRequest {
     }>;
     metadata?: Record<string, unknown>;
     medias?: string[];
+    /** Customer-side product ID. When set, upserts: if exists for child org, updates; else creates. */
+    referenceId?: string | null;
 }
 export interface CreateSubOrganizationResponse {
     organization: {

package/dist/models/sub-organization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sub-organization.d.ts","sourceRoot":"","sources":["../../src/models/sub-organization.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sub-organization.d.ts","sourceRoot":"","sources":["../../src/models/sub-organization.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/checkoutLinks.d.ts

@@ -9,6 +9,8 @@ export declare class CheckoutLinks {
     list(params?: ListParams): Promise<Result<ListResponse<CheckoutLink>, APIError>>;
     /** Get a single checkout link by ID. */
     get(id: string): Promise<Result<CheckoutLink, APIError>>;
+    /** Get the shareable checkout URL for a checkout link. Convenience wrapper around get(). */
+    getLink(id: string): Promise<Result<string, APIError>>;
     /** Create a new checkout link. */
     create(body: CreateCheckoutLinkRequest): Promise<Result<CheckoutLink, APIError>>;
     /** Update an existing checkout link. */

package/dist/namespaces/checkoutLinks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkoutLinks.d.ts","sourceRoot":"","sources":["../../src/namespaces/checkoutLinks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAChH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEpE,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C,iDAAiD;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;IAQhF,wCAAwC;IACxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAOxD,kCAAkC;IAClC,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAgBhF,wCAAwC;IACxC,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CAYjF"}
+{"version":3,"file":"checkoutLinks.d.ts","sourceRoot":"","sources":["../../src/namespaces/checkoutLinks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAChH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEpE,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C,iDAAiD;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;IAQhF,wCAAwC;IACxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAOxD,4FAA4F;IACtF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAM5D,kCAAkC;IAClC,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAiBhF,wCAAwC;IACxC,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CAajF"}

package/dist/namespaces/checkoutLinks.js

@@ -18,6 +18,13 @@ export class CheckoutLinks {
             path: `/v1/checkout-links/${id}`,
         });
     }
+    /** Get the shareable checkout URL for a checkout link. Convenience wrapper around get(). */
+    async getLink(id) {
+        const result = await this.get(id);
+        if (!result.ok)
+            return result;
+        return { ok: true, value: result.value.url };
+    }
     /** Create a new checkout link. */
     create(body) {
         const payload = {
@@ -32,6 +39,8 @@ export class CheckoutLinks {
             payload.allow_discount_codes = body.allowDiscountCodes;
         if (body.metadata !== undefined)
             payload.metadata = body.metadata;
+        if (body.customPriceAmount !== undefined)
+            payload.custom_price_amount = body.customPriceAmount;
         return this.core.request({
             method: 'POST',
             path: '/v1/checkout-links',
@@ -48,6 +57,8 @@ export class CheckoutLinks {
             payload.allow_discount_codes = rest.allowDiscountCodes;
         if (rest.metadata !== undefined)
             payload.metadata = rest.metadata;
+        if (rest.customPriceAmount !== undefined)
+            payload.custom_price_amount = rest.customPriceAmount;
         return this.core.request({
             method: 'PATCH',
             path: `/v1/checkout-links/${id}`,

package/dist/namespaces/checkouts.d.ts

@@ -1,6 +1,7 @@
 import type { ChargefyCore, APIError } from '../core';
 import type { Result } from '../types/fp';
 import type { Checkout, CheckoutConfirmed, CreateCheckoutRequest, UpdateCheckoutRequest, ConfirmCheckoutRequest, GeneratePixRequest } from '../models/checkout';
+import type { CheckoutUpdatePublic } from '../models/components/checkoutupdatepublic';
 export declare class Checkouts {
     private readonly core;
     constructor(core: ChargefyCore);
@@ -10,6 +11,8 @@ export declare class Checkouts {
     get(id: string): Promise<Result<Checkout, APIError>>;
     /** Get a checkout by its client secret. */
     getByClientSecret(clientSecret: string): Promise<Result<Checkout, APIError>>;
+    /** Update customer info on an open checkout by client secret (public, no auth). */
+    updateByClientSecret(clientSecret: string, data: CheckoutUpdatePublic): Promise<Result<Checkout, APIError>>;
     /** Update customer info on an open checkout. */
     update(body: UpdateCheckoutRequest): Promise<Result<Checkout, APIError>>;
     /**

package/dist/namespaces/checkouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkouts.d.ts","sourceRoot":"","sources":["../../src/namespaces/checkouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EACV,QAAQ,EACR,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,oBAAoB,CAAA;AAE3B,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C,qCAAqC;IACrC,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAoBxE,4BAA4B;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAOpD,2CAA2C;IAC3C,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAQ5E,gDAAgD;IAChD,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAcxE;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAuBnF;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;CAcpF"}
+{"version":3,"file":"checkouts.d.ts","sourceRoot":"","sources":["../../src/namespaces/checkouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EACV,QAAQ,EACR,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAGrF,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C,qCAAqC;IACrC,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAoBxE,4BAA4B;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAOpD,2CAA2C;IAC3C,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAQ5E,mFAAmF;IACnF,oBAAoB,CAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAUtC,gDAAgD;IAChD,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAcxE;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAuBnF;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;CAcpF"}

package/dist/namespaces/checkouts.js

@@ -1,3 +1,4 @@
+import { transformToSnakeCase } from '../utils/transformers';
 export class Checkouts {
     core;
     constructor(core) {
@@ -46,6 +47,16 @@ export class Checkouts {
             auth: false,
         });
     }
+    /** Update customer info on an open checkout by client secret (public, no auth). */
+    updateByClientSecret(clientSecret, data) {
+        const payload = transformToSnakeCase(data);
+        return this.core.request({
+            method: 'PATCH',
+            path: `/v1/checkouts/client/${clientSecret}`,
+            body: payload,
+            auth: false,
+        });
+    }
     /** Update customer info on an open checkout. */
     update(body) {
         const { id, ...rest } = body;

package/dist/namespaces/products.d.ts

@@ -9,9 +9,11 @@ export declare class Products {
     list(params?: ListParams): Promise<Result<ListResponse<Product>, APIError>>;
     /** Get a single product by ID. */
     get(id: string): Promise<Result<Product, APIError>>;
-    /** Create a new product. */
+    /** Create a new product. With referenceId, upserts if product exists for org. */
     create(body: CreateProductRequest): Promise<Result<Product, APIError>>;
     /** Update an existing product. */
     update(body: UpdateProductRequest): Promise<Result<Product, APIError>>;
+    /** Get product by reference_id. OAT uses token's org; pass organizationId when using user auth. */
+    getByReferenceId(referenceId: string, organizationId?: string): Promise<Result<Product, APIError>>;
 }
 //# sourceMappingURL=products.d.ts.map

package/dist/namespaces/products.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/namespaces/products.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEpE,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C,+CAA+C;IAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAQ3E,kCAAkC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAOnD,4BAA4B;IAC5B,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAmBtE,kCAAkC;IAClC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CAavE"}
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/namespaces/products.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEpE,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C,+CAA+C;IAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAQ3E,kCAAkC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAOnD,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAqBtE,kCAAkC;IAClC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAetE,mGAAmG;IACnG,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CAOtC"}

package/dist/namespaces/products.js

@@ -18,7 +18,7 @@ export class Products {
             path: `/v1/products/${id}`,
         });
     }
-    /** Create a new product. */
+    /** Create a new product. With referenceId, upserts if product exists for org. */
     create(body) {
         const payload = {
             organization_id: body.organizationId,
@@ -26,11 +26,14 @@ export class Products {
             description: body.description,
             recurring_interval: body.recurringInterval,
             prices: body.prices.map((p) => ({
-                amount: p.amount,
-                currency: p.currency ?? 'BRL',
+                amount_type: 'fixed',
+                price_amount: p.amount,
+                price_currency: (p.currency ?? 'BRL').toLowerCase(),
             })),
             metadata: body.metadata,
         };
+        if (body.referenceId !== undefined)
+            payload.reference_id = body.referenceId;
         return this.core.request({
             method: 'POST',
             path: '/v1/products',
@@ -49,10 +52,20 @@ export class Products {
             payload.is_archived = rest.isArchived;
         if (rest.metadata !== undefined)
             payload.metadata = rest.metadata;
+        if (rest.referenceId !== undefined)
+            payload.reference_id = rest.referenceId;
         return this.core.request({
             method: 'PATCH',
             path: `/v1/products/${id}`,
             body: payload,
         });
     }
+    /** Get product by reference_id. OAT uses token's org; pass organizationId when using user auth. */
+    getByReferenceId(referenceId, organizationId) {
+        return this.core.request({
+            method: 'GET',
+            path: `/v1/products/by-reference/${encodeURIComponent(referenceId)}`,
+            query: organizationId ? { organization_id: organizationId } : undefined,
+        });
+    }
 }

package/dist/namespaces/sub-organizations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sub-organizations.d.ts","sourceRoot":"","sources":["../../src/namespaces/sub-organizations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,cAAc,EACd,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,4BAA4B,CAAA;AAEnC,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C;;;OAGG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,YAAY,GAAG,UAAU,GACpC,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IASnD;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;QAAE,KAAK,EAAE,uBAAuB,EAAE,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAOvE;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAAC;IAQpG;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,KAAK,EAAE,cAAc,EAAE,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAOlF;;;;OAIG;IACH,YAAY,CACV,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,MAAM,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;IAQ1D;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAO7E;;;OAGG;IACH,YAAY,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAC9B,OAAO,CAAC,MAAM,CAAC;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAQ/G;;;OAGG;IACH,aAAa,CACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,4BAA4B,EAAE,4BAA4B,GACtE,OAAO,CAAC,MAAM,CAAC,OAAO,mBAAmB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;CAuClE"}
+{"version":3,"file":"sub-organizations.d.ts","sourceRoot":"","sources":["../../src/namespaces/sub-organizations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,cAAc,EACd,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,4BAA4B,CAAA;AAEnC,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,YAAY;IAE/C;;;OAGG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,YAAY,GAAG,UAAU,GACpC,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IASnD;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;QAAE,KAAK,EAAE,uBAAuB,EAAE,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAOvE;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAAC;IAQpG;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,KAAK,EAAE,cAAc,EAAE,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAOlF;;;;OAIG;IACH,YAAY,CACV,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,MAAM,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;IAQ1D;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAO7E;;;OAGG;IACH,YAAY,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAC9B,OAAO,CAAC,MAAM,CAAC;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAQ/G;;;OAGG;IACH,aAAa,CACX,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,4BAA4B,EAAE,4BAA4B,GACtE,OAAO,CAAC,MAAM,CAAC,OAAO,mBAAmB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;CAwClE"}

package/dist/namespaces/sub-organizations.js

@@ -119,6 +119,8 @@ export class SubOrganizations {
         };
         if (data.medias)
             payload.medias = data.medias;
+        if (data.referenceId !== undefined)
+            payload.reference_id = data.referenceId;
         return this.core.request({
             method: 'POST',
             path: `/v1/sdk/organizations/${orgId}/products`,

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.1.6",
+  "version": "1.1.9",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/src/core.ts

@@ -31,6 +31,8 @@ export interface ChargefyCoreOptions {
   serverURL?: string
   /** Request timeout in milliseconds. Default: 30000. */
   timeout?: number
+  /** Extra headers sent with every request (e.g. X-Chargefy-Source: embed). */
+  headers?: Record<string, string>
 }
 
 export type APIError =
@@ -63,6 +65,7 @@ export class ChargefyCore {
   readonly serverURL: string
   readonly accessToken: string | undefined
   readonly timeout: number
+  readonly headers: Record<string, string>
 
   constructor(options: ChargefyCoreOptions = {}) {
     if (options.serverURL) {
@@ -78,6 +81,7 @@ export class ChargefyCore {
     }
     this.accessToken = options.accessToken
     this.timeout = options.timeout ?? 30000
+    this.headers = options.headers ?? {}
   }
 
   async request<T>(options: RequestOptions): Promise<Result<T, APIError>> {
@@ -103,6 +107,7 @@ export class ChargefyCore {
     if (auth && this.accessToken) {
       headers['Authorization'] = `Bearer ${this.accessToken}`
     }
+    Object.assign(headers, this.headers)
 
     const controller = new AbortController()
     const timeoutId = setTimeout(() => controller.abort(), this.timeout)

package/src/models/checkoutLink.ts

@@ -9,6 +9,8 @@ export interface CheckoutLink {
   allowDiscountCodes: boolean
   isArchived: boolean
   metadata?: Record<string, unknown>
+  /** Optional price override in cents. When set, used instead of product price when buyer opens the link. */
+  customPriceAmount?: number | null
   createdAt: string
 }
 
@@ -20,6 +22,8 @@ export interface CreateCheckoutLinkRequest {
   successUrl?: string
   allowDiscountCodes?: boolean
   metadata?: Record<string, unknown>
+  /** Optional price override in cents. When set, buyers pay this amount instead of the product's default price. */
+  customPriceAmount?: number | null
 }
 
 export interface UpdateCheckoutLinkRequest {
@@ -27,4 +31,6 @@ export interface UpdateCheckoutLinkRequest {
   successUrl?: string
   allowDiscountCodes?: boolean
   metadata?: Record<string, unknown>
+  /** Optional price override in cents. When set, buyers pay this amount instead of the product's default price. Pass null to clear. */
+  customPriceAmount?: number | null
 }

package/src/models/product.ts

@@ -19,6 +19,8 @@ export interface Product {
   prices: ProductPrice[]
   createdAt: string
   metadata?: Record<string, unknown>
+  /** Customer-side product ID; unique per org; enables upsert and lookup */
+  referenceId?: string | null
 }
 
 export interface CreateProductRequest {
@@ -35,6 +37,8 @@ export interface CreateProductRequest {
     currency?: string
   }>
   metadata?: Record<string, unknown>
+  /** Customer-side product ID. When set, upserts: if exists for org, updates; else creates. */
+  referenceId?: string | null
 }
 
 export interface UpdateProductRequest {
@@ -43,4 +47,5 @@ export interface UpdateProductRequest {
   description?: string
   isArchived?: boolean
   metadata?: Record<string, unknown>
+  referenceId?: string | null
 }

package/src/models/sub-organization.ts

@@ -113,6 +113,8 @@ export interface CreateProductForChildRequest {
   >
   metadata?: Record<string, unknown>
   medias?: string[]
+  /** Customer-side product ID. When set, upserts: if exists for child org, updates; else creates. */
+  referenceId?: string | null
 }
 
 // ── Response ──────────────────────────────────────────────────────────────────

package/src/namespaces/checkoutLinks.ts

@@ -23,6 +23,13 @@ export class CheckoutLinks {
     })
   }
 
+  /** Get the shareable checkout URL for a checkout link. Convenience wrapper around get(). */
+  async getLink(id: string): Promise<Result<string, APIError>> {
+    const result = await this.get(id)
+    if (!result.ok) return result
+    return { ok: true, value: result.value.url }
+  }
+
   /** Create a new checkout link. */
   create(body: CreateCheckoutLinkRequest): Promise<Result<CheckoutLink, APIError>> {
     const payload: Record<string, unknown> = {
@@ -33,6 +40,7 @@ export class CheckoutLinks {
     if (body.successUrl !== undefined) payload.success_url = body.successUrl
     if (body.allowDiscountCodes !== undefined) payload.allow_discount_codes = body.allowDiscountCodes
     if (body.metadata !== undefined) payload.metadata = body.metadata
+    if (body.customPriceAmount !== undefined) payload.custom_price_amount = body.customPriceAmount
     return this.core.request<CheckoutLink>({
       method: 'POST',
       path: '/v1/checkout-links',
@@ -47,6 +55,7 @@ export class CheckoutLinks {
     if (rest.successUrl !== undefined) payload.success_url = rest.successUrl
     if (rest.allowDiscountCodes !== undefined) payload.allow_discount_codes = rest.allowDiscountCodes
     if (rest.metadata !== undefined) payload.metadata = rest.metadata
+    if (rest.customPriceAmount !== undefined) payload.custom_price_amount = rest.customPriceAmount
     return this.core.request<CheckoutLink>({
       method: 'PATCH',
       path: `/v1/checkout-links/${id}`,

package/src/namespaces/checkouts.ts

@@ -8,6 +8,8 @@ import type {
   ConfirmCheckoutRequest,
   GeneratePixRequest,
 } from '../models/checkout'
+import type { CheckoutUpdatePublic } from '../models/components/checkoutupdatepublic'
+import { transformToSnakeCase } from '../utils/transformers'
 
 export class Checkouts {
   constructor(private readonly core: ChargefyCore) {}
@@ -50,6 +52,20 @@ export class Checkouts {
     })
   }
 
+  /** Update customer info on an open checkout by client secret (public, no auth). */
+  updateByClientSecret(
+    clientSecret: string,
+    data: CheckoutUpdatePublic
+  ): Promise<Result<Checkout, APIError>> {
+    const payload = transformToSnakeCase(data) as Record<string, unknown>
+    return this.core.request<Checkout>({
+      method: 'PATCH',
+      path: `/v1/checkouts/client/${clientSecret}`,
+      body: payload,
+      auth: false,
+    })
+  }
+
   /** Update customer info on an open checkout. */
   update(body: UpdateCheckoutRequest): Promise<Result<Checkout, APIError>> {
     const { id, ...rest } = body

package/src/namespaces/products.ts

@@ -23,19 +23,21 @@ export class Products {
     })
   }
 
-  /** Create a new product. */
+  /** Create a new product. With referenceId, upserts if product exists for org. */
   create(body: CreateProductRequest): Promise<Result<Product, APIError>> {
-    const payload = {
+    const payload: Record<string, unknown> = {
       organization_id: body.organizationId,
       name: body.name,
       description: body.description,
       recurring_interval: body.recurringInterval,
       prices: body.prices.map((p) => ({
-        amount: p.amount,
-        currency: p.currency ?? 'BRL',
+        amount_type: 'fixed',
+        price_amount: p.amount,
+        price_currency: (p.currency ?? 'BRL').toLowerCase(),
       })),
       metadata: body.metadata,
     }
+    if (body.referenceId !== undefined) payload.reference_id = body.referenceId
     return this.core.request<Product>({
       method: 'POST',
       path: '/v1/products',
@@ -51,10 +53,23 @@ export class Products {
     if (rest.description !== undefined) payload.description = rest.description
     if (rest.isArchived !== undefined) payload.is_archived = rest.isArchived
     if (rest.metadata !== undefined) payload.metadata = rest.metadata
+    if (rest.referenceId !== undefined) payload.reference_id = rest.referenceId
     return this.core.request<Product>({
       method: 'PATCH',
       path: `/v1/products/${id}`,
       body: payload,
     })
   }
+
+  /** Get product by reference_id. OAT uses token's org; pass organizationId when using user auth. */
+  getByReferenceId(
+    referenceId: string,
+    organizationId?: string
+  ): Promise<Result<Product, APIError>> {
+    return this.core.request<Product>({
+      method: 'GET',
+      path: `/v1/products/by-reference/${encodeURIComponent(referenceId)}`,
+      query: organizationId ? { organization_id: organizationId } : undefined,
+    })
+  }
 }

package/src/namespaces/sub-organizations.ts

@@ -147,6 +147,7 @@ export class SubOrganizations {
       metadata: data.metadata ?? {},
     }
     if (data.medias) payload.medias = data.medias
+    if (data.referenceId !== undefined) payload.reference_id = data.referenceId
     return this.core.request({
       method: 'POST',
       path: `/v1/sdk/organizations/${orgId}/products`,