Payments

Overview

Use the mark as paid feature to manually update an invoice's payment status when you receive payment through channels not integrated with Vayu, such as wire transfers, checks, or external payment processors.

When to mark invoices as paid

Mark invoices as paid manually when:

• Wire transfers - Customer pays via bank transfer outside of Stripe or other integrated payment systems
• Check payments - Customer sends a physical check
• External payment processors - Payment is processed through a system not connected to Vayu
• Cash payments - Customer pays in cash (less common for B2B)
• Payment reconciliation - Correcting payment status after manual verification

Marking an invoice as paid

Through the UI

1. Navigate to Invoices
2. Locate the invoice you want to mark as paid
3. Click on the invoice to open the detail view
4. Click Mark as Paid
5. Confirm the action

The invoice status will update to Paid and the paid date will be recorded.

Through the API

Use the payment status endpoint to retrieve and verify invoice payment information:

GET /invoices/{invoiceId}/payment-status

The response includes:

• billingStatus for the current payment status
• amountDue for the outstanding amount
• amountPaid for the amount already paid
• total for the full invoice amount
• dueDate for the payment due date
• paidAt for when payment was received
• invoicePdfUrl for a link to the invoice PDF

Automatic payment status updates

When using integrated payment systems like Stripe, payment status updates automatically:

• Successful payments - Invoice status updates to Paid in Vayu automatically
• Failed payments - Surface in outstanding balances and AR workflows
• No manual intervention needed - Billing and finance teams see current payment state in real-time

This eliminates the need to manually mark invoices as paid when using integrated payment processors.

Payment tracking

Once marked as paid:

• The invoice appears in paid invoice filters
• The paid date is recorded for reporting
• Outstanding balance calculations exclude the invoice
• AR aging reports reflect the payment
• The invoice is locked from further editing

Best practices

• Verify payment receipt - Confirm funds are received before marking as paid
• Document payment method - Add notes about how payment was received
• Reconcile regularly - Match marked payments against bank deposits
• Use integrations when possible - Automated payment tracking reduces manual work and errors