Urbanspace Market Pass — Docs & Testing Hub

Simulate transactions

Inject a synthetic Market Money card transaction so you can exercise the pay-with-Market-Money earn path end to end — without a live card or a real Ansa delivery. Pick a cardholder, simulate an authorization at any market vendor, then settle it to watch the pending earn become redeemable. It posts a Svix-signed webhook to the same endpoint a live Ansa event hits, so signature verification and the earn handlers run exactly as in production. The linked-card earn path via Plaid is not simulated here.

Dev and local only — this endpoint is disabled in production.

Simulate a Market Money card transaction

POST /sandbox/transactions:simulate

EventAuths create a pending earn; settlements re-value it to the settled amount and make it redeemable.Cardholder user idrequiredThe Uptop user id to credit. They must already have a Market Money wallet — add a payment method first.Authorized amount (cents)requiredIn cents — e.g. 1599 = $15.99.Merchant descriptorOptional. Matched against your vendors (sponsors), same as the real card rail, to theme the earn and apply the vendor's multiplier.MCCOptional merchant category code.

How it works

Authorization records a pending earn for the cardholder — points are estimated from the authorized amount and the matched vendor’s multiplier, but aren’t redeemable yet. If you’ve configured a webhook, the points.pending event fires too.
Settlement re-values the earn to the amount that actually settled — a tip or partial capture changes it — makes the points redeemable, and credits the balance. A zero settlement voids the earn.
The merchant descriptor is matched against your vendors (sponsors) exactly like the real card rail, so you can verify themed, multiplied earns for any vendor you choose.