Create EWA draw request

POST/payroll/ewa/draws

Submits an employee request to draw a portion of their earned wages before payday. The requested amount is validated against the employee's available balance and configured maximum draw limit. Approved draws are disbursed via the configured EWA payment method.

Request

Request body

Content type application/json (required).

Field	Type	Required	Description
employee_id	integer	Yes	ID of the employee requesting the draw.
requested_amount	number (float)	Yes	Amount the employee wishes to draw (must not exceed available_balance).
fee_amount	number (float), nullable	No	Optional platform fee charged for the draw (deducted from the disbursed amount).

Example

{
  "employee_id": 42,
  "requested_amount": 500.0,
  "fee_amount": 5.0
}

Responses

201 EWA draw request created and queued for disbursement

Content type application/json, object · EwaDrawResponseV1.

Field	Type	Required	Description
id	integer	No
employee_id	integer	No
requested_amount	number (float)	No
fee_amount	number (float), nullable	No
net_disbursed	number (float)	No	Amount actually disbursed to the employee (requested_amount minus fee_amount).
status	string	No	One of: "pending", "disbursed", "failed"
created_at	string (date-time)	No

Example

{
  "id": 12,
  "employee_id": 42,
  "requested_amount": 500.0,
  "fee_amount": 5.0,
  "net_disbursed": 495.0,
  "status": "pending",
  "created_at": "2026-04-08T12:15:00Z"
}

422 Validation failed — check requested_amount against available balance

409 Requested amount exceeds the employee's available EWA balance or draw limit

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/ewa/draws" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"employee_id": 42, "requested_amount": 500.0, "fee_amount": 5.0}'