latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

Cards

Get Prefund balance

Returns the current state of the Partner's Prefund Account. This endpoint is partner-scoped, not user-scoped; UR maintains one Prefund Account per partner, and the response is a flat, single-currency object for the settlement currency (defaults to USD). Poll at operational dashboard cadence, e.g. no more frequently than once per minute unless UR advises otherwise and do not call it from inside the Card Authorization callback; UR already performs Prefund availability checks before approving.

get/api/fma/v1/prefund-balance

Headers

X-Api-Signaturestring required

Partner's EIP-191 signature for Partner Auth (0x-prefixed hex).

X-Api-Deadlinestring required

Unix seconds expiry for the request signature.

X-Api-PublicKeystring required

Partner's signer Ethereum address.

Response

Current Prefund Account state for the partner's settlement currency. The response does not include a settleMode field; record your configured settlement mode from onboarding.

codeinteger required

0 on success; a non-zero value indicates a business rejection.

messagestring required

Human-readable diagnostic; empty on success.