Skip to main content
PUT
Update UPA display profile
Set the recipient identity shown to payers. Updates use optimistic concurrency and affect future Payments; existing Payments keep their captured recipient display snapshot.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Path Parameters

accountId
string
required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

Body

application/json
displayName
string
required
Required string length: 1 - 120
Example:

"Acme Downtown"

expectedVersion
integer
required

Use 0 when setting the profile for the first time.

Required range: x >= 0
reason
string
required
Required string length: 10 - 500
Example:

"Update the payer-facing store identity."

logoUrl
string<uri> | null
Maximum string length: 2048
Example:

"https://cdn.example.com/acme-downtown.png"

Response

Updated account bundle

account
object
required
connectedWallets
object[]
required
paymentHandle
object
settlementProfile
object