Class PositivePayDecisionAdminService

constructor

• new PositivePayDecisionAdminService(
      args: {
          db: B2bDatabase;
          eventPublisher: CustomerEventPublisher;
          internalEventPublisher: Pick<InternalEventPublisher, "publishConfirmed">;
      },
  ): PositivePayDecisionAdminService

  Parameters

  • args: {
        db: B2bDatabase;
        eventPublisher: CustomerEventPublisher;
        internalEventPublisher: Pick<InternalEventPublisher, "publishConfirmed">;
    }

  Returns PositivePayDecisionAdminService

Staticinstance

confirmRequested

• confirmRequested(
      __namedParameters: {
          actor: { adminUserId: string; name: string };
          ids: string[];
      },
  ): Promise<
      | {
          ok: true;
          value: {
              confirmed: (
                  Omit<
                      {
                          addenda: string
                          | null;
                          amount: string;
                          bankAccountExternalId: string;
                          bankAccountId: number;
                          bankId: string;
                          companyDiscretionaryData: string | null;
                          companyId: string | null;
                          companyName: string | null;
                          createdAt: Date;
                          customerExternalId: string | null;
                          customerId: number | null;
                          decidedAt: Date | null;
                          decidedBy: string | null;
                          decidedByAdminUserId: string | null;
                          decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                          effectiveEntryDate: string | null;
                          entryDescription: string | null;
                          externalAccountNumber: string | null;
                          externalId: string;
                          fileExternalId: string | null;
                          fileId: number | null;
                          id: number;
                          identityExternalId: string | null;
                          identityId: number | null;
                          individualId: string | null;
                          ledgerAccountExternalId: string | null;
                          ledgerAccountId: number | null;
                          mismatchAt: Date | null;
                          organizationExternalId: string | null;
                          organizationId: number | null;
                          originatingAba: string | null;
                          originatorName: string | null;
                          postedOn: string;
                          presentedOn: string;
                          receiverName: string | null;
                          requestedAt: Date | null;
                          requestedDecision: "APPROVE" | "DENY" | null;
                          secCode: string | null;
                          settledAt: Date | null;
                          status: "PENDING" | "APPROVED" | "DENIED";
                          submittedAt: Date | null;
                          traceNumber: string | null;
                          transactionCode: string | null;
                          updatedAt: Date;
                          victorTraceId: string | null;
                          victorTransactionId: string;
                          virtualAccountExternalId: string | null;
                          virtualAccountId: number | null;
                          withdrawalExternalId: string | null;
                          withdrawalId: number | null;
                      },
                      | "id"
                      | "externalId"
                      | "organizationId"
                      | "customerId"
                      | "customerExternalId"
                      | "identityId"
                      | "identityExternalId"
                      | "organizationExternalId"
                      | "ledgerAccountId"
                      | "ledgerAccountExternalId"
                      | "bankAccountId"
                      | "bankAccountExternalId"
                      | "amount"
                      | "withdrawalId"
                      | "withdrawalExternalId"
                      | "virtualAccountId"
                      | "virtualAccountExternalId"
                      | "fileId"
                      | "fileExternalId",
                  > & {
                      amount: BigNumber;
                      decisionDeadline: Date;
                      entityId: string
                      | null;
                      fileId: string | null;
                      id: string;
                      identityId: string | null;
                      ledgerAccountId: string | null;
                      organizationId: string | null;
                      statusDescription: string;
                      victorAccountId: string;
                      victorAccountName: string;
                      virtualAccountId: string | null;
                      withdrawalId: string | null;
                  } & { customerId: string
                  | null }
              )[];
              skipped: string[];
              unfunded: string[];
          };
      }
      | { error: ServiceError; ok: false },
  >

  Parameters

  • __namedParameters: { actor: { adminUserId: string; name: string }; ids: string[] }

  Returns Promise<
      | {
          ok: true;
          value: {
              confirmed: (
                  Omit<
                      {
                          addenda: string
                          | null;
                          amount: string;
                          bankAccountExternalId: string;
                          bankAccountId: number;
                          bankId: string;
                          companyDiscretionaryData: string | null;
                          companyId: string | null;
                          companyName: string | null;
                          createdAt: Date;
                          customerExternalId: string | null;
                          customerId: number | null;
                          decidedAt: Date | null;
                          decidedBy: string | null;
                          decidedByAdminUserId: string | null;
                          decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                          effectiveEntryDate: string | null;
                          entryDescription: string | null;
                          externalAccountNumber: string | null;
                          externalId: string;
                          fileExternalId: string | null;
                          fileId: number | null;
                          id: number;
                          identityExternalId: string | null;
                          identityId: number | null;
                          individualId: string | null;
                          ledgerAccountExternalId: string | null;
                          ledgerAccountId: number | null;
                          mismatchAt: Date | null;
                          organizationExternalId: string | null;
                          organizationId: number | null;
                          originatingAba: string | null;
                          originatorName: string | null;
                          postedOn: string;
                          presentedOn: string;
                          receiverName: string | null;
                          requestedAt: Date | null;
                          requestedDecision: "APPROVE" | "DENY" | null;
                          secCode: string | null;
                          settledAt: Date | null;
                          status: "PENDING" | "APPROVED" | "DENIED";
                          submittedAt: Date | null;
                          traceNumber: string | null;
                          transactionCode: string | null;
                          updatedAt: Date;
                          victorTraceId: string | null;
                          victorTransactionId: string;
                          virtualAccountExternalId: string | null;
                          virtualAccountId: number | null;
                          withdrawalExternalId: string | null;
                          withdrawalId: number | null;
                      },
                      | "id"
                      | "externalId"
                      | "organizationId"
                      | "customerId"
                      | "customerExternalId"
                      | "identityId"
                      | "identityExternalId"
                      | "organizationExternalId"
                      | "ledgerAccountId"
                      | "ledgerAccountExternalId"
                      | "bankAccountId"
                      | "bankAccountExternalId"
                      | "amount"
                      | "withdrawalId"
                      | "withdrawalExternalId"
                      | "virtualAccountId"
                      | "virtualAccountExternalId"
                      | "fileId"
                      | "fileExternalId",
                  > & {
                      amount: BigNumber;
                      decisionDeadline: Date;
                      entityId: string
                      | null;
                      fileId: string | null;
                      id: string;
                      identityId: string | null;
                      ledgerAccountId: string | null;
                      organizationId: string | null;
                      statusDescription: string;
                      victorAccountId: string;
                      victorAccountName: string;
                      virtualAccountId: string | null;
                      withdrawalId: string | null;
                  } & { customerId: string
                  | null }
              )[];
              skipped: string[];
              unfunded: string[];
          };
      }
      | { error: ServiceError; ok: false },
  >

