Visa Acceptance

Instructions

Implementation Reference

• typescript/src/shared/invoices/sendInvoice.ts:29-55 (handler)

  The handler function that implements the core logic of the 'send_invoice' tool, sending the invoice via Cybersource REST API and masking customer info.

  export const sendInvoice = async (
    visaClient: any,
    context: VisaContext,
    params: z.infer<ReturnType<typeof sendInvoiceParameters>>
  ) => {
    try {
      const invoiceApiInstance = new cybersourceRestApi.InvoicesApi(visaClient.configuration, visaClient.visaApiClient);
      
      const result = await new Promise((resolve, reject) => {
        invoiceApiInstance.performSendAction(params.invoice_id, (error: any, data: any, response: any) => {
          if (error) {
            reject(error);
          } else {
            resolve({
              data,
              status: response['status']
            });
          }
        });
      });
      
      const maskedResult = maskInvoiceCustomerInfo(result);
      return maskedResult;
    } catch (error) {
      return 'Failed to send invoice';
    }
  };

• typescript/src/shared/invoices/sendInvoice.ts:17-23 (schema)

  Zod schema defining the input parameters for the send_invoice tool.

  export const sendInvoiceParameters = (
    context: VisaContext = {} as VisaContext
  ) => {
    return z.object({
      invoice_id: z.string().describe('Invoice ID (required)')
    });
  };

• typescript/src/shared/invoices/sendInvoice.ts:57-68 (registration)

  Definition of the tool object/module for 'send_invoice', which is exported as default and includes method name, description, parameters, and execute handler reference.

  const tool = (context: VisaContext): Tool => ({
    method: 'send_invoice',
    name: 'Send Invoice',
    description: sendInvoicePrompt(context),
    parameters: sendInvoiceParameters(context),
    actions: {
      invoices: {
        update: true,
      },
    },
    execute: sendInvoice,
  });

• typescript/src/shared/tools.ts:40-53 (registration)

  Registration of the send_invoice tool within the createTools function, which aggregates and returns all available tools including sendInvoiceToolModule(context).

  export function createTools(context: VisaContext): Tool[] {
    return [
      createInvoiceToolModule(context),
      updateInvoiceToolModule(context),
      getInvoiceToolModule(context),
      listInvoicesToolModule(context),
      sendInvoiceToolModule(context),
      cancelInvoiceToolModule(context),
      createPaymentLinkToolModule(context),
      updatePaymentLinkToolModule(context),
      getPaymentLinkToolModule(context),
      listPaymentLinkToolModule(context)
    ];
  }

• typescript/src/shared/invoices/sendInvoice.ts:25-27 (helper)

  Helper function generating the description/prompt for the send_invoice tool.

  export const sendInvoicePrompt = (context: VisaContext = {} as VisaContext) => `
  This tool will send an invoice to the customer from Visa Acceptance.
  `;