Create Invoice

POST

https://api.tranzakt.finance/api/v1/invoices

Creates a new invoice with specified payer details and payment information.

Note: Amount and invoiceBeneficiaries are required if not already set on the collection.

Request

Header Params

Body Params application/json

Example

{
    "collectionId": "string",
    "title": "string",
    "payerName": "string",
    "payerEmail": "string",
    "payerPhoneNumber": "string",
    "billerMetaData": {
        "key1": "string"
    },
    "amount": 0,
    "callBackUrl": "string",
    "invoiceBeneficiaries": [
        {
            "linkedAccountId": "string",
            "amount": 0
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.tranzakt.finance/api/v1/invoices' \
--header 'x-api-key: Your secret key' \
--header 'Content-Type: application/json' \
--data '{
    "collectionId": "string",
    "title": "string",
    "payerName": "string",
    "payerEmail": "string",
    "payerPhoneNumber": "string",
    "billerMetaData": {
        "key1": "string"
    },
    "amount": 0,
    "callBackUrl": "string",
    "invoiceBeneficiaries": [
        {
            "linkedAccountId": "string",
            "amount": 0
        }
    ]
}'

Responses

🟢201Created

application/json

Bodyapplication/json

Examples

SuccessExceptionExceptionException

{
    "status": 200,
    "message": "Invoice created successfully",
    "data": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "title": "Invoice #123",
        "collectionName": "Q1 Sales Collection",
        "payerName": "John Doe",
        "payerEmail": "john@example.com",
        "payerPhoneNumber": "2348012345678",
        "billerName": "ABC Company",
        "billerAddress": "123 Business St",
        "billerEmail": "sales@example.com",
        "amount": 1000,
        "serviceCharge": 50,
        "vat": 75,
        "totalAmount": 1125,
        "settleableAmount": 1000,
        "status": "Unpaid",
        "serviceFeePayer": "Payer",
        "settlementFrequency": "Instant",
        "type": "Live",
        "paymentUrl": "https://payment.example.com/invoice/123e4567-e89b-12d3-a456-426614174000",
        "dateCreated": "2024-03-21T10:00:00Z",
        "dateModified": "2024-03-21T10:00:00Z",
        "billerMetaData": {
            "order-id": "12345"
        },
        "paymentDate": null,
        "paymentMethod": null,
        "invoiceBeneficiaries": null,
        "callBackUrl": "https://your-api.com/webhooks/tranzakt"
    }
}

Modified at 2026-08-11 21:13:45

Invoices

Get Invoice by ID