Update provider funding source

PATCH
/providers/{providerID}/participants/{participantID}/funding-sources/{fundingSourceID}

Update a funding source’s display name and last four digits. The fundingSourceID does not change, so payouts that reference the source keep resolving.

Auth: API key or bearer token. Scoped to the calling provider. Returns 404 when no participant matches within your provider. Returns 422 when the body fails validation.

Request
cURL
curl -X PATCH https://api.moov.money/providers/{providerID}/participants/{participantID}/funding-sources/{fundingSourceID} \
  -H "Content-Type: application/json" \
  -d '{
  "displayName": "First National Savings",
  "last4": "4321"
}'
Responses
200 400 401 403 404 422
The request completed successfully.
{
  "fundingSource": {
    "createdOn": "2026-08-31T12:00:00Z",
    "displayName": "First National Checking",
    "fundingSourceID": "fnd_01HF5J9ZKQT4RXP8M2VYBN3D",
    "fundingType": "bank_account",
    "last4": "4321",
    "providerSourceID": "src_01HP5J9ZKQT4RXP8M2VYBN3D",
    "updatedOn": "2026-08-31T12:00:00Z"
  }
}
Malformed request: the body or headers failed validation.
Authentication missing, invalid, or insufficient.
Authentication present but the action is forbidden for this principal/claim.
The requested resource was not found.
The request was well-formed but couldn’t be processed (e.g. card declined).

Headers

X-Moov-Version

string
Set this header to the API version being targeted (e.g. v2026.07.00). When omitted, the server applies its default version.

Path parameters

providerID

string required
Your provider account ID.

participantID

string required
The participant’s participantID, or your externalID for them. Both resolve to the same participant.

fundingSourceID

string required
Identifier of the funding source.

Request

application/json
Display metadata to update. providerSourceID and fundingType are immutable.

last4

string [1 to 4] characters
Last four digits of the funding source number: the card number for card, or the bank account number for bank_account. When present, must be 1–4 characters.

displayName

string [1 to 256] characters
Human-readable display label. When present, must be 1–256 characters.

Response

The updated funding source, nested under fundingSource.

fundingSource

object required
The updated funding source.
Show child attributes

fundingSource

fundingType

string<enum> required
Funding source discriminator.
Possible values: card, bank_account

providerSourceID

string [1 to 256] characters required
Your identifier for the underlying funding source. Must be 1–256 characters.

displayName

string [1 to 256] characters required
Human-readable display label (e.g. the account nickname). Must be 1–256 characters.

last4

string required
Last four digits of the funding source number: the card number for card, or the bank account number for bank_account. Rendered with displayName in the UI. At most 4 characters.

createdOn

string<date-time> required
When this funding source was created.

updatedOn

string<date-time> required
When this funding source was last updated.

disabledOn

string<date-time>
When this funding source was removed. Omitted while active.

fundingSourceID

string required
Stable server-owned identifier a payout references.