Skip to main content

How to look up delivery orders with our Stripe App

View your customers' Onro delivery orders, statuses and tracking links inside the Stripe Dashboard. This is not the Stripe payment setup.

Looking to accept payments with Stripe? See How to configure Stripe.

Onro is courier software where AI agents run your operations, from dispatching and deliveries to driver management. Connect Onro with Stripe to give your team instant access to that delivery information without leaving the Stripe Dashboard. Once connected, the Onro app shows each Stripe customer's delivery orders, live statuses, order details, tracking links and receipts, and lets you search any Onro order or customer from any Dashboard page.

This guide explains how to connect your Onro account with Stripe, how the app works, and how to troubleshoot common issues.


What you'll be able to do

Once the app is connected, your team can access delivery information directly in Stripe without switching back and forth to Onro.

The Onro app lets you:

  • See all Onro delivery orders for the Stripe customer you are viewing, newest first

  • See each order's code, type, price, current status and creation date

  • Open an order to see its pickup and drop-off addresses, driver, service, vehicle and payment details

  • Open the customer tracking page and receipt (when available)

  • Search Onro orders by order code or phone number from any Stripe Dashboard page

  • Look up an Onro customer by name or phone number and browse their orders

This makes it easier for your team to answer common customer questions, such as:

  • Where is my order?

  • Has my parcel been picked up?

  • Has my delivery been completed?

  • Can you send me the tracking link or receipt?


Before you start

Make sure you have the following:

  • An active Stripe account

  • Permission to install apps in your Stripe account (Administrator or Apps administrator role)

  • Administrator access to the Onro Admin Center

  • Your Stripe account ID. It starts with acct_ and is shown on the Onro app's Settings page in Stripe, and in your Stripe Dashboard URL.


How to set up the integration

Step 1: Install the Onro app in Stripe

In your Stripe Dashboard, go to the App Marketplace, search for Onro, and click Install app. Review the permissions and confirm the installation.

The Onro app is read-only on Stripe. It reads a customer's Onro customer ID (metadata), phone, name and email only to find the matching customer in Onro, and it never changes your Stripe data.

After installing, open the app's Settings page and copy the Stripe account ID shown there (for example acct_1A2B3C4D5E6F7G8H). You will need it in the next step.

Step 2: Create a Stripe integration in Onro

In the Onro Admin Center, follow the path below:

Admin Center → Settings → Integration → Accounting → Stripe

Click the New button and enter the following information:

  • Title: Enter a recognizable name, such as Stripe Integration

  • User: Select the dispatcher user the integration should use

  • Stripe Account ID: Paste the Stripe account ID you copied in Step 1

Click Submit. Onro generates an API key for this integration. Copy it.

The Stripe Account ID must be the account where the Onro app is installed. If it does not match, the app shows "This Onro API key is linked to a different Stripe account". Keep your API key private and never share it in screenshots or emails.

Step 3: Connect the app in Stripe

Go back to the Onro app's Settings page in Stripe, paste the API key, and click Save changes.

If the connection is successful, the Settings page shows Connected.


Working with the Onro app

View a customer's orders

Open any customer in Stripe and click the Onro app in the right-hand drawer. The This customer tab lists their Onro delivery orders, newest first, with the order code, type, date, price and status. Click Load more orders to see older ones.

Onro finds the matching customer in this order:

  1. Onro customer ID saved in the Stripe customer's metadata (customer_id)

  2. Phone number on the Stripe customer

  3. Name and email: Onro searches by the customer's name and confirms the match with the email address

A small line above the orders shows how the customer was matched, for example "matched by phone".

If several Onro customers share the same name and email, or only the name matches, the app asks you to choose the right customer. Orders of different customers are never combined, and your choice is not saved.

Open an order

Click an order to open its details: status, price, order type, created and updated dates, pickup and drop-off addresses, driver, service, vehicle and payment. Click Track shipment to open the customer tracking page, or Receipt to open the receipt, in a new browser tab.

Search Onro

Use the Search Onro tab on a customer page, or open the Onro app from any other Dashboard page:

  • Orders: search by order code or customer phone number

  • Customers: search by name or phone number, then click a customer to see their orders


Good to know

ℹ️The app is read-only

The Onro app lets your team view delivery information, but it does not create or edit orders, change statuses, assign drivers, or change any data in Stripe or Onro.

ℹ️One connection per Stripe account

After an administrator connects the app, everyone with access to the Stripe account can use it. Each Stripe account needs its own Stripe integration in Onro with its own Stripe Account ID.

ℹ️Customers created by Onro match automatically

When Onro creates a customer in Stripe, it saves the Onro customer ID in the customer's metadata, so the app always finds the right customer. For older Stripe customers, matching uses the phone number, then name and email.


How to disconnect

To disconnect, open the Onro app's Settings page in Stripe and click Disconnect. To stop access from Onro's side, open the integration in Admin Center → Settings → Integration → Accounting → Stripe and delete it or generate a new API key.

Disconnecting does not delete any Onro orders, customers or Stripe data, and you can reconnect later.

How to uninstall the app from Stripe

In your Stripe Dashboard, go to Settings → Installed apps, open Onro, and click Uninstall app.


Troubleshooting

⛔The app says "Connect your Onro account"

The app is not connected yet. Open the app's Settings page in Stripe, paste the API key from the Onro Admin Center, and click Save changes.


⛔"This Onro API key is linked to a different Stripe account"

The Stripe Account ID saved in Onro does not match the account where the app is installed. Copy the account ID shown on the app's Settings page and update the Stripe integration in the Onro Admin Center.


⛔"The Onro API key is invalid"

The key was copied incorrectly or regenerated. Copy the API key again from Admin Center → Settings → Integration → Accounting → Stripe and save it in the app's Settings page.


⛔"No Onro customer matches this Stripe customer"

What to check:

  • The Stripe customer has a phone number that matches the customer's phone in Onro

  • Or the Stripe customer's name and email match the customer in Onro

  • You can also use the Search Onro tab to find the customer by name or phone


⛔The Track shipment or Receipt button is missing

These buttons only appear when the order has a tracking link or receipt. They may be unavailable for orders in an early stage or orders that were cancelled.


Frequently asked questions

Does the app change my Stripe data?

No. The app only reads customer details to find the matching Onro customer. It never creates, edits or deletes anything in Stripe.

Can multiple team members use the app?

Yes. Once an administrator connects the app, everyone with access to the Stripe account can use it.

Can I connect more than one Stripe account?

Yes. Install the app in each Stripe account and create a separate Stripe integration in Onro for each one, with that account's Stripe Account ID.

Does Onro store my Stripe password?

No. The connection uses an Onro API key. Onro never receives your Stripe password.

Does disconnecting delete orders?

No. Disconnecting only removes the connection between Onro and Stripe. It does not delete any orders, customers or business information.

Did this answer your question?