Update payment method

PUT/payroll/self-service/payment-method

Allows an authenticated employee to update their bank account or mobile money details used for net-pay disbursement. Change is queued for payroll admin review before taking effect.

Request

Request body

Content type application/json (required).

Field	Type	Required	Description
method_type	string	Yes	Payment disbursement method. One of: "bank_transfer", "mobile_money"
bank_name	string	No	Max length: 120
account_number	string	No	Max length: 30
account_name	string	No	Max length: 120
branch_code	string, nullable	No	Max length: 50
mobile_number	string, nullable	No	Mobile number for mobile money disbursement (required for method_type "mobile_money"). Max length: 20
mobile_provider	string, nullable	No	Mobile money provider (e.g. "mtn", "vodafone", "airteltigo").

Example

{
  "method_type": "bank_transfer",
  "bank_name": "Ghana Commercial Bank",
  "account_number": "1234567890",
  "account_name": "Kwame Mensah",
  "branch_code": "GCB-ACC-001"
}

Responses

200 Payment method update submitted for admin review

422 Validation failed — check account_number format

Example request

curl -X PUT "https://{tenant}.faciotech.net/api/v1/payroll/self-service/payment-method" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"method_type": "bank_transfer", "bank_name": "Ghana Commercial Bank", "account_number": "1234567890", "account_name": "Kwame Mensah", "branch_code": "GCB-ACC-001"}'