v1

latestOpenAPI 3.0.02026-07-1412068.2 KB

Invoices

Create Invoice

API to create and send an invoice to a customer via email.

post/invoices

Headers

Content-Typestring

Authorizationstring

Request body

amountnumber required

The invoice amount to be charged to the customer.

amount_currency'AED' | 'USD' | 'EUR' | 'GBP' | 'SAR' required

Currency code for the invoice amount. See examples for more details.

emailstring email required

The customer's email address where the invoice will be sent.

descriptionstring

A description of the invoice. This will appear on the invoice sent to the customer.

customer_type'individual' | 'business'

The type of customer receiving the invoice.

first_namestring

The first name of the customer.

last_namestring

The last name of the customer.

phone_numberstring

The customer's phone number.

vat_enabledboolean

Whether VAT should be applied and displayed on the invoice.

additional_headingstring

An optional heading that will appear as additional information on the invoice.

additional_detailsstring

Optional additional details or notes to include on the invoice.

additional_cc_emailsstring[]

A list of additional email addresses to CC when the invoice is sent.

include_external_idboolean

Whether to display the external ID on the invoice.

external_idstring

An external reference ID of your choice to associate with this invoice.

processing_fee_percentagenumber nullable

A processing fee percentage to be added on top of the invoice amount and charged to the customer.

processing_fee_amountnumber nullable

A fixed processing fee amount to be added on top of the invoice amount and charged to the customer.

Example request

{
  "amount": 123,
  "amount_currency": "AED",
  "email": "customer@example.com",
  "description": "Invoice for consulting services",
  "customer_type": "individual",
  "first_name": "John",
  "last_name": "Doe",
  "phone_number": "+971555512345",
  "vat_enabled": false,
  "additional_heading": "Payment Terms",
  "additional_details": "Please complete payment within 7 days.",
  "additional_cc_emails": [],
  "include_external_id": true,
  "external_id": "ORDER-98765",
  "processing_fee_percentage": null,
  "processing_fee_amount": null
}

Response

Successful response

idstring

The unique identifier of the created invoice.

status'outstanding' | 'paid' | 'cancelled'

The current status of the invoice.

amountnumber

The invoice amount.

amount_formattedstring

The invoice amount formatted with the currency code.

amount_currencystring

The currency code of the invoice amount.

descriptionstring

The description provided for the invoice.

external_idstring

The external reference ID associated with the invoice.

additional_headingstring

The additional heading displayed on the invoice.

additional_detailsstring

The additional details displayed on the invoice.

business_namestring nullable

The business name on the invoice, if applicable.

uae_tax_reference_numberstring nullable

The UAE tax reference number, if applicable.

addressstring nullable

The address associated with the invoice, if applicable.

citystring nullable

The city associated with the invoice, if applicable.

countrystring nullable

The country associated with the invoice, if applicable.

payment_urlstring

The URL where the customer can complete payment for this invoice.

invoice_pdf_urlstring nullable

The URL to download the invoice as a PDF, once generated.

paid_atstring nullable

The date and time the invoice was paid, if applicable.

created_atstring

The date the invoice was created.

Example response

{
  "id": "INV-A3B02CC00F",
  "status": "outstanding",
  "amount": 123,
  "amount_formatted": "AED 123.00",
  "amount_currency": "AED",
  "description": "Invoice for consulting services",
  "customer": {
    "name": "John Doe",
    "email": "customer@example.com",
    "phone": "+971555512345"
  },
  "external_id": "ORDER-98765",
  "additional_heading": "Payment Terms",
  "additional_details": "Please complete payment within 7 days.",
  "business_name": null,
  "uae_tax_reference_number": null,
  "address": null,
  "city": null,
  "country": null,
  "payment_url": "https://sandbox.dev.business.mamopay.com/pay/mamo-6112becefca9",
  "invoice_pdf_url": null,
  "paid_at": null,
  "created_at": "16 Apr, 2026"
}