Direct Links: one button, many providers behind it

Direct Links let a merchant show its own payment-method buttons on its own checkout, with no Omno payment page. Each button links to an Omno Direct Link, and behind it Omno routes the payment across several providers of the same method, split by share or set in priority order. The shopper sees one simple choice and approves the payment in the method's own page or app.

Updated

Direct Links: your own buttons; behind one button, Omno splits payments between providers of that method. Example values.

In 30 seconds

  • Your own buttons for alternative payment methods and wallets, with no Omno payment page and no Omno branding.
  • Several providers of the same method sit behind one button, split by share or set in priority order.
  • Set up and changed in the Merchant Dashboard: adding or swapping a provider needs no engineering work.
  • 2 min read
  • 6 features
  • 3 settings you control
Talk to us

What it does

Your own buttons
Your checkout and your payment-method buttons. No Omno payment page and no Omno branding.
One button, many providers
Several providers of the same method sit behind a single button, so the shopper never has to choose between them.
Split by share or priority
Share traffic between providers by proportion, for example 70/30, or set an order of providers.
Works with the main Omno router
Use a Direct Link as a route inside your standard Omno routing setup.
Self-service setup
Create and edit Direct Links in the Merchant Dashboard, with a name, a routing type and providers. No engineering change to add or swap a provider.
Visibility
Each Direct Link shows its provider count and transaction count, and its payments appear in reporting like any other Omno payment.
On this page4 sections

Direct Links are the alternative-methods half of Omno Custom Checkout: your checkout, with no Omno payment page and no Omno branding. A payment takes five steps.

  1. You set up a Direct Link in the Merchant Dashboard and pick its providers and routing type.
  2. You show your own button for that payment method on your checkout.
  3. The shopper clicks the button.
  4. Omno picks the provider in the background and sends the shopper to complete the payment with that method.
  5. Your backend receives the result through the usual Omno webhook.

The developer guide on Direct Links covers the API calls.

How is the provider chosen?

Each Direct Link has a routing type. With a split by share, Omno divides payments between the providers in the proportion you set, for example 70% to one and 30% to another. With a priority order, you decide which provider comes first. A Direct Link can also sit inside your main Omno routing setup as one of its routes, so the rest of your rules still decide when it is used.

What do you manage in the dashboard?

You create and edit each Direct Link in the Merchant Dashboard: its name, its routing type and its providers. Adding a provider, swapping one out or changing the split needs no engineering change. Each Direct Link shows how many providers sit behind it and how many transactions it has carried, and its payments appear in reporting alongside every other Omno payment.

Choose Direct Links when your checkout is your own and you want wallets and local payment methods to look like the rest of it, with several providers behind each method so one provider is not your only option. For cards on the same checkout, add Card Fields. If you would rather have Omno host the whole payment step, use the hosted checkout, where every method sits in one place and your team changes it in the no-code builder.

Illustrative request from your backend that starts a payment on a Direct Link. Field names are simplified; the full reference is on docs.omno.com.json
{
  "directRouteId": "<route-id>",
  "currency": "BRL",
  "amount": 150.00
}

Settings you control

Routing type
Split by share between providers, or a priority order.
Providers
The providers of the method that sit behind the button.
Webhook endpoint
Where Omno delivers the final status of each payment.
Developer guide

Frequently asked questions

What is a Direct Link?

A route you create in the Omno Merchant Dashboard for one payment method, with several providers of that method behind it. Your own button on your checkout starts the payment, and Omno picks the provider in the background.

How does Omno pick the provider behind a button?

By the routing type you set on the Direct Link. You can split traffic between providers by share, for example 70/30, or set a priority order. A Direct Link can also be used as a route inside your main Omno routing setup.

Can I add or swap a provider without code?

Yes. Direct Links are created and edited in the Merchant Dashboard, so adding a provider or changing the split is a dashboard change, not an engineering task.

Does the shopper leave my site?

The shopper starts on your checkout with your button. For methods that need it, they then approve the payment in the method's own page or app. There is no Omno payment page in between.

Can I take cards with Direct Links?

No. Direct Links are for alternative payment methods and wallets. For cards on your own checkout, use Card Fields; for a hosted page with every method, use the hosted checkout.

it will.

Tell us where your payments fail. We will show you how routing changes the outcome.

esc
↑↓ to move ↵ to open All results