Create new Invoice

POST

https://staginggateway.fintainium.com/gateway/createInvoice

The Create Invoice API allows your business to generate an Accounts Receivable (AR) invoice for a customer. Each invoice serves as a formal request for payment and can be tracked via Transaction records in Fintainium.

Key features:

Create invoices specifically for customer payment collection (AR).

Include critical invoice details: amount, currency, due date, and description.

Automatically generate a Transaction record for each invoice.

Attach optional metadata such as invoice numbers, purchase order references, or custom fields.

Integrates seamlessly with Initiate Payment to request or collect payments from customers.

Ideal for streamlining AR workflows, tracking outstanding invoices, and improving payment collection efficiency.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://staginggateway.fintainium.com/gateway/createInvoice' \
--header 'sessionKey: z4FEVD7d2SVGG0B8QF1rXUTMqzUDncOT' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessId": "3295462",
    "internalId": "110033",
    "createInvoice": [
        {
            "invoiceNumber": "ABCD-Test",
            "invoiceDate": "2024-12-18",
            "invoiceDueDate": "2024-12-28",
            "invoicePO": "",
            "emailAddress": "playpay-test13@yopmail.com",
            "term": "Net 30",
            "invoiceItems": [
                {
                    "itemId": "1122",
                    "name": "item name",
                    "serviceDate": "",
                    "description": "",
                    "quantity": "1.00",
                    "unitPrice": 4.00,
                    "classId": "",
                    "class": ""
                }
            ]
        }
    ]
}'

Response Example

