Class: InvoiceProcessor

payment/InvoiceProcessor.InvoiceProcessor

A class that provides methods for working with invoices. It interacts with the Yagna API directly.

• create
• collectInvoices
• fetchSingleInvoice
• acceptInvoice
• acceptManyInvoices

▸ create(options?): Promise<InvoiceProcessor>

Creates an instance of InvoiceProcessor and connects to the Yagna API.

Promise<InvoiceProcessor>

src/payment/InvoiceProcessor.ts:36

▸ collectInvoices(«destructured»?): Promise<Invoice[]>

Collects invoices from the Yagna API until the limit is reached or there are no more invoices.

Promise<Invoice[]>

Example

const invoices = await invoiceProcessor.collectInvoices({
 after: new Date(Date.now() - 24 * 60 * 60 * 1000), // only collect invoices that were created in the last 24 hours
 limit: 100, // only collect 100 invoices max
 statuses: ["RECEIVED"], // only collect unpaid invoices
 providerIds: ["0x1234"], // only collect invoices from this provider
 minAmount: "0.1", // only collect invoices with an amount greater than or equal to 0.1 GLM
 maxAmount: "1", // only collect invoices with an amount less than or equal to 1 GLM
 providerWallets: ["0x1234"], // only collect invoices from this provider wallet
 paymentPlatforms: ["erc20-polygon-glm"], // only collect invoices from this payment platform
});

src/payment/InvoiceProcessor.ts:68

▸ fetchSingleInvoice(invoiceId): Promise<Invoice>

Fetches a single invoice from the Yagna API.

Promise<Invoice>

src/payment/InvoiceProcessor.ts:120

▸ acceptInvoice(«destructured»): Promise<InvoiceAcceptResult>

Creates an allocation for the exact amount of the invoice and accepts the invoice. If dryRun is true, no allocation will be created and the invoice will not be accepted.

Promise<InvoiceAcceptResult>

src/payment/InvoiceProcessor.ts:128

▸ acceptManyInvoices(«destructured»): Promise<InvoiceAcceptResult[]>

Creates an allocation for the exact amount of the invoices and accepts the invoices. Since the invoices can be from different payment platforms and payer addresses, multiple allocations might be created. If dryRun is true, no allocation will be created and the invoices will not be accepted. Please keep in mind that this method is not atomic, so if one of the invoices fails to be accepted, the others will still be accepted. This is a limitation of the Yagna API. Use the returned InvoiceAcceptResult to check which invoices were accepted successfully.

Promise<InvoiceAcceptResult[]>

src/payment/InvoiceProcessor.ts:193