feat: add smart transfer preauthorization and payment functionalities

Author: m7ez1n

src/paymentsClient.ts

@@ -29,6 +29,11 @@ import {
   RetryAutomaticPixPaymentRequest,
   AutomaticPixPaymentListResponse,
   PaymentPixAutomaticFilters,
+  SmartTransferPreauthorization,
+  CreateSmartTransferPreauthorization,
+  SmartTransferPayment,
+  CreateSmartTransferPayment,
+  SmartTransferPreauthorizationsFilters,
 } from './types'
 
 /**
@@ -410,4 +415,55 @@ export class PluggyPaymentsClient extends BaseApi {
   async cancelAutomaticPixAuthorization(paymentRequestId: string): Promise<void> {
     await this.createPostRequest(`payments/requests/${paymentRequestId}/automatic-pix/cancel`)
   }
+
+  /**
+   * Fetch all smart transfer preauthorizations
+   * @param options SmartTransferPreauthorizationsFilters with page and pageSize
+   * @returns {PageResponse<SmartTransferPreauthorization>} paged response of smart transfer preauthorizations
+   */
+  async fetchSmartTransferPreauthorizations(
+    options: SmartTransferPreauthorizationsFilters = {}
+  ): Promise<PageResponse<SmartTransferPreauthorization>> {
+    return await this.createGetRequest('smart-transfers/preauthorizations', { ...options })
+  }
+
+  /**
+   * Creates a smart transfer preauthorization
+   * @param payload CreateSmartTransferPreauthorization
+   * @returns {SmartTransferPreauthorization} SmartTransferPreauthorization object
+   */
+  async createSmartTransferPreauthorization(
+    payload: CreateSmartTransferPreauthorization
+  ): Promise<SmartTransferPreauthorization> {
+    return await this.createPostRequest('smart-transfers/preauthorizations', null, payload)
+  }
+
+  /**
+   * Fetch a single smart transfer preauthorization
+   * @param id ID of the smart transfer preauthorization
+   * @returns {SmartTransferPreauthorization} SmartTransferPreauthorization object
+   */
+  async fetchSmartTransferPreauthorization(id: string): Promise<SmartTransferPreauthorization> {
+    return await this.createGetRequest(`smart-transfers/preauthorizations/${id}`)
+  }
+
+  /**
+   * Creates a smart transfer payment
+   * @param payload CreateSmartTransferPayment
+   * @returns {SmartTransferPayment} SmartTransferPayment object
+   */
+  async createSmartTransferPayment(
+    payload: CreateSmartTransferPayment
+  ): Promise<SmartTransferPayment> {
+    return await this.createPostRequest('smart-transfers/payments', null, payload)
+  }
+
+  /**
+   * Fetch a single smart transfer payment
+   * @param id ID of the smart transfer payment
+   * @returns {SmartTransferPayment} SmartTransferPayment object
+   */
+  async fetchSmartTransferPayment(id: string): Promise<SmartTransferPayment> {
+    return await this.createGetRequest(`smart-transfers/payments/${id}`)
+  }
 }

src/types/payments/index.ts

@@ -9,3 +9,4 @@ export * from './bulkPayment'
 export * from './paymentReceipt'
 export * from './schedulePayment'
 export * from './pixAutomatic'
+export * from './smartTransfers'

src/types/payments/paymentFilters.ts

@@ -9,3 +9,5 @@ export type PaymentRecipientsFilters = PageFilters
 export type PaymentCustomersFilters = PageFilters
 
 export type PaymentInstitutionsFilters = PageFilters & { name?: string }
+
+export type SmartTransferPreauthorizationsFilters = PageFilters

src/types/payments/smartTransfers.ts

@@ -0,0 +1,85 @@
+import { Connector } from '../connector'
+import { PaymentInstitution } from './paymentInstitution'
+import {
+  PaymentRecipient,
+  PaymentRecipientAccount,
+  PaymentRecipientBankAccountType,
+} from './paymentRecipient'
+import { Parameters } from '../item'
+
+export const SMART_TRANSFER_PREAUTHORIZATION_STATUS = [
+  'CREATED',
+  'COMPLETED',
+  'REVOKED',
+  'REJECTED',
+  'ERROR',
+] as const
+
+export type SmartTransferPreauthorizationStatus = typeof SMART_TRANSFER_PREAUTHORIZATION_STATUS[number]
+
+export const SMART_TRANSFER_PAYMENT_STATUS = [
+  'PAYMENT_REJECTED',
+  'ERROR',
+  'CANCELED',
+  'CONSENT_REJECTED',
+  'CONSENT_AUTHORIZED',
+  'PAYMENT_PENDING',
+  'PAYMENT_PARTIALLY_ACCEPTED',
+  'PAYMENT_SETTLEMENT_PROCESSING',
+  'PAYMENT_SETTLEMENT_DEBTOR_ACCOUNT',
+  'PAYMENT_COMPLETED',
+] as const
+
+export type SmartTransferPaymentStatus = typeof SMART_TRANSFER_PAYMENT_STATUS[number]
+
+export type SmartTransferRecipient = Pick<
+  PaymentRecipient,
+  'id' | 'name' | 'taxNumber' | 'isDefault' | 'paymentInstitution' | 'account'
+> & {
+  pixKey: string | null
+}
+
+export type SmartTransferPreauthorization = {
+  id: string
+  status: SmartTransferPreauthorizationStatus
+  consentUrl: string | null
+  clientPreauthorizationId: string | null
+  callbackUrls: {
+    success?: string
+    error?: string
+  } | null
+  recipients: SmartTransferRecipient[]
+  connector: Connector
+  createdAt: Date
+  updatedAt: Date
+}
+
+export type CreateSmartTransferPreauthorization = {
+  connectorId: number
+  parameters: Parameters
+  recipientIds: string[]
+  callbackUrls?: {
+    success?: string
+    error?: string
+  }
+}
+
+export type CreateSmartTransferPayment = {
+  preauthorizationId: string
+  recipientId: string
+  amount: number
+  description?: string
+  clientPaymentId?: string
+}
+
+export type SmartTransferPayment = {
+  id: string
+  preauthorizationId: string
+  status: SmartTransferPaymentStatus
+  amount: number
+  description: string | null
+  recipient: SmartTransferRecipient
+  createdAt: Date
+  updatedAt: Date
+  clientPaymentId: string | null
+}