Create Payment | Papertracc Docs

curl -X POST https://api.papertracc.com/v1/payments \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "amount": "250000.00",
  "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
  "allocations": [
    {
      "amount": "250000.00",
      "bill_id": "45c6e26d-e132-4548-8e2e-5bfc467cf94a"
    }
  ],
  "payment_date": "2026-06-18T10:00:00.000Z",
  "staff_id": "7d2c9c72-392c-4f8d-b3f1-c1fef2c2d501",
  "vendor_id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
  "exchange_rate": "1.00",
  "payment_method": "BANK_TRANSFER",
  "destination_account": {
    "bank": "Spruce Bank",
    "account_number": "1234567890"
  }
}'

{
  "data": {
    "id": "59ad58e5-1571-4ce5-a140-6e7e33beb47c",
    "type": "BILL_PAYMENT",
    "amount": "250000.00",
    "status": "POSTED",
    "vendor": {
      "id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
      "display_name": "Global Softworks"
    },
    "documents": [],
    "vendor_id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
    "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
    "created_at": "2026-06-18T10:00:00Z",
    "project_id": "spruce-demo",
    "allocations": [
      {
        "id": "5c998a23-a6fc-4c2e-8e22-7f90ad81ce0a",
        "amount": "250000.00",
        "bill_id": "45c6e26d-e132-4548-8e2e-5bfc467cf94a",
        "payment_id": "59ad58e5-1571-4ce5-a140-6e7e33beb47c",
        "bill_reference": "BILL-0001"
      }
    ],
    "payment_date": "2026-06-18T10:00:00Z",
    "currency_code": "NGN",
    "exchange_rate": "1.00",
    "journal_status": "POSTED",
    "payment_method": "BANK_TRANSFER",
    "journal_entry_id": "JE-0003",
    "payment_reference": "PAY-0001",
    "destination_account": {
      "bank": "Spruce Bank",
      "account_number": "1234567890"
    }
  },
  "status": true,
  "message": "Successfully created payment"
}

Creates a payment and allocates it to one or more bills.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active project.

Request

This endpoint expects an object.

amountstringRequired

account_idstringRequiredformat: "uuid"

allocationslist of objectsRequired

payment_datedatetimeRequired

staff_idstringOptionalformat: "uuid"

vendor_idstringOptionalformat: "uuid"

exchange_ratestringOptional

payment_methodstringOptional

destination_accountobjectOptional

Passed through opaquely by the API; structure is not validated at this layer.

Response

Created

dataobject

statusboolean

messagestring