@pague-dev/sdk-node 1.2.0 → 2.0.0

package/dist/index.cjs

@@ -223,9 +223,11 @@ function isValidWebhookEvent(event) {
 	if (typeof obj.data !== "object" || obj.data === null) return false;
 	return [
 		"payment_completed",
+		"payment_expired",
 		"refund_completed",
 		"withdrawal_completed",
-		"withdrawal_failed"
+		"withdrawal_failed",
+		"withdrawal_reversed"
 	].includes(obj.event);
 }
 /**

package/dist/index.d.cts

@@ -20,6 +20,7 @@ interface CompanyDetail {
 interface BalanceDetail {
   available: BalanceAmount;
   promotional: BalanceAmount;
+  held: BalanceAmount;
   total: BalanceAmount;
   currency: string;
   updatedAt: string;
@@ -384,7 +385,7 @@ declare class Pdev {
 /**
  * Available webhook event types
  */
-type WebhookEventType = 'payment_completed' | 'refund_completed' | 'withdrawal_completed' | 'withdrawal_failed';
+type WebhookEventType = 'payment_completed' | 'payment_expired' | 'refund_completed' | 'withdrawal_completed' | 'withdrawal_failed' | 'withdrawal_reversed';
 /**
  * Base webhook payload structure
  */
@@ -425,6 +426,33 @@ interface PaymentCompletedData {
   /** Custom metadata passed when creating the payment */
   metadata?: Record<string, unknown>;
 }
+/**
+ * Data payload for payment_expired event
+ */
+interface PaymentExpiredData {
+  /** Transaction identifier */
+  transactionId: string;
+  /** Environment where the transaction occurred */
+  environment: 'production' | 'sandbox';
+  /** Payment amount */
+  amount: number;
+  /** Platform fees (always 0 for expired payments) */
+  feeAmount: number;
+  /** Net amount (always 0 for expired payments) */
+  netAmount: number;
+  /** Currency code (e.g., "BRL") */
+  currency: string;
+  /** Payment method used (e.g., "pix") */
+  paymentMethod: string;
+  /** Payment status */
+  status: 'expired';
+  /** ISO 8601 timestamp of when payment expired */
+  expiredAt: string;
+  /** Your external reference ID (optional) */
+  externalReference?: string;
+  /** Custom metadata passed when creating the payment */
+  metadata?: Record<string, unknown>;
+}
 /**
  * Data payload for refund_completed event
  */
@@ -443,10 +471,14 @@ interface RefundCompletedData {
   netAmount: number;
   /** Currency code (e.g., "BRL") */
   currency: string;
+  /** Payment method of the original transaction */
+  paymentMethod: string;
   /** Refund status */
   status: 'completed';
   /** ISO 8601 timestamp of when refund was completed */
-  completedAt: string;
+  refundedAt: string;
+  /** Your external reference ID from the original payment (optional) */
+  externalReference?: string;
   /** Custom metadata from the original payment */
   metadata?: Record<string, unknown>;
 }
@@ -498,10 +530,43 @@ interface WithdrawalFailedData {
   /** Custom metadata from the withdrawal request */
   metadata?: Record<string, unknown>;
 }
+/**
+ * Data payload for withdrawal_reversed event
+ */
+interface WithdrawalReversedData {
+  /** Reversal transaction identifier */
+  reversalTransactionId: string;
+  /** Original withdrawal transaction ID that was reversed */
+  originalTransactionId: string;
+  /** Environment where the transaction occurred */
+  environment: 'production' | 'sandbox';
+  /** Reversal amount */
+  amount: number;
+  /** Fees charged for the reversal */
+  feeAmount: number;
+  /** Net amount after fees */
+  netAmount: number;
+  /** Currency code (e.g., "BRL") */
+  currency: string;
+  /** Payment method (e.g., "pix") */
+  paymentMethod: string;
+  /** Reversal status */
+  status: 'completed';
+  /** ISO 8601 timestamp of when withdrawal was reversed */
+  reversedAt: string;
+  /** Your external reference ID from the original withdrawal (optional) */
+  externalReference?: string;
+  /** Custom metadata from the original withdrawal */
+  metadata?: Record<string, unknown>;
+}
 /**
  * Payment completed webhook event
  */
 type PaymentCompletedEvent = WebhookPayload<'payment_completed', PaymentCompletedData>;
