Changelog

A dated record of changes to the v1 API and these docs, newest first.

  1. Add Funds embed

    • The hosted Add Funds screen is available at /embed/add-funds. Load it in an iframe with userId and an iframeToken minted by POST /v1/users/{userId}/auth/client-token, and add &env=dev while you are on the sandbox. The new iframe tab has the snippet, the token flow, and a live preview driven by the user id in API settings.
    • Cards are entered inside the embed, so card details never touch your servers. In the sandbox, use the test card number 4242 4242 4242 4242 with any future expiry and any CVC, then add funds and watch the balance in GET /v1/users/{userId}/wallet/transactions. Bank linking in the embed runs against the Plaid sandbox.
  2. Unknown sponsor and reward ids return 404

    • GET /v1/sponsors/{sponsorId} and GET /v1/rewards/{rewardId} now answer 404 NOT_FOUND for an id that does not exist, in line with users, auctions, and redemptions. They previously answered 400 VALIDATION_ERROR.
  3. Clearer errors when creating a user

    • POST /v1/users:upsert now answers 400 VALIDATION_ERROR with the provider's reason when the wallet provider rejects the phone number, instead of a server error. Send E.164 numbers that pass carrier validation; the examples use +12125550123.
    • If the wallet provider is unavailable, the upsert still succeeds with a zero balance and the wallet is attached on the customer's first wallet call.
  4. Sandbox opened for Urbanspace

    • This sandbox runs the Uptop v1 API for the Urbanspace Market Pass program: customers, market vendors as sponsors, and the Market Money wallet.
    • The sandbox exposes users (POST /v1/users:upsert, GET /v1/users/{userId}), vendors as sponsors (GET /v1/sponsors), rewards (GET /v1/rewards), auctions used as fixed prices (GET /v1/auctions, each opened with startPrice equal to reservePrice), points (GET /v1/users/{userId}/points/balance and GET /v1/users/{userId}/points/events), and redemptions (POST /v1/users/{userId}/redemptions).
    • The Market Money wallet runs on the Ansa sandbox: balance and transactions, payment methods, and Plaid bank linking. points.pending and transaction.created webhooks, the Simulate tab for synthetic Market Money card transactions, and the Dashboard tab for seeding vendors, rewards, auctions, and points are all available against the dev environment.
    • The Market Money wallet is live in the sandbox: balance and transaction reads, Simulate, points, and redemptions all work today.