Bulk Invoicing

Create and send bulk invoices .

Creating and sending bulk an invoice

POST

https://merchant.seerbitapi.com/invoice/{{PUBLIC_KEY}}/bulk-requests

Request Sample

The code snippet below shows an example request for creating and sending bulk invoice

All body parameters are required

1curl --location 'https://merchant.seerbitapi.com/invoice/{{PUBLIC_KEY}}/bulk-requests' \
2 --header 'Authorization: Bearer {{TOKEN}}' \
3 --header 'Content-Type: application/json' \
4 --data-raw '
5 [
6   {
7     "orderNo": "AZPOP12929322",
8     "dueDate": "2025-03-19",
9     "currency": "NGN",
10     "customerEmail": "testtechblazer1@mailinator.com",
11     "invoiceItems": [
12        {
13           "itemName": "Air Pod 2",
14           "quantity": 1,
15           "rate": 5,
16           "tax": 1.5
17       },
18       {
19           "itemName": "Quest 1",
20           "quantity": 4,
21           "rate": 10,
22           "tax": 2.5
23       },
24       {
25           "itemName": "Earpod",
26           "quantity": 1,
27           "rate": 100,
28           "tax": 0.5
29       }
30     ]
31   },
32   {
33         "orderNo": "AZPOP12929323",
34         "dueDate": "2025-03-28",
35         "currency": "NGN",
36         "receiversName": "Frank John",
37         "customerEmail": "testtechblazer2@mailinator.com",
38         "invoiceItems": [
39           {
40             "itemName": "Power Bulb",
41             "quantity": 10,
42             "rate": 5,
43             "tax": 0.5
44           }
45        ]
46      }
47   ]'

1const axios = require('axios');
2
3const PUBLIC_KEY = 'YOUR_PUBLIC_KEY';
4const TOKEN = 'YOUR_BEARER_TOKEN';
5
6const url = `https://merchant.seerbitapi.com/invoice/${PUBLIC_KEY}/bulk-requests`;
7
8const payload = [
9  {
10    orderNo: "AZPOP12929322",
11    dueDate: "2025-03-19",
12    currency: "NGN",
13    customerEmail: "testtechblazer1@mailinator.com",
14    invoiceItems: [
15      {
16        itemName: "Air Pod 2",
17        quantity: 1,
18        rate: 5,
19        tax: 1.5
20      },
21      {
22        itemName: "Quest 1",
23        quantity: 4,
24        rate: 10,
25        tax: 2.5
26      },
27      {
28        itemName: "Earpod",
29        quantity: 1,
30        rate: 100,
31        tax: 0.5
32      }
33    ]
34  },
35  {
36    orderNo: "AZPOP12929323",
37    dueDate: "2025-03-28",
38    currency: "NGN",
39    receiversName: "Frank John",
40    customerEmail: "testtechblazer2@mailinator.com",
41    invoiceItems: [
42      {
43        itemName: "Power Bulb",
44        quantity: 10,
45        rate: 5,
46        tax: 0.5
47      }
48    ]
49  }
50];
51
52axios.post(url, payload, {
53  headers: {
54    Authorization: `Bearer ${TOKEN}`,
55    'Content-Type': 'application/json'
56  }
57})
58.then(response => {
59  console.log(response.data);
60})
61.catch(error => {
62  if (error.response) {
63    console.error(error.response.data);
64  } else {
65    console.error(error.message);
66  }
67});
68

1<?php
2
3$publicKey = 'YOUR_PUBLIC_KEY';
4$token = 'YOUR_BEARER_TOKEN';
5
6$url = "https://merchant.seerbitapi.com/invoice/{$publicKey}/bulk-requests";
7
8$payload = [
9    [
10        "orderNo" => "AZPOP12929322",
11        "dueDate" => "2025-03-19",
12        "currency" => "NGN",
13        "customerEmail" => "testtechblazer1@mailinator.com",
14        "invoiceItems" => [
15            [
16                "itemName" => "Air Pod 2",
17                "quantity" => 1,
18                "rate" => 5,
19                "tax" => 1.5
20            ],
21            [
22                "itemName" => "Quest 1",
23                "quantity" => 4,
24                "rate" => 10,
25                "tax" => 2.5
26            ],
27            [
28                "itemName" => "Earpod",
29                "quantity" => 1,
30                "rate" => 100,
31                "tax" => 0.5
32            ]
33        ]
34    ],
35    [
36        "orderNo" => "AZPOP12929323",
37        "dueDate" => "2025-03-28",
38        "currency" => "NGN",
39        "receiversName" => "Frank John",
40        "customerEmail" => "testtechblazer2@mailinator.com",
41        "invoiceItems" => [
42            [
43                "itemName" => "Power Bulb",
44                "quantity" => 10,
45                "rate" => 5,
46                "tax" => 0.5
47            ]
48        ]
49    ]
50];
51
52$ch = curl_init($url);
53
54curl_setopt_array($ch, [
55    CURLOPT_RETURNTRANSFER => true,
56    CURLOPT_POST => true,
57    CURLOPT_HTTPHEADER => [
58        "Authorization: Bearer {$token}",
59        "Content-Type: application/json"
60    ],
61    CURLOPT_POSTFIELDS => json_encode($payload)
62]);
63
64$response = curl_exec($ch);
65$error = curl_error($ch);
66
67curl_close($ch);
68
69if ($error) {
70    echo "cURL Error: " . $error;
71} else {
72    echo $response;
73}
74

Response Sample

The code snippet below shows an example response for creating and sending an invoice

1{
2    "message": "Invoice created successfully ",
3    "code": "00"
4}

Need something else?

If you have any questions or need general help, visit our support page

Signup for developer update

You can unsubscribe at any time. Read our privacy policy.

ON THIS PAGE

Create Bulk Invoice

INTEGRATION

PAYMENT FEATURES

AFTER PAYMENT

Bulk Invoicing

Creating and sending bulk an invoice

Request Sample

Response Sample