Changelog
A dated record of changes to the v1 API and these docs, newest first.
Add Funds embed
- The hosted Add Funds screen is available at
/embed/add-funds. Load it in an iframe withuserIdand aniframeTokenminted byPOST /v1/users/{userId}/auth/client-token, and add&env=devwhile 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.
- The hosted Add Funds screen is available at
Unknown sponsor and reward ids return 404
GET /v1/sponsors/{sponsorId}andGET /v1/rewards/{rewardId}now answer404 NOT_FOUNDfor an id that does not exist, in line with users, auctions, and redemptions. They previously answered400 VALIDATION_ERROR.
Clearer errors when creating a user
POST /v1/users:upsertnow answers400 VALIDATION_ERRORwith 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.
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 withstartPriceequal toreservePrice), points (GET /v1/users/{userId}/points/balanceandGET /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.pendingandtransaction.createdwebhooks, 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.