Skip to main content
POST
/
service
/
general-ledger
/
invoices
/
{invoice_id}
/
receive-payment
curl -X POST https://kube.acho.io/service/general-ledger/invoices/INV-2024-001/receive-payment \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_date": "2024-02-10",
    "payment_amount": 4400,
    "deposit_account_id": "a3-cash-xxx",
    "payment_method": "Bank Transfer",
    "reference": "WIRE-001"
  }'

{
  "invoice_id": "INV-2024-001",
  "payment_id": "CP-2024-001",
  "payment_date": "2024-02-10",
  "payment_amount": 4400,
  "deposit_account_id": "a3-cash-xxx",
  "payment_method": "Bank Transfer",
  "reference": "WIRE-001",
  "invoice_status": "Paid",
  "amount_paid_total": 4400,
  "amount_due": 0
}

​
Request

Record a customer payment against an invoice.

​
Headers

​
Authorization
string
required
JWT authentication token. Format: jwt YOUR_TOKEN
​
Content-Type
string
required
Must be application/json

​
Path Parameters

​
invoice_id
string
required
The invoice ID

​
Body Parameters

​
payment_date
string
required
Date of payment (YYYY-MM-DD)
​
payment_amount
number
required
Amount received
​
deposit_account_id
string
required
Cash/bank account for the deposit
​
payment_method
string
Payment method (e.g., Bank Transfer, Check, Credit Card)
​
reference
string
Payment reference number
curl -X POST https://kube.acho.io/service/general-ledger/invoices/INV-2024-001/receive-payment \
  -H "Authorization: jwt YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_date": "2024-02-10",
    "payment_amount": 4400,
    "deposit_account_id": "a3-cash-xxx",
    "payment_method": "Bank Transfer",
    "reference": "WIRE-001"
  }'

{
  "invoice_id": "INV-2024-001",
  "payment_id": "CP-2024-001",
  "payment_date": "2024-02-10",
  "payment_amount": 4400,
  "deposit_account_id": "a3-cash-xxx",
  "payment_method": "Bank Transfer",
  "reference": "WIRE-001",
  "invoice_status": "Paid",
  "amount_paid_total": 4400,
  "amount_due": 0
}