decide

• decide(
      __namedParameters: {
          actor: { adminUserId: string; name: string };
          decision: "APPROVED" | "DENIED";
          ids: string[];
      },
  ): Promise<
      | {
          ok: true;
          value: (
              Omit<
                  {
                      addenda: string
                      | null;
                      amount: string;
                      bankAccountExternalId: string;
                      bankAccountId: number;
                      bankId: string;
                      companyDiscretionaryData: string | null;
                      companyId: string | null;
                      companyName: string | null;
                      createdAt: Date;
                      customerExternalId: string | null;
                      customerId: number | null;
                      decidedAt: Date | null;
                      decidedBy: string | null;
                      decidedByAdminUserId: string | null;
                      decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                      effectiveEntryDate: string | null;
                      entryDescription: string | null;
                      externalAccountNumber: string | null;
                      externalId: string;
                      fileExternalId: string | null;
                      fileId: number | null;
                      id: number;
                      identityExternalId: string | null;
                      identityId: number | null;
                      individualId: string | null;
                      ledgerAccountExternalId: string | null;
                      ledgerAccountId: number | null;
                      mismatchAt: Date | null;
                      organizationExternalId: string | null;
                      organizationId: number | null;
                      originatingAba: string | null;
                      originatorName: string | null;
                      postedOn: string;
                      presentedOn: string;
                      receiverName: string | null;
                      requestedAt: Date | null;
                      requestedDecision: "APPROVE" | "DENY" | null;
                      secCode: string | null;
                      settledAt: Date | null;
                      status: "PENDING" | "APPROVED" | "DENIED";
                      submittedAt: Date | null;
                      traceNumber: string | null;
                      transactionCode: string | null;
                      updatedAt: Date;
                      victorTraceId: string | null;
                      victorTransactionId: string;
                      virtualAccountExternalId: string | null;
                      virtualAccountId: number | null;
                      withdrawalExternalId: string | null;
                      withdrawalId: number | null;
                  },
                  | "id"
                  | "externalId"
                  | "organizationId"
                  | "customerId"
                  | "customerExternalId"
                  | "identityId"
                  | "identityExternalId"
                  | "organizationExternalId"
                  | "ledgerAccountId"
                  | "ledgerAccountExternalId"
                  | "bankAccountId"
                  | "bankAccountExternalId"
                  | "amount"
                  | "withdrawalId"
                  | "withdrawalExternalId"
                  | "virtualAccountId"
                  | "virtualAccountExternalId"
                  | "fileId"
                  | "fileExternalId",
              > & {
                  amount: BigNumber;
                  decisionDeadline: Date;
                  entityId: string
                  | null;
                  fileId: string | null;
                  id: string;
                  identityId: string | null;
                  ledgerAccountId: string | null;
                  organizationId: string | null;
                  statusDescription: string;
                  victorAccountId: string;
                  victorAccountName: string;
                  virtualAccountId: string | null;
                  withdrawalId: string | null;
              } & { customerId: string
              | null }
          )[];
      }
      | { error: ServiceError; ok: false },
  >

  Parameters

  • __namedParameters: {
        actor: { adminUserId: string; name: string };
        decision: "APPROVED" | "DENIED";
        ids: string[];
    }

  Returns Promise<
      | {
          ok: true;
          value: (
              Omit<
                  {
                      addenda: string
                      | null;
                      amount: string;
                      bankAccountExternalId: string;
                      bankAccountId: number;
                      bankId: string;
                      companyDiscretionaryData: string | null;
                      companyId: string | null;
                      companyName: string | null;
                      createdAt: Date;
                      customerExternalId: string | null;
                      customerId: number | null;
                      decidedAt: Date | null;
                      decidedBy: string | null;
                      decidedByAdminUserId: string | null;
                      decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                      effectiveEntryDate: string | null;
                      entryDescription: string | null;
                      externalAccountNumber: string | null;
                      externalId: string;
                      fileExternalId: string | null;
                      fileId: number | null;
                      id: number;
                      identityExternalId: string | null;
                      identityId: number | null;
                      individualId: string | null;
                      ledgerAccountExternalId: string | null;
                      ledgerAccountId: number | null;
                      mismatchAt: Date | null;
                      organizationExternalId: string | null;
                      organizationId: number | null;
                      originatingAba: string | null;
                      originatorName: string | null;
                      postedOn: string;
                      presentedOn: string;
                      receiverName: string | null;
                      requestedAt: Date | null;
                      requestedDecision: "APPROVE" | "DENY" | null;
                      secCode: string | null;
                      settledAt: Date | null;
                      status: "PENDING" | "APPROVED" | "DENIED";
                      submittedAt: Date | null;
                      traceNumber: string | null;
                      transactionCode: string | null;
                      updatedAt: Date;
                      victorTraceId: string | null;
                      victorTransactionId: string;
                      virtualAccountExternalId: string | null;
                      virtualAccountId: number | null;
                      withdrawalExternalId: string | null;
                      withdrawalId: number | null;
                  },
                  | "id"
                  | "externalId"
                  | "organizationId"
                  | "customerId"
                  | "customerExternalId"
                  | "identityId"
                  | "identityExternalId"
                  | "organizationExternalId"
                  | "ledgerAccountId"
                  | "ledgerAccountExternalId"
                  | "bankAccountId"
                  | "bankAccountExternalId"
                  | "amount"
                  | "withdrawalId"
                  | "withdrawalExternalId"
                  | "virtualAccountId"
                  | "virtualAccountExternalId"
                  | "fileId"
                  | "fileExternalId",
              > & {
                  amount: BigNumber;
                  decisionDeadline: Date;
                  entityId: string
                  | null;
                  fileId: string | null;
                  id: string;
                  identityId: string | null;
                  ledgerAccountId: string | null;
                  organizationId: string | null;
                  statusDescription: string;
                  victorAccountId: string;
                  victorAccountName: string;
                  virtualAccountId: string | null;
                  withdrawalId: string | null;
              } & { customerId: string
              | null }
          )[];
      }
      | { error: ServiceError; ok: false },
  >