+/**
+ * Payment expired webhook event
+ */
+type PaymentExpiredEvent = WebhookPayload<'payment_expired', PaymentExpiredData>;
 /**
  * Refund completed webhook event
  */
@@ -514,10 +579,14 @@ type WithdrawalCompletedEvent = WebhookPayload<'withdrawal_completed', Withdrawa
  * Withdrawal failed webhook event
  */
 type WithdrawalFailedEvent = WebhookPayload<'withdrawal_failed', WithdrawalFailedData>;
+/**
+ * Withdrawal reversed webhook event
+ */
+type WithdrawalReversedEvent = WebhookPayload<'withdrawal_reversed', WithdrawalReversedData>;
 /**
  * Union type of all possible webhook events
  */
-type WebhookEvent = PaymentCompletedEvent | RefundCompletedEvent | WithdrawalCompletedEvent | WithdrawalFailedEvent;
+type WebhookEvent = PaymentCompletedEvent | PaymentExpiredEvent | RefundCompletedEvent | WithdrawalCompletedEvent | WithdrawalFailedEvent | WithdrawalReversedEvent;
 /**
  * Webhook headers sent with each request
  */
@@ -607,4 +676,4 @@ interface WebhookHeaders {
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 declare function parseWebhook(payload: string): WebhookEvent | null;
 //#endregion
-export { AccountDetail, AccountInfo, AccountStatus, BalanceAmount, BalanceDetail, Charge, ChargeStatus, CompanyDetail, CompanyStatus, CreateChargeOptions, CreateChargeResponse, CreateCustomerOptions, CreateCustomerResponse, CreatePixCustomer, CreatePixOptions, CreatePixResponse, CreateProjectOptions, CreateProjectResponse, CreateStaticQrCodeOptions, CreateStaticQrCodeResponse, CreateWithdrawalOptions, CreateWithdrawalResponse, Customer, DocumentType, type ErrorResponse, GetChargeResponse, GetTransactionResponse, ListChargesOptions, ListChargesResponse, ListCustomersOptions, ListCustomersResponse, ListProjectsOptions, ListProjectsResponse, NotificationType, type PaginatedResponse, type PaginationOptions, PaymentCompletedData, PaymentCompletedEvent, PaymentMethod, Pdev, PixCharge, PixKeyType, PixStatus, Project, RefundCompletedData, RefundCompletedEvent, type Response, SortBy, SortOrder, StaticQrCode, Transaction, TransactionPaymentMethod, TransactionStatus, TransactionType, WebhookEvent, WebhookEventType, WebhookHeaders, WebhookPayload, Withdrawal, WithdrawalCompletedData, WithdrawalCompletedEvent, WithdrawalFailedData, WithdrawalFailedEvent, WithdrawalStatus, parseWebhook, verifyWebhookSignature };
+export { AccountDetail, AccountInfo, AccountStatus, BalanceAmount, BalanceDetail, Charge, ChargeStatus, CompanyDetail, CompanyStatus, CreateChargeOptions, CreateChargeResponse, CreateCustomerOptions, CreateCustomerResponse, CreatePixCustomer, CreatePixOptions, CreatePixResponse, CreateProjectOptions, CreateProjectResponse, CreateStaticQrCodeOptions, CreateStaticQrCodeResponse, CreateWithdrawalOptions, CreateWithdrawalResponse, Customer, DocumentType, type ErrorResponse, GetChargeResponse, GetTransactionResponse, ListChargesOptions, ListChargesResponse, ListCustomersOptions, ListCustomersResponse, ListProjectsOptions, ListProjectsResponse, NotificationType, type PaginatedResponse, type PaginationOptions, PaymentCompletedData, PaymentCompletedEvent, PaymentExpiredData, PaymentExpiredEvent, PaymentMethod, Pdev, PixCharge, PixKeyType, PixStatus, Project, RefundCompletedData, RefundCompletedEvent, type Response, SortBy, SortOrder, StaticQrCode, Transaction, TransactionPaymentMethod, TransactionStatus, TransactionType, WebhookEvent, WebhookEventType, WebhookHeaders, WebhookPayload, Withdrawal, WithdrawalCompletedData, WithdrawalCompletedEvent, WithdrawalFailedData, WithdrawalFailedEvent, WithdrawalReversedData, WithdrawalReversedEvent, WithdrawalStatus, parseWebhook, verifyWebhookSignature };

package/dist/index.d.mts

@@ -20,6 +20,7 @@ interface CompanyDetail {
 interface BalanceDetail {
   available: BalanceAmount;
   promotional: BalanceAmount;
+  held: BalanceAmount;
   total: BalanceAmount;
   currency: string;
   updatedAt: string;
@@ -384,7 +385,7 @@ declare class Pdev {
 /**
  * Available webhook event types
  */
-type WebhookEventType = 'payment_completed' | 'refund_completed' | 'withdrawal_completed' | 'withdrawal_failed';
+type WebhookEventType = 'payment_completed' | 'payment_expired' | 'refund_completed' | 'withdrawal_completed' | 'withdrawal_failed' | 'withdrawal_reversed';
 /**
  * Base webhook payload structure
  */
@@ -425,6 +426,33 @@ interface PaymentCompletedData {
   /** Custom metadata passed when creating the payment */
   metadata?: Record<string, unknown>;
 }
+/**
+ * Data payload for payment_expired event
+ */
+interface PaymentExpiredData {
+  /** Transaction identifier */
+  transactionId: string;
+  /** Environment where the transaction occurred */
+  environment: 'production' | 'sandbox';
+  /** Payment amount */
+  amount: number;
+  /** Platform fees (always 0 for expired payments) */
+  feeAmount: number;
+  /** Net amount (always 0 for expired payments) */
+  netAmount: number;
+  /** Currency code (e.g., "BRL") */
+  currency: string;
+  /** Payment method used (e.g., "pix") */
+  paymentMethod: string;
+  /** Payment status */
+  status: 'expired';
+  /** ISO 8601 timestamp of when payment expired */
+  expiredAt: string;
+  /** Your external reference ID (optional) */
+  externalReference?: string;
+  /** Custom metadata passed when creating the payment */
+  metadata?: Record<string, unknown>;
+}
 /**
  * Data payload for refund_completed event
  */
@@ -443,10 +471,14 @@ interface RefundCompletedData {
   netAmount: number;
   /** Currency code (e.g., "BRL") */
   currency: string;
+  /** Payment method of the original transaction */
+  paymentMethod: string;
   /** Refund status */
   status: 'completed';
   /** ISO 8601 timestamp of when refund was completed */
-  completedAt: string;
+  refundedAt: string;
+  /** Your external reference ID from the original payment (optional) */
+  externalReference?: string;
   /** Custom metadata from the original payment */
   metadata?: Record<string, unknown>;
 }
@@ -498,10 +530,43 @@ interface WithdrawalFailedData {
   /** Custom metadata from the withdrawal request */
   metadata?: Record<string, unknown>;
 }
+/**
+ * Data payload for withdrawal_reversed event
+ */
+interface WithdrawalReversedData {
+  /** Reversal transaction identifier */
+  reversalTransactionId: string;
+  /** Original withdrawal transaction ID that was reversed */
+  originalTransactionId: string;
+  /** Environment where the transaction occurred */
+  environment: 'production' | 'sandbox';
+  /** Reversal amount */
+  amount: number;
+  /** Fees charged for the reversal */
+  feeAmount: number;
+  /** Net amount after fees */
+  netAmount: number;
+  /** Currency code (e.g., "BRL") */
+  currency: string;
+  /** Payment method (e.g., "pix") */
+  paymentMethod: string;
+  /** Reversal status */
+  status: 'completed';
+  /** ISO 8601 timestamp of when withdrawal was reversed */
+  reversedAt: string;
+  /** Your external reference ID from the original withdrawal (optional) */
+  externalReference?: string;
+  /** Custom metadata from the original withdrawal */
+  metadata?: Record<string, unknown>;
+}
 /**
  * Payment completed webhook event
  */
 type PaymentCompletedEvent = WebhookPayload<'payment_completed', PaymentCompletedData>;
+/**
+ * Payment expired webhook event
+ */
+type PaymentExpiredEvent = WebhookPayload<'payment_expired', PaymentExpiredData>;
 /**
  * Refund completed webhook event
  */
@@ -514,10 +579,14 @@ type WithdrawalCompletedEvent = WebhookPayload<'withdrawal_completed', Withdrawa
  * Withdrawal failed webhook event
  */
 type WithdrawalFailedEvent = WebhookPayload<'withdrawal_failed', WithdrawalFailedData>;
+/**
+ * Withdrawal reversed webhook event
+ */
+type WithdrawalReversedEvent = WebhookPayload<'withdrawal_reversed', WithdrawalReversedData>;
 /**
  * Union type of all possible webhook events
  */
-type WebhookEvent = PaymentCompletedEvent | RefundCompletedEvent | WithdrawalCompletedEvent | WithdrawalFailedEvent;
+type WebhookEvent = PaymentCompletedEvent | PaymentExpiredEvent | RefundCompletedEvent | WithdrawalCompletedEvent | WithdrawalFailedEvent | WithdrawalReversedEvent;
 /**
  * Webhook headers sent with each request
  */
@@ -607,4 +676,4 @@ interface WebhookHeaders {
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 declare function parseWebhook(payload: string): WebhookEvent | null;
 //#endregion
-export { AccountDetail, AccountInfo, AccountStatus, BalanceAmount, BalanceDetail, Charge, ChargeStatus, CompanyDetail, CompanyStatus, CreateChargeOptions, CreateChargeResponse, CreateCustomerOptions, CreateCustomerResponse, CreatePixCustomer, CreatePixOptions, CreatePixResponse, CreateProjectOptions, CreateProjectResponse, CreateStaticQrCodeOptions, CreateStaticQrCodeResponse, CreateWithdrawalOptions, CreateWithdrawalResponse, Customer, DocumentType, type ErrorResponse, GetChargeResponse, GetTransactionResponse, ListChargesOptions, ListChargesResponse, ListCustomersOptions, ListCustomersResponse, ListProjectsOptions, ListProjectsResponse, NotificationType, type PaginatedResponse, type PaginationOptions, PaymentCompletedData, PaymentCompletedEvent, PaymentMethod, Pdev, PixCharge, PixKeyType, PixStatus, Project, RefundCompletedData, RefundCompletedEvent, type Response, SortBy, SortOrder, StaticQrCode, Transaction, TransactionPaymentMethod, TransactionStatus, TransactionType, WebhookEvent, WebhookEventType, WebhookHeaders, WebhookPayload, Withdrawal, WithdrawalCompletedData, WithdrawalCompletedEvent, WithdrawalFailedData, WithdrawalFailedEvent, WithdrawalStatus, parseWebhook, verifyWebhookSignature };
+export { AccountDetail, AccountInfo, AccountStatus, BalanceAmount, BalanceDetail, Charge, ChargeStatus, CompanyDetail, CompanyStatus, CreateChargeOptions, CreateChargeResponse, CreateCustomerOptions, CreateCustomerResponse, CreatePixCustomer, CreatePixOptions, CreatePixResponse, CreateProjectOptions, CreateProjectResponse, CreateStaticQrCodeOptions, CreateStaticQrCodeResponse, CreateWithdrawalOptions, CreateWithdrawalResponse, Customer, DocumentType, type ErrorResponse, GetChargeResponse, GetTransactionResponse, ListChargesOptions, ListChargesResponse, ListCustomersOptions, ListCustomersResponse, ListProjectsOptions, ListProjectsResponse, NotificationType, type PaginatedResponse, type PaginationOptions, PaymentCompletedData, PaymentCompletedEvent, PaymentExpiredData, PaymentExpiredEvent, PaymentMethod, Pdev, PixCharge, PixKeyType, PixStatus, Project, RefundCompletedData, RefundCompletedEvent, type Response, SortBy, SortOrder, StaticQrCode, Transaction, TransactionPaymentMethod, TransactionStatus, TransactionType, WebhookEvent, WebhookEventType, WebhookHeaders, WebhookPayload, Withdrawal, WithdrawalCompletedData, WithdrawalCompletedEvent, WithdrawalFailedData, WithdrawalFailedEvent, WithdrawalReversedData, WithdrawalReversedEvent, WithdrawalStatus, parseWebhook, verifyWebhookSignature };

package/dist/index.mjs

@@ -223,9 +223,11 @@ function isValidWebhookEvent(event) {
 	if (typeof obj.data !== "object" || obj.data === null) return false;
 	return [
 		"payment_completed",
+		"payment_expired",
 		"refund_completed",
 		"withdrawal_completed",
-		"withdrawal_failed"
+		"withdrawal_failed",
+		"withdrawal_reversed"
 	].includes(obj.event);
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pague-dev/sdk-node",
-  "version": "1.2.0",
+  "version": "2.0.0",
   "description": "Node.js SDK for the pague.dev API",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",