---
title: "Create Bill Payment"
method: POST
path: "/bills/{bill_header_id}/payments"
tags: ["Bill Payments"]
---

# Create Bill Payment

`POST /bills/{bill_header_id}/payments`

## Request

- Base URL: `http://localhost/app4legal/api/v2/money`
- URL: `http://localhost/app4legal/api/v2/money/bills/{bill_header_id}/payments`
- Auth: OAuth 2
  - Password
  - Token URL: `http://localhost/app4legal/api/v2/core/login`
- TypeScript: <https://skmtc.dev/app4legal/apis/a4l-money-api/docs/bills/:bill_header_id/payments/post.ts> (a function with typed inputs; its response is checked against the schema)

Create Bill Payment

## Path parameters

- `bill_header_id` integer, required

## Request body

- object
  - `organization_id` integer, required
  - `paid_on` string, date, required
  - `deposit_account_id` integer, required
  - `deposit_amount` number, required
  - `payment_method` 'Bank Transfer' | 'Cash' | 'Cheque' | 'Credit Card' | 'Other' | 'Online payment', required
  - `comments` string
  - `payment_reference` string

## Response `201`

Bill payment has been created successfully.

- object
  - `message` string
  - `bill_payment` object
    - `payment_id` integer
    - `payment_voucher_id` integer
    - `payment_method` string
    - `payment_total` number
    - `payment_reference` string
    - `description` string
    - `account_id` integer
    - `supplier_account_id` integer
    - `date` string, date
    - `bill_number` string
    - `comments` string
    - `created_on` string, date-time

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden
- `500`: Internal Server Error

## Changes

- **2026-08-06** `e0d144609998`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/app4legal/apis/a4l-money-api/changes/bills/:bill_header_id/payments/post.md)

---

[API](https://skmtc.dev/app4legal/apis/a4l-money-api.md) - [All operations](https://skmtc.dev/app4legal/apis/a4l-money-api/llms.txt) - [OpenAPI document](https://skmtc.dev/app4legal/apis/a4l-money-api/revisions/e0d144609998?raw)