@pague-dev/sdk-node 1.3.0 → 2.1.0

package/dist/index.cjs

@@ -226,7 +226,9 @@ function isValidWebhookEvent(event) {
 		"payment_expired",
 		"refund_completed",
 		"withdrawal_completed",
-		"withdrawal_failed"
+		"withdrawal_failed",
+		"withdrawal_reversed",
+		"balance_block_created"
 	].includes(obj.event);
 }
 /**

package/dist/index.d.cts

@@ -385,7 +385,7 @@ declare class Pdev {
 /**
  * Available webhook event types
  */
-type WebhookEventType = 'payment_completed' | 'payment_expired' | 'refund_completed' | 'withdrawal_completed' | 'withdrawal_failed';
+type WebhookEventType = 'payment_completed' | 'payment_expired' | 'refund_completed' | 'withdrawal_completed' | 'withdrawal_failed' | 'withdrawal_reversed' | 'balance_block_created';
 /**
  * Base webhook payload structure
  */
@@ -432,8 +432,14 @@ interface PaymentCompletedData {
 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") */
@@ -465,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>;
 }
@@ -520,6 +530,35 @@ 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
  */
@@ -540,10 +579,43 @@ 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>;
+/**
+ * Data payload for balance_block_created event
+ */
+interface BalanceBlockCreatedData {
+  /** Balance block identifier */
+  blockId: string;
+  /** Transaction ID of the blocked transaction */
+  transactionId: string;
+  /** Environment where the block was created */
+  environment: 'production' | 'sandbox';
+  /** Blocked amount in BRL */
+  amount: number;
+  /** Currency code (e.g., "BRL") */
+  currency: string;
+  /** Type of block (med, judicial, administrative) */
+  blockType: 'med' | 'judicial' | 'administrative';
+  /** Block reference number */
+  referenceNumber: string;
+  /** Reason for the block */
+  reason: string;
+  /** Block status */
+  status: 'awaiting_response';
+  /** ISO 8601 timestamp of when block was created */
+  createdAt: string;
+}
+/**
+ * Balance block created webhook event
+ */
+type BalanceBlockCreatedEvent = WebhookPayload<'balance_block_created', BalanceBlockCreatedData>;
 /**
  * Union type of all possible webhook events
  */
-type WebhookEvent = PaymentCompletedEvent | PaymentExpiredEvent | RefundCompletedEvent | WithdrawalCompletedEvent | WithdrawalFailedEvent;
+type WebhookEvent = PaymentCompletedEvent | PaymentExpiredEvent | RefundCompletedEvent | WithdrawalCompletedEvent | WithdrawalFailedEvent | WithdrawalReversedEvent | BalanceBlockCreatedEvent;
 /**
  * Webhook headers sent with each request
  */
@@ -633,4 +705,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, 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, WithdrawalStatus, parseWebhook, verifyWebhookSignature };
+export { AccountDetail, AccountInfo, AccountStatus, BalanceAmount, BalanceBlockCreatedData, BalanceBlockCreatedEvent, 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

@@ -385,7 +385,7 @@ declare class Pdev {
 /**
  * Available webhook event types
  */
-type WebhookEventType = 'payment_completed' | 'payment_expired' | 'refund_completed' | 'withdrawal_completed' | 'withdrawal_failed';
+type WebhookEventType = 'payment_completed' | 'payment_expired' | 'refund_completed' | 'withdrawal_completed' | 'withdrawal_failed' | 'withdrawal_reversed' | 'balance_block_created';
 /**
  * Base webhook payload structure
  */
@@ -432,8 +432,14 @@ interface PaymentCompletedData {
 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") */
@@ -465,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>;
 }
@@ -520,6 +530,35 @@ 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
  */
@@ -540,10 +579,43 @@ 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>;
+/**
+ * Data payload for balance_block_created event
+ */
+interface BalanceBlockCreatedData {
+  /** Balance block identifier */
+  blockId: string;
+  /** Transaction ID of the blocked transaction */
+  transactionId: string;
+  /** Environment where the block was created */
+  environment: 'production' | 'sandbox';
+  /** Blocked amount in BRL */
+  amount: number;
+  /** Currency code (e.g., "BRL") */
+  currency: string;
+  /** Type of block (med, judicial, administrative) */
+  blockType: 'med' | 'judicial' | 'administrative';
+  /** Block reference number */
+  referenceNumber: string;
+  /** Reason for the block */
+  reason: string;
+  /** Block status */
+  status: 'awaiting_response';
+  /** ISO 8601 timestamp of when block was created */
+  createdAt: string;
+}
+/**
+ * Balance block created webhook event
+ */
+type BalanceBlockCreatedEvent = WebhookPayload<'balance_block_created', BalanceBlockCreatedData>;
 /**
  * Union type of all possible webhook events
  */
-type WebhookEvent = PaymentCompletedEvent | PaymentExpiredEvent | RefundCompletedEvent | WithdrawalCompletedEvent | WithdrawalFailedEvent;
+type WebhookEvent = PaymentCompletedEvent | PaymentExpiredEvent | RefundCompletedEvent | WithdrawalCompletedEvent | WithdrawalFailedEvent | WithdrawalReversedEvent | BalanceBlockCreatedEvent;
 /**
  * Webhook headers sent with each request
  */
@@ -633,4 +705,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, 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, WithdrawalStatus, parseWebhook, verifyWebhookSignature };
+export { AccountDetail, AccountInfo, AccountStatus, BalanceAmount, BalanceBlockCreatedData, BalanceBlockCreatedEvent, 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

@@ -226,7 +226,9 @@ function isValidWebhookEvent(event) {
 		"payment_expired",
 		"refund_completed",
 		"withdrawal_completed",
-		"withdrawal_failed"
+		"withdrawal_failed",
+		"withdrawal_reversed",
+		"balance_block_created"
 	].includes(obj.event);
 }
 /**

package/package.json

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