denyUnfunded

• denyUnfunded(
      match: { victorTransactionId: string } | { withdrawalId: string },
  ): Promise<
      {
          ok: true;
          value: (
              Omit<
                  {
                      addenda: string
                      | null;
                      amount: string;
                      bankAccountExternalId: string;
                      bankAccountId: number;
                      bankId: string;
                      companyDiscretionaryData: string | null;
                      companyId: string | null;
                      companyName: string | null;
                      createdAt: Date;
                      customerExternalId: string | null;
                      customerId: number | null;
                      decidedAt: Date | null;
                      decidedBy: string | null;
                      decidedByAdminUserId: string | null;
                      decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                      effectiveEntryDate: string | null;
                      entryDescription: string | null;
                      externalAccountNumber: string | null;
                      externalId: string;
                      fileExternalId: string | null;
                      fileId: number | null;
                      id: number;
                      identityExternalId: string | null;
                      identityId: number | null;
                      individualId: string | null;
                      ledgerAccountExternalId: string | null;
                      ledgerAccountId: number | null;
                      mismatchAt: Date | null;
                      organizationExternalId: string | null;
                      organizationId: number | null;
                      originatingAba: string | null;
                      originatorName: string | null;
                      postedOn: string;
                      presentedOn: string;
                      receiverName: string | null;
                      requestedAt: Date | null;
                      requestedDecision: "APPROVE" | "DENY" | null;
                      secCode: string | null;
                      settledAt: Date | null;
                      status: "PENDING" | "APPROVED" | "DENIED";
                      submittedAt: Date | null;
                      traceNumber: string | null;
                      transactionCode: string | null;
                      updatedAt: Date;
                      victorTraceId: string | null;
                      victorTransactionId: string;
                      virtualAccountExternalId: string | null;
                      virtualAccountId: number | null;
                      withdrawalExternalId: string | null;
                      withdrawalId: number | null;
                  },
                  | "id"
                  | "externalId"
                  | "organizationId"
                  | "customerId"
                  | "customerExternalId"
                  | "identityId"
                  | "identityExternalId"
                  | "organizationExternalId"
                  | "ledgerAccountId"
                  | "ledgerAccountExternalId"
                  | "bankAccountId"
                  | "bankAccountExternalId"
                  | "amount"
                  | "withdrawalId"
                  | "withdrawalExternalId"
                  | "virtualAccountId"
                  | "virtualAccountExternalId"
                  | "fileId"
                  | "fileExternalId",
              > & {
                  amount: BigNumber;
                  decisionDeadline: Date;
                  entityId: string
                  | null;
                  fileId: string | null;
                  id: string;
                  identityId: string | null;
                  ledgerAccountId: string | null;
                  organizationId: string | null;
                  statusDescription: string;
                  victorAccountId: string;
                  victorAccountName: string;
                  virtualAccountId: string | null;
                  withdrawalId: string | null;
              } & { customerId: string
              | null }
          )[];
      },
  >

  Denies a still-undecided debit nothing can fund any more, so the customer and ops see the outcome before the file does. A row the predicate spares is left alone. A retry publishes again, in case the first send failed.

  Parameters

  • match: { victorTransactionId: string } | { withdrawalId: string }

  Returns Promise<
      {
          ok: true;
          value: (
              Omit<
                  {
                      addenda: string
                      | null;
                      amount: string;
                      bankAccountExternalId: string;
                      bankAccountId: number;
                      bankId: string;
                      companyDiscretionaryData: string | null;
                      companyId: string | null;
                      companyName: string | null;
                      createdAt: Date;
                      customerExternalId: string | null;
                      customerId: number | null;
                      decidedAt: Date | null;
                      decidedBy: string | null;
                      decidedByAdminUserId: string | null;
                      decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                      effectiveEntryDate: string | null;
                      entryDescription: string | null;
                      externalAccountNumber: string | null;
                      externalId: string;
                      fileExternalId: string | null;
                      fileId: number | null;
                      id: number;
                      identityExternalId: string | null;
                      identityId: number | null;
                      individualId: string | null;
                      ledgerAccountExternalId: string | null;
                      ledgerAccountId: number | null;
                      mismatchAt: Date | null;
                      organizationExternalId: string | null;
                      organizationId: number | null;
                      originatingAba: string | null;
                      originatorName: string | null;
                      postedOn: string;
                      presentedOn: string;
                      receiverName: string | null;
                      requestedAt: Date | null;
                      requestedDecision: "APPROVE" | "DENY" | null;
                      secCode: string | null;
                      settledAt: Date | null;
                      status: "PENDING" | "APPROVED" | "DENIED";
                      submittedAt: Date | null;
                      traceNumber: string | null;
                      transactionCode: string | null;
                      updatedAt: Date;
                      victorTraceId: string | null;
                      victorTransactionId: string;
                      virtualAccountExternalId: string | null;
                      virtualAccountId: number | null;
                      withdrawalExternalId: string | null;
                      withdrawalId: number | null;
                  },
                  | "id"
                  | "externalId"
                  | "organizationId"
                  | "customerId"
                  | "customerExternalId"
                  | "identityId"
                  | "identityExternalId"
                  | "organizationExternalId"
                  | "ledgerAccountId"
                  | "ledgerAccountExternalId"
                  | "bankAccountId"
                  | "bankAccountExternalId"
                  | "amount"
                  | "withdrawalId"
                  | "withdrawalExternalId"
                  | "virtualAccountId"
                  | "virtualAccountExternalId"
                  | "fileId"
                  | "fileExternalId",
              > & {
                  amount: BigNumber;
                  decisionDeadline: Date;
                  entityId: string
                  | null;
                  fileId: string | null;
                  id: string;
                  identityId: string | null;
                  ledgerAccountId: string | null;
                  organizationId: string | null;
                  statusDescription: string;
                  victorAccountId: string;
                  victorAccountName: string;
                  virtualAccountId: string | null;
                  withdrawalId: string | null;
              } & { customerId: string
              | null }
          )[];
      },
  >