[
    {
        "id": 4445368,
        "invoiceNumber": "ABCD-Test",
        "invoicePO": "",
        "totalTax": 0,
        "term": "Net 30",
        "shippingCharge": 0,
        "handlingCharge": 0,
        "totalAmount": 4,
        "revisedTotalAmount": 4,
        "subTotal": 4,
        "taxableSubTotal": 4,
        "effectiveSubTotal": 4,
        "finalAmount": 4,
        "balanceAmount": 0,
        "comment": "",
        "invoiceState": "DRAFT",
        "invoicePaymentStatus": "",
        "invoiceType": "RECEIVABLE",
        "paymentMethod": "",
        "source": "",
        "isArchive": false,
        "isDuplicate": true,
        "isCITFinanced": false,
        "isDiscountActive": false,
        "isWorkflowEnabled": "D",
        "duplicateInvoiceId": 4445362,
        "invoiceDate": "12/18/2024",
        "invoiceDueDate": "12/28/2024",
        "revisedInvoiceDueDate": "12/28/2024",
        "createdDate": "12/18/2024 12:31:48",
        "lastModifiedDate": "12/18/2024 12:31:48",
        "paymentAmount": 0,
        "creditMemoAmount": 0,
        "creditMemos": [],
        "isCustomerSelectCreditMemo": false,
        "paidAmount": 0,
        "lastPaymentDate": "",
        "processingDate": "",
        "customerVendorId": 4311893,
        "businessName": "Super Coffee Co.",
        "businessEmail": "tjx01@getnada.com",
        "businessAddress1": "47 W 13th St",
        "businessAddress2": "",
        "businessZipcode": "10011",
        "businessPhone": "1 416-447-7088",
        "businessCountryName": "United States",
        "businessStateName": "New York",
        "businessStateCode": "NY",
        "businessCityName": "New York",
        "isVcEnabled": "true",
        "discountState": "",
        "discountRate": 0,
        "discountAmount": 0,
        "isPremium": false,
        "isNone": false,
        "effectivePayDate": "",
        "discountBusinessId": 0,
        "sharedLink": "",
        "showResendButton": false,
        "emailAttachmentId": 0,
        "invoiceItems": [
            {
                "id": 4445369,
                "name": "item name",
                "serviceDate": "",
                "description": "",
                "lineNo": "",
                "quantity": 1,
                "unitPrice": 4,
                "subtotal": 4,
                "isTaxable": false,
                "taxPercent": 0,
                "taxName": "",
                "itemRefType": "ITEM",
                "itemMaster": {},
                "qbAccount": {},
                "itemDiscountAmount": 0,
                "classId": 0,
                "customerJob": "",
                "className": "",
                "salesTax": {},
                "accountTree": ""
            }
        ],
        "auditTrails": [],
        "discountAuditTrails": [],
        "salesTaxes": [],
        "emailAttachment": {},
        "customerVendor": {
            "id": 4311893,
            "companyName": "Test Customer 2",
            "taxNo": "",
            "firstName": "Test Customer",
            "lastName": "Test Customer",
            "emailAddress": "",
            "phoneNumber": "",
            "paymentMode": "ACH",
            "zipCode": "",
            "shipZipCode": "",
            "accountNumber": "",
            "businessId": 3295462,
            "businessName": "Super Coffee Co.",
            "countryCode": "",
            "shipCountryCode": "",
            "stateCode": "",
            "shipStateCode": "",
            "cityId": 0,
            "shipCityId": 0,
            "isInternational": false,
            "isCustomer": true,
            "isRegistered": false,
            "isVcEnabled": false,
            "isSyncEnabled": true,
            "status": true,
            "archive": false,
            "invitationSent": false,
            "isVisaEnabled": false,
            "isSameAsBillingAddress": true,
            "createdDate": "11/14/2024",
            "businessRefId": 4311890,
            "creditMemoAmount": 0,
            "creditMemoLastModifiedDate": "",
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "addressLine4": "",
            "addressLine5": "",
            "addressLine6": "",
            "shipAddressLine1": "",
            "shipAddressLine2": "",
            "shipAddressLine3": "",
            "shipAddressLine4": "",
            "shipAddressLine5": "",
            "shipAddressLine6": "",
            "printName": "",
            "internalId": "110033",
            "vendorName": "Test Customer 2",
            "cityName": "",
            "stateName": "",
            "shipCityName": "",
            "shipStateName": "",
            "lastModifiedDate": "12/18/2024",
            "isVendorJourney": false,
            "isNewlyAdded": true,
            "addCardDetails": false,
            "skipPasswordCreation": false,
            "isSubCustomer": false,
            "billWithParent": false,
            "parentCustomerName": "",
            "isSubCustomerExists": false,
            "wireAccountName": "Test Customer 2",
            "wireAddress": "",
            "wireAddress2": "",
            "wireZipCode": "",
            "autoPayEnabled": false,
            "maskTaxId": false,
            "phoneNumber1": "",
            "phoneNumber2": "",
            "phoneNumber3": "",
            "phoneNumber4": ""
        },
        "error": {},
        "auditTrailNote": "",
        "uploadType": "Bill",
        "emailCode": "",
        "isInvoiceLongPending": false,
        "isCaptured": false,
        "isLineItemTaxEnabled": false,
        "showDiscountFlag": true,
        "showDiscountNudgeVendorFlag": false,
        "reviewFlag": false,
        "isCheckImgAvailable": false,
        "checkNumber": "",
        "termId": 0,
        "termRequest": {},
        "invoiceUniqueNumber": "",
        "internalId": "",
        "taxName": "",
        "invoiceDiscountAmount": 0,
        "invoiceDiscountDescription": "",
        "isFileAttachmentAvailable": true,
        "fileAttachments": [
            {
                "id": 4445371,
                "fileName": "Invoice_ABCD-Test.pdf",
                "fileURL": "https://s3.us-west-2.amazonaws.com/stagingachprocess/INVOICE/Attachments/AR/1734543108616-Invoice_ABCD-Test.pdf",
                "documentFormat": "application/pdf",
                "documentType": "INVOICE",
                "createdDate": "12/18/2024",
                "isArchive": false,
                "isCheckPrint": false,
                "userId": 37177,
                "fileSize": 2228,
                "pageCount": 1,
                "isSendEmail": true,
                "createdDateAndTime": "12/18/2024 12:31:48"
            }
        ],
        "overdueBy": "",
        "transType": "",
        "isSyncError": false,
        "isOverdueFromOpen": true,
        "isQbUpdateReminder": false,
        "isPaymentMethodChange": false,
        "isSent": false,
        "isDash": false,
        "isPartialPaymentEnabled": false,
        "customField1": "",
        "customField2": "",
        "scheduledPaymentDate": "12/23/2024",
        "isTodayWeekendOrHoliday": false
    }
]

Modified at 2025-09-09 18:45:09

GET City List by State Name/ID/Code

Create new customer