Create Invoice

Creates a new invoice. The response includes a shareable invoiceUrl that can be sent to the payer to complete payment.

When to Use

▾

Use this endpoint when:

• Billing a customer for a one-off payment
• Sending a payment request by email or link instead of an in-app checkout

note

Set shouldSendEmail to true to have Revenue Monster email the invoice to the payer automatically.

How to Use

▾

Endpoint

POST/api/v3/invoice

1. Send the invoice details → receive the created invoice with its invoiceUrl
2. Share the invoiceUrl with the payer (or let RM email it)
3. The invoice stays PENDING until paid or expired

---

Request Parameters

▾

storeIdSTRINGrequired

Store ID

Example: 1608714483132458121

referenceIdSTRINGrequired

Merchant-defined unique reference ID

Example: my-order-001

merchantEmailSTRING

Email for payment notification to the merchant

Example: [email protected]

payerEmailSTRINGrequired

Email for payment notification to the payer

Example: [email protected]

payerNameSTRINGrequired

Payer name

Example: John Doe

emailSubjectSTRINGrequired

Subject line for the invoice email

Example: Your Invoice #001

shouldSendEmailBOOLEAN

Whether to send the invoice email to the payer

Example: true

expiryDateTimeSTRINGrequired

Invoice expiry date time (ISO 8601)

Example: 2026-05-21T08:02:00.000Z

amountNUMBERrequired

Invoice amount in cents (e.g. 100 = RM 1.00)

Example: 100

currencySTRINGrequired

Currency code

Example: MYR

descriptionSTRINGrequired

Invoice description

Example: Order #001

redirectUrlSTRING

URL to redirect the payer after payment

Example: https://example.com/success

remarksSTRING

Additional remarks

Response Parameters

▾

itemOBJECT

Created invoice object. See [Get Invoices](./get-invoices) for the full field list.

codeSTRING

Result code ("SUCCESS" on success).