¶ Business Receipts Sandbox Overview

Our Sandbox environment provides a way to test the endpoints and user flows without actually requesting a production trip.

It resembles production environments much as possible, so that you can test your integration. Any scenarios function similar to how they would work in production, except it can only operate on trips created using test accounts.

To use the Sandbox, make calls to: https://sandbox-api.uber.com/

¶ Receipt workflow in Sandbox

¶ 1. Account Setup

Follow the instructions in Getting Started to ensure that you have been approved for access to your organization’s data and the business.receipts scope. Make sure to obtain Test user account from Uber representative if you want to simulate e2e trips and eats orders.

¶ 2. Simulating a test trip

Call POST /v1/sandbox/terminal-state-trip-run to create an asynchronous run for simulating terminal state trip. The call will return a runID and tripID to track the status of execution.

Typically, a run takes around 1-2 minutes to complete simulation. You can query the status of run by invoking GET /v1/sandbox/run/<run_id> endpoint.

¶ 3. Simulating a test Eats order

Call POST /v1/sandbox/terminal-state-eats-run to create an asynchronous run for simulating terminal state eats order. The call will return a runID to track the status of execution. The order_id of eats will be returned as part of get-run API response once order is created.

Typically, a run takes around 1-2 minutes to complete simulation. You can query the status of run by invoking GET /v1/sandbox/run/<run_id> endpoint.

¶ Available Endpoints:

¶ 4. Receive Receipt webhook

Once the trip/eats order is complete, you will receive receipt-ready webhook if your devapp has been configured to receive webhooks.

Any webhook event that you receive contains environment header which indicates whether the request is coming from production or sandbox. All test trip receipt events will have the header value as Sandbox.

¶ 5. Fetch trip receipt

Once you receive a webhook, you can then query GetReceipt endpoint to fetch details of the receipt.

All of the receipt endpoints can be invoked on Sandbox for test orders created under your org using a test account. Replace the host url to point to Uber Sandbox.