Back to home
INTEGRATION
PAYMENT FEATURES
AFTER PAYMENT
Invoicing
Create and send invoices without code on the merchant dashboard or use the invoicing API below to advance and automate how you collect payments from your customers.
Creating and sending an invoice
For the full specification, see our API Reference
POST
https://seerbitapi.com/invoice/create
Request Sample
The code snippet below shows an example request for creating and sending an invoice
All body parameters are required
1curl --location 'https://seerbitapi.com/create' \
2--header 'Content-Type: application/json' \
3--header 'Authorization: Bearer YOUR_ENCRYPTED_KEY' \
4--data-raw '{
5 "publicKey":"YOUR_PUBLIC_KEY",
6 "orderNo": "333333221321",
7 "dueDate": "2022-10-23",
8 "currency": "NGN",
9 "receiversName": "Jane Smith",
10 "customerEmail": "janesmith@emaildomain.com",
11 "invoiceItems": [
12 {
13 "itemName": "Bluetooth Pods",
14 "quantity": 1,
15 "rate": 25000,
16 "tax": 7.5
17 },
18 {
19 "itemName": "Quest 10",
20 "quantity": 4,
21 "rate": 100000,
22 "tax": 7.5
23 }
24 ]
25}'1var request = require('request');
2var options = {
3 'method': 'POST',
4 'url': 'https://seerbitapi.com/create',
5 'headers': {
6 'Content-Type': 'application/json',
7 'Authorization': 'Bearer YOUR_ENCRYPTED_KEY'
8 },
9 body: JSON.stringify({
10 "publicKey": "YOUR_PUBLIC_KEY",
11 "orderNo": "333333221321",
12 "dueDate": "2022-10-23",
13 "currency": "NGN",
14 "receiversName": "Jane Smith",
15 "customerEmail": "janesmith@emaildomain.com",
16 "invoiceItems": [
17 {
18 "itemName": "Bluetooth Pods",
19 "quantity": 1,
20 "rate": 25000,
21 "tax": 7.5
22 },
23 {
24 "itemName": "Quest 10",
25 "quantity": 4,
26 "rate": 100000,
27 "tax": 7.5
28 }
29 ]
30 })
31
32};
33request(options, function (error, response) {
34 if (error) throw new Error(error);
35 console.log(response.body);
36});1<?php
2
3$curl = curl_init();
4
5curl_setopt_array($curl, array(
6 CURLOPT_URL => 'https://seerbitapi.com/create',
7 CURLOPT_RETURNTRANSFER => true,
8 CURLOPT_ENCODING => '',
9 CURLOPT_MAXREDIRS => 10,
10 CURLOPT_TIMEOUT => 0,
11 CURLOPT_FOLLOWLOCATION => true,
12 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
13 CURLOPT_CUSTOMREQUEST => 'POST',
14 CURLOPT_POSTFIELDS =>'{
15 "publicKey":"YOUR_PUBLIC_KEY",
16 "orderNo": "333333221321",
17 "dueDate": "2022-10-23",
18 "currency": "NGN",
19 "receiversName": "Jane Smith",
20 "customerEmail": "janesmith@emaildomain.com",
21 "invoiceItems": [
22 {
23 "itemName": "Bluetooth Pods",
24 "quantity": 1,
25 "rate": 25000,
26 "tax": 7.5
27 },
28 {
29 "itemName": "Quest 10",
30 "quantity": 4,
31 "rate": 100000,
32 "tax": 7.5
33 }
34 ]
35}',
36 CURLOPT_HTTPHEADER => array(
37 'Content-Type: application/json',
38 'Authorization: Bearer YOUR_ENCRYPTED_KEY'
39 ),
40));
41
42$response = curl_exec($curl);
43
44curl_close($curl);
45echo $response;Response Sample
The code snippet below shows an example response for creating and sending an invoice
1{
2 "message": "Invoice created successfully ",
3 "payload": {
4 "InvoiceID": 92,
5 "InvoiceNo": "SBT-INV-000092"
6 },
7 "code": "00"
8}Re-send an Invoice
For the full specification, see our API Reference
GET
https://seerbitapi.com/invoice/{{publicKey}}/send/{{InvoiceNo}}
Response Sample
The code snippet below shows an example response to resend an invoice
1{
2 "message": "Invoice has been sent successfully",
3 "code": "00"
4}Get invoice by customer email
For the full specification, see our API Reference
GET
https://seerbitapi.com/invoice/{{publicKey}}/customer/{{customerEmail}}
Response Sample
The code snippet below shows an example response to get invoice by customer email
1{
2 "payload": [
3 {
4 "invoiceId": 66,
5 "invoiceNo": "SBT-INV-000066",
6 "totalAmount": 529.75,
7 "subTotal": 500.00,
8 "tax": 29.75,
9 "dueDate": "2022-10-22",
10 "currency": "NGN",
11 "invoiceItems": [
12 {
13 "itemName": "Bag",
14 "unitPrice": 100,
15 "vat": 5.95,
16 "amount": 100,
17 "quantity": 4
18 },
19 {
20 "itemName": "Bag",
21 "unitPrice": 400,
22 "vat": 23.80,
23 "amount": 400,
24 "quantity": 4
25 }
26 ],
27 "customer": {
28 "externalIdentify": "289276",
29 "businessName": "Jane Smith Ent",
30 "customerName": "Jane Smith",
31 "customerEmail": "js@emaildomian.com",
32 "businessId": "00000051",
33 "id": 19
34 },
35 "billingCycle": false,
36 "payButtonOnInvoices": false,
37 "enableAdvancedOptions": false,
38 "partialPayment": false,
39 "status": "DRAFT",
40 "createdAt": "2022-10-18T17:23:13.259"
41 },
42 {
43 "invoiceId": 67,
44 "invoiceNo": "SBT-INV-000067",
45 "totalAmount": 529.75,
46 "subTotal": 500.00,
47 "tax": 29.75,
48 "dueDate": "2022-10-23",
49 "currency": "NGN",
50 "invoiceItems": [
51 {
52 "itemName": "Bag",
53 "unitPrice": 100.00,
54 "vat": 5.95,
55 "amount": 100.00,
56 "quantity": 4
57 },
58 {
59 "itemName": "Bag",
60 "unitPrice": 400.00,
61 "vat": 23.80,
62 "amount": 400.00,
63 "quantity": 4
64 }
65 ],
66
67 "code": "00"
68}Get invoice by InvoiceNo
For the full specification, see our API Reference
GET
https://seerbitapi.com/invoice/{{publicKey}}/{{InvoiceNo}}
Response Sample
The code snippet below shows an example response to get an invoice by invoice number
1{
2 "payload": {
3 "invoiceId": 54,
4 "invoiceNo": "SBT-INV-000054",
5 "totalAmount": 556.00,
6 "subTotal": 556.00,
7 "externalBusiness_id": "00000051",
8 "discount": 0.00,
9 "dueDate": "2022-10-12",
10 "currency": "NGN",
11 "invoiceItems": [
12 {
13 "itemName": "Ada Ada iyoo",
14 "unitPrice": 556.00,
15 "vat": 0.00,
16 "amount": 556.00,
17 "quantity": 278
18 }
19 ],
20 "customer": {},
21 "billingCycle": false,
22 "payButtonOnInvoices": false,
23 "enableAdvancedOptions": false,
24 "partialPayment": false,
25 "status": "DRAFT",
26 "createdAt": "2022-10-12T10:27:45.732"
27 },
28 "code": "00"
29}Get invoice by orderNo
For the full specification, see our API Reference
GET
https://seerbitapi.com/invoice/{{publicKey}}/order/{{orderNo}}
Response Sample
The code snippet below shows an example response to get an invoice by invoice order
1{
2 "payload": {
3 "invoiceId": 54,
4 "invoiceNo": "SBT-INV-000054",
5 "totalAmount": 556.00,
6 "subTotal": 556.00,
7 "externalBusiness_id": "00000051",
8 "publicKey": "SBPUBK_TCDUH6MNIDLHMJXJEJLBO6ZU2RNUUPHI",
9 "testKey": "SBTESTPUBK_4v0JR58modUFJjF1Es206pveBQjOLxe2",
10 "supportEmail": "ts@greentechng.com",
11 "customerEmail": "qwertypoiuy@mailinator.com",
12 "businessName": "Green Technological Concepts",
13 "discount": 0.00,
14 "dueDate": "2022-10-12",
15 "currency": "NGN",
16 "invoiceItems": [
17 {
18 "itemName": "Ada Ada iyoo",
19 "unitPrice": 556.00,
20 "vat": 0.00,
21 "amount": 556.00,
22 "quantity": 278
23 }
24 ],
25 "customer": {},
26 "billingCycle": false,
27 "payButtonOnInvoices": false,
28 "enableAdvancedOptions": false,
29 "partialPayment": false,
30 "status": "DRAFT",
31 "createdAt": "2022-10-12T10:27:45.732"
32 },
33 "code": "00"
34}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.