flagPaidWithoutFunds

• flagPaidWithoutFunds(
      __namedParameters: { withdrawalId: string },
  ): Promise<{ ok: true; value: string[] }>

  The withdrawal behind an APPROVED decision already filed as Pay was returned (e.g. a failed sweep), so the ledger no longer holds what the bank pays. Stamps mismatchAt once and returns the decisions newly flagged.

  Parameters

  • __namedParameters: { withdrawalId: string }

  Returns Promise<{ ok: true; value: string[] }>

linkWithdrawal

• linkWithdrawal(
      __namedParameters: { victorTransactionId: string; withdrawalId: string },
  ): Promise<{ ok: true; value: void }>

  Parameters

  • __namedParameters: { victorTransactionId: string; withdrawalId: string }

  Returns Promise<{ ok: true; value: void }>

recordPresented

• recordPresented(
      input: {
          accountNumber: string;
          addenda: string | null;
          amount: BigNumber;
          companyDiscretionaryData: string | null;
          companyId: string | null;
          companyName: string | null;
          createdAt: Date;
          effectiveEntryDate: string | null;
          entryDescription: string | null;
          externalAccountNumber: string | null;
          individualId: string | null;
          originatingAba: string | null;
          originatorName: string | null;
          receiverName: string | null;
          secCode: string | null;
          traceNumber: string | null;
          transactionCode: string | null;
          victorTraceId: string | null;
          victorTransactionId: string;
      },
  ): Promise<
      {
          ok: true;
          value: | Omit<
              {
                  addenda: string
                  | null;
                  amount: string;
                  bankAccountExternalId: string;
                  bankAccountId: number;
                  bankId: string;
                  companyDiscretionaryData: string | null;
                  companyId: string | null;
                  companyName: string | null;
                  createdAt: Date;
                  customerExternalId: string | null;
                  customerId: number | null;
                  decidedAt: Date | null;
                  decidedBy: string | null;
                  decidedByAdminUserId: string | null;
                  decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                  effectiveEntryDate: string | null;
                  entryDescription: string | null;
                  externalAccountNumber: string | null;
                  externalId: string;
                  fileExternalId: string | null;
                  fileId: number | null;
                  id: number;
                  identityExternalId: string | null;
                  identityId: number | null;
                  individualId: string | null;
                  ledgerAccountExternalId: string | null;
                  ledgerAccountId: number | null;
                  mismatchAt: Date | null;
                  organizationExternalId: string | null;
                  organizationId: number | null;
                  originatingAba: string | null;
                  originatorName: string | null;
                  postedOn: string;
                  presentedOn: string;
                  receiverName: string | null;
                  requestedAt: Date | null;
                  requestedDecision: "APPROVE" | "DENY" | null;
                  secCode: string | null;
                  settledAt: Date | null;
                  status: "PENDING" | "APPROVED" | "DENIED";
                  submittedAt: Date | null;
                  traceNumber: string | null;
                  transactionCode: string | null;
                  updatedAt: Date;
                  victorTraceId: string | null;
                  victorTransactionId: string;
                  virtualAccountExternalId: string | null;
                  virtualAccountId: number | null;
                  withdrawalExternalId: string | null;
                  withdrawalId: number | null;
              },
              | "id"
              | "externalId"
              | "organizationId"
              | "customerId"
              | "customerExternalId"
              | "identityId"
              | "identityExternalId"
              | "organizationExternalId"
              | "ledgerAccountId"
              | "ledgerAccountExternalId"
              | "bankAccountId"
              | "bankAccountExternalId"
              | "amount"
              | "withdrawalId"
              | "withdrawalExternalId"
              | "virtualAccountId"
              | "virtualAccountExternalId"
              | "fileId"
              | "fileExternalId",
          > & {
              amount: BigNumber;
              decisionDeadline: Date;
              entityId: string
              | null;
              fileId: string | null;
              id: string;
              identityId: string | null;
              ledgerAccountId: string | null;
              organizationId: string | null;
              statusDescription: string;
              victorAccountId: string;
              victorAccountName: string;
              virtualAccountId: string | null;
              withdrawalId: string | null;
          } & { customerId: string
          | null }
          | null;
      },
  >

  Records a debit Victor reported Pending. Returns null for an account CFX does not hold. Upserts on the Victor transaction id, so a redelivery that corrects the DDA or the amount lands while the row is still undecided.

  Parameters

  • input: {
        accountNumber: string;
        addenda: string | null;
        amount: BigNumber;
        companyDiscretionaryData: string | null;
        companyId: string | null;
        companyName: string | null;
        createdAt: Date;
        effectiveEntryDate: string | null;
        entryDescription: string | null;
        externalAccountNumber: string | null;
        individualId: string | null;
        originatingAba: string | null;
        originatorName: string | null;
        receiverName: string | null;
        secCode: string | null;
        traceNumber: string | null;
        transactionCode: string | null;
        victorTraceId: string | null;
        victorTransactionId: string;
    }

  Returns Promise<
      {
          ok: true;
          value: | Omit<
              {
                  addenda: string
                  | null;
                  amount: string;
                  bankAccountExternalId: string;
                  bankAccountId: number;
                  bankId: string;
                  companyDiscretionaryData: string | null;
                  companyId: string | null;
                  companyName: string | null;
                  createdAt: Date;
                  customerExternalId: string | null;
                  customerId: number | null;
                  decidedAt: Date | null;
                  decidedBy: string | null;
                  decidedByAdminUserId: string | null;
                  decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                  effectiveEntryDate: string | null;
                  entryDescription: string | null;
                  externalAccountNumber: string | null;
                  externalId: string;
                  fileExternalId: string | null;
                  fileId: number | null;
                  id: number;
                  identityExternalId: string | null;
                  identityId: number | null;
                  individualId: string | null;
                  ledgerAccountExternalId: string | null;
                  ledgerAccountId: number | null;
                  mismatchAt: Date | null;
                  organizationExternalId: string | null;
                  organizationId: number | null;
                  originatingAba: string | null;
                  originatorName: string | null;
                  postedOn: string;
                  presentedOn: string;
                  receiverName: string | null;
                  requestedAt: Date | null;
                  requestedDecision: "APPROVE" | "DENY" | null;
                  secCode: string | null;
                  settledAt: Date | null;
                  status: "PENDING" | "APPROVED" | "DENIED";
                  submittedAt: Date | null;
                  traceNumber: string | null;
                  transactionCode: string | null;
                  updatedAt: Date;
                  victorTraceId: string | null;
                  victorTransactionId: string;
                  virtualAccountExternalId: string | null;
                  virtualAccountId: number | null;
                  withdrawalExternalId: string | null;
                  withdrawalId: number | null;
              },
              | "id"
              | "externalId"
              | "organizationId"
              | "customerId"
              | "customerExternalId"
              | "identityId"
              | "identityExternalId"
              | "organizationExternalId"
              | "ledgerAccountId"
              | "ledgerAccountExternalId"
              | "bankAccountId"
              | "bankAccountExternalId"
              | "amount"
              | "withdrawalId"
              | "withdrawalExternalId"
              | "virtualAccountId"
              | "virtualAccountExternalId"
              | "fileId"
              | "fileExternalId",
          > & {
              amount: BigNumber;
              decisionDeadline: Date;
              entityId: string
              | null;
              fileId: string | null;
              id: string;
              identityId: string | null;
              ledgerAccountId: string | null;
              organizationId: string | null;
              statusDescription: string;
              victorAccountId: string;
              victorAccountName: string;
              virtualAccountId: string | null;
              withdrawalId: string | null;
          } & { customerId: string
          | null }
          | null;
      },
  >

recordSettled

• recordSettled(
      __namedParameters: { settledAt: Date; victorTransactionId: string },
  ): Promise<
      {
          ok: true;
          value: | {
              decision: Omit<
                  {
                      addenda: string
                      | null;
                      amount: string;
                      bankAccountExternalId: string;
                      bankAccountId: number;
                      bankId: string;
                      companyDiscretionaryData: string | null;
                      companyId: string | null;
                      companyName: string | null;
                      createdAt: Date;
                      customerExternalId: string | null;
                      customerId: number | null;
                      decidedAt: Date | null;
                      decidedBy: string | null;
                      decidedByAdminUserId: string | null;
                      decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                      effectiveEntryDate: string | null;
                      entryDescription: string | null;
                      externalAccountNumber: string | null;
                      externalId: string;
                      fileExternalId: string | null;
                      fileId: number | null;
                      id: number;
                      identityExternalId: string | null;
                      identityId: number | null;
                      individualId: string | null;
                      ledgerAccountExternalId: string | null;
                      ledgerAccountId: number | null;
                      mismatchAt: Date | null;
                      organizationExternalId: string | null;
                      organizationId: number | null;
                      originatingAba: string | null;
                      originatorName: string | null;
                      postedOn: string;
                      presentedOn: string;
                      receiverName: string | null;
                      requestedAt: Date | null;
                      requestedDecision: "APPROVE" | "DENY" | null;
                      secCode: string | null;
                      settledAt: Date | null;
                      status: "PENDING" | "APPROVED" | "DENIED";
                      submittedAt: Date | null;
                      traceNumber: string | null;
                      transactionCode: string | null;
                      updatedAt: Date;
                      victorTraceId: string | null;
                      victorTransactionId: string;
                      virtualAccountExternalId: string | null;
                      virtualAccountId: number | null;
                      withdrawalExternalId: string | null;
                      withdrawalId: number | null;
                  },
                  | "id"
                  | "externalId"
                  | "organizationId"
                  | "customerId"
                  | "customerExternalId"
                  | "identityId"
                  | "identityExternalId"
                  | "organizationExternalId"
                  | "ledgerAccountId"
                  | "ledgerAccountExternalId"
                  | "bankAccountId"
                  | "bankAccountExternalId"
                  | "amount"
                  | "withdrawalId"
                  | "withdrawalExternalId"
                  | "virtualAccountId"
                  | "virtualAccountExternalId"
                  | "fileId"
                  | "fileExternalId",
              > & {
                  amount: BigNumber;
                  decisionDeadline: Date;
                  entityId: string
                  | null;
                  fileId: string | null;
                  id: string;
                  identityId: string | null;
                  ledgerAccountId: string | null;
                  organizationId: string | null;
                  statusDescription: string;
                  victorAccountId: string;
                  victorAccountName: string;
                  virtualAccountId: string | null;
                  withdrawalId: string | null;
              } & { customerId: string
              | null };
              mismatch: boolean;
          }
          | null;
      },
  >

  A Success webhook. Only a DENIED decision can mismatch: CFX told the bank to return the debit and refunded the ledger, yet the money moved. A PENDING row has refunded nothing — during rollout ops decides in Dart's portal and the platform row stays PENDING on every legitimately-paid item.

  Idempotent: a redelivery must not walk settled_at forward or re-log.

  Parameters

  • __namedParameters: { settledAt: Date; victorTransactionId: string }

  Returns Promise<
      {
          ok: true;
          value: | {
              decision: Omit<
                  {
                      addenda: string
                      | null;
                      amount: string;
                      bankAccountExternalId: string;
                      bankAccountId: number;
                      bankId: string;
                      companyDiscretionaryData: string | null;
                      companyId: string | null;
                      companyName: string | null;
                      createdAt: Date;
                      customerExternalId: string | null;
                      customerId: number | null;
                      decidedAt: Date | null;
                      decidedBy: string | null;
                      decidedByAdminUserId: string | null;
                      decisionSource: "ADMIN" | "DEFAULT" | "UNFUNDED" | null;
                      effectiveEntryDate: string | null;
                      entryDescription: string | null;
                      externalAccountNumber: string | null;
                      externalId: string;
                      fileExternalId: string | null;
                      fileId: number | null;
                      id: number;
                      identityExternalId: string | null;
                      identityId: number | null;
                      individualId: string | null;
                      ledgerAccountExternalId: string | null;
                      ledgerAccountId: number | null;
                      mismatchAt: Date | null;
                      organizationExternalId: string | null;
                      organizationId: number | null;
                      originatingAba: string | null;
                      originatorName: string | null;
                      postedOn: string;
                      presentedOn: string;
                      receiverName: string | null;
                      requestedAt: Date | null;
                      requestedDecision: "APPROVE" | "DENY" | null;
                      secCode: string | null;
                      settledAt: Date | null;
                      status: "PENDING" | "APPROVED" | "DENIED";
                      submittedAt: Date | null;
                      traceNumber: string | null;
                      transactionCode: string | null;
                      updatedAt: Date;
                      victorTraceId: string | null;
                      victorTransactionId: string;
                      virtualAccountExternalId: string | null;
                      virtualAccountId: number | null;
                      withdrawalExternalId: string | null;
                      withdrawalId: number | null;
                  },
                  | "id"
                  | "externalId"
                  | "organizationId"
                  | "customerId"
                  | "customerExternalId"
                  | "identityId"
                  | "identityExternalId"
                  | "organizationExternalId"
                  | "ledgerAccountId"
                  | "ledgerAccountExternalId"
                  | "bankAccountId"
                  | "bankAccountExternalId"
                  | "amount"
                  | "withdrawalId"
                  | "withdrawalExternalId"
                  | "virtualAccountId"
                  | "virtualAccountExternalId"
                  | "fileId"
                  | "fileExternalId",
              > & {
                  amount: BigNumber;
                  decisionDeadline: Date;
                  entityId: string
                  | null;
                  fileId: string | null;
                  id: string;
                  identityId: string | null;
                  ledgerAccountId: string | null;
                  organizationId: string | null;
                  statusDescription: string;
                  victorAccountId: string;
                  victorAccountName: string;
                  virtualAccountId: string | null;
                  withdrawalId: string | null;
              } & { customerId: string
              | null };
              mismatch: boolean;
          }
          | null;
      },
  >