Skip to main content
GET
Resolve payment handle
Returns the accountId to use with account-scoped endpoints, together with the payment handle record. A bare handle uses the authenticated app’s namespace; a qualified handle must belong to the authenticated partner.

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

handle
string
required
Example:

"alice@partner"

Response

Resolved payment handle

accountId
string
required

Canonical UPA account ID to use with account-scoped partner endpoints.

Example:

"acct_123"

paymentHandle
object
required