Create Vendor payment

Creates a new record.

POSThttps://api.tracksales.co/v1/vendor-payments

Required scope: vendor_payments:create

Request URL: https://api.tracksales.co/v1/vendor-payments

Body Params

vendorIdstringrequired

Vendor UUID

amountnumberrequired

Payment amount

Responses

201Created

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Vendor-payments was not found.

422Validation Error

Request validation failed.

curl -X POST 'https://api.tracksales.co/v1/vendor-payments' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"vendorId":8,"amount":4000,"date":"2026-07-03"}'

{
    "success": true,
    "data": {
        "vendor_payment_id": 901,
        "vendorId": 8,
        "amount": 4000
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Vendor-payments not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}