API Reference
Log In
API Reference

Invoicing

Create, send, and track payment requests with Pandascrow’s programmable invoice infrastructure.

🧾 Invoice

The Invoice resource allows you to create, manage, and track payment requests through Pandascrow. Invoices give businesses, platforms, freelancers, and service providers a structured way to request payment while keeping every transaction traceable.

Invoices can be linked to escrow workflows, allowing funds to be collected securely and released according to the agreed transaction terms.


🔗 How It Works

  1. An invoice is created with the required payment details, including the amount, currency, description, and customer information.
  2. Pandascrow generates a unique invoice and payment reference.
  3. The invoice can be shared with the customer or embedded into your application or platform.
  4. Once payment is made, the invoice status and associated transaction are updated.
  5. Payment proceeds can then be used to fund an escrow transaction, transferred, or paid out according to your configured workflow.

💼 Use Cases

  • Businesses requesting payments from customers or clients.
  • Freelancers and consultants collecting payments for completed or ongoing work.
  • Marketplaces generating payment requests for buyers and sellers.
  • Agencies billing clients for projects, milestones, or services.
  • Platforms creating payment requests programmatically through the Pandascrow API.

✨ Features

  • Create invoices programmatically: Generate invoices directly from your application using the API.
  • Payment tracking: Monitor invoice status and payment activity.
  • Multi-currency support: Create invoices in supported currencies such as NGN and USD.
  • Unique references: Every invoice is assigned identifiers that make payments and reconciliation easier.
  • Escrow-ready payments: Use invoice payments to initiate or fund secure escrow transactions.
  • Transaction traceability: Connect invoices with their associated payment and transaction records.
  • Flexible metadata: Attach additional information to invoices for internal tracking and reconciliation.
  • Invoice retrieval: Fetch individual invoices or retrieve a list of invoices for an account.

🧾 Data You Can Attach

FieldDescription
invoice_idUnique identifier of the invoice
referenceUnique payment or invoice reference
amountAmount requested on the invoice
currencyCurrency of the invoice (e.g., NGN, USD)
statusCurrent invoice status
descriptionDescription or purpose of the payment
customerInformation identifying the customer or payer
payment_urlURL through which the customer can complete payment
metadataOptional JSON for attaching additional invoice information
created_atWhen the invoice was created
updated_atLast time the invoice was updated

🔌 API Endpoints

Create an Invoice

Create a new invoice and generate a payment request for a customer.

Create Invoice →


Fetch All Invoices

Retrieve invoices associated with your account.

Fetch All Invoices →


Fetch a Single Invoice

Retrieve the details of a specific invoice using its unique identifier.

Fetch Single Invoice →


🔐 Security & Controls

  • Authenticated API access ensures invoice operations are performed by authorized applications.
  • Unique references make invoice payments easier to verify and reconcile.
  • Transaction tracking provides visibility into the lifecycle of each payment.
  • KYC/Compliance requirements may apply depending on the account, transaction, currency, and applicable limits.
  • Escrow controls can be applied when invoice payments are used as part of an escrow workflow.

🚀
Invoices make payment collection simple and programmable. Create payment requests, track their status, and connect payments directly to Pandascrow’s escrow and transaction infrastructure.