Skip to main content
PUT
/
api
/
billing
/
coworkerpaymentmethods
Update CoworkerPaymentMethod
curl --request PUT \
  --url https://spaces.nexudus.com/api/billing/coworkerpaymentmethods \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "CoworkerId": 123,
  "BusinessId": 123
}
'
{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}
Updates an existing CoworkerPaymentMethod record. You must include the Id of the record to update along with all required fields.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CoworkerPaymentMethod-Edit role.

Enums

ValueName
1MultiGateway
2Stripe
3Forte
4AuthorizeNetSubscription
5PaypalStandardSubscription
6PayPalAdaptive
7EPay
8Braintree
9EziDebit
10LiqPay
11StripeACH
12GoCardless
13StripeBACS
94CreditNote
95GiftCard
96BankTransfer
97Cash
98Check
99Other

Request Body

Required Fields

Id
integer
required
The Id of the CoworkerPaymentMethod record to update.
CoworkerId
integer
required
Customer this payment method belongs to.
BusinessId
integer
required
Location that issued or will charge invoices using this payment method.

Optional Fields

RegularPaymentProvider
integer
Payment provider for this method. For this entity, valid values are Stripe (2), StripeACH (11), StripeBACS (13), and GoCardless (12).. See eRegularPaymentProvider? enum above.
MethodId
string
Provider payment method ID (e.g. Stripe payment method ID).
CustomerId
string
Provider customer ID (e.g. Stripe or GoCardless customer ID).
MandateId
string
GoCardless mandate ID. Only populated for GoCardless payment methods..
CardNumber
string
Masked card number for display purposes only.
Notes
string
Optional notes about this payment method.

Code Examples

curl -X PUT \
  "https://spaces.nexudus.com/api/billing/coworkerpaymentmethods" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "CoworkerId": 0,
    "BusinessId": 0,
    "Id": 87654321
}'

Response

200

Status
integer
HTTP status code. 200 on success.
Message
string
A human-readable message confirming the update.
Value
object
Contains the Id of the updated record.
WasSuccessful
boolean
true if the coworkerpaymentmethod was updated successfully.
Errors
array
null on success.
Example Response
{
  "Status": 200,
  "Message": "CoworkerPaymentMethod was successfully updated.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

400

Message
string
A summary of the validation error(s), in the format PropertyName: error message.
Value
any
null on validation failure.
Errors
object[]
Array of validation errors.
WasSuccessful
boolean
false when the request fails validation.
Example Response
{
  "Message": "Name: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Name"
    }
  ],
  "WasSuccessful": false
}