Create new Bill

POST

https://staginggateway.fintainium.com/gateway/payment/createBill

The Create Bill API allows businesses to generate a bill (transaction record) tied to a vendor in the Fintainium Network. Bills serve as the foundation for scheduling and processing payouts.

Key features:

Create a bill record associated with a Recipient (vendor).

Include essential information such as businessId, vendor ID, amount, and due date.

Supports attaching metadata (e.g., invoice numbers, descriptions).

Ensures payouts are linked to clear, auditable transactions.

Use this API to establish payable records that streamline reconciliation and payment processing.

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/payment/createBill' \
--header 'sessionKey;' \
--header 'Content-Type: application/json' \
--data '{
    "businessId": "1048273",
    "internalId": "123456",
    "createBill": [
        {
            "billNumber": "45678",
            "billPO": "67856",
            "totalTax": "23.00",
            "billDiscountAmount": "00.00",
            "billDate": "2024-02-14",
            "billDueDate": "2024-02-21",
            "term": "10 Days",
            "expenseCategoryDetails": [
                {
                    "accountId": "68"
                    "accountName": "Pen",
                    "description": "Pen",
                    "unitPrice": 1350.00
                    "class": "New York"
                },
                {
                    "accountId": "21"
                    "accountName": "June Rent",
                    "description": "June Rent",
                    "unitPrice": 1560.00
                    "class": ""
                }
            ],
            "itemDetails": [
                {
                    "itemName": "Marketing Expense",
                    "description": "Marketing of June",
                    "quantity": "2",
                    "unitPrice": 1500.00
                    "class": ""
                }
            ]
        },
        {
            "billNumber": "45679",
            "billPO": "67856",
            "totalTax": "600.00",
            "billDiscountAmount": "100.00",
            "billDate": "2024-02-20",
            "billDueDate": "2024-02-29",
            "term": "10 Days",
            "itemDetails": [
                {
                    "itemName": "Online Marketing",
                    "description": "Online Marketing",
                    "quantity": "10",
                    "unitPrice": 650.00
                    "class": ""
                }
            ]
        }
    ]
}'

Response Example

{
"businessId": "1048273",
"internalId": "123456",
"statusCode": 200,
"actionCode": "00",
"message": "Successful",
"failedCount": 0,
"failedMessageList": [],
"successCount": 2,
"billDetail": [
    {
    "reference": "45678"
    "amount": "5933.00"
    },
    {
    "reference": "45679"
    "amount": "6500.00"
    }
  ]
  "timestamp": "02-20-2024 02:14:19",
}

Modified at 2025-09-05 17:46:30

Add Payment Method

GET City List by State Name/ID/Code