# Standalone buttons

> Show a specific Ozow payment method as its own button at checkout so customers can go straight to the way they want to pay.

Source: https://hub.ozow.com/integration-methods/apis/money-in/standalone-buttons/

A **standalone button** shows one Ozow payment method as its own option on your checkout page, for
example Capitec Pay or card. Customers don't land on a general payment page and choose from there.
They click the method they recognise and go straight into that payment flow.

Customers who can't see how they can pay at checkout hesitate or leave. Most customers look for
logos they know, and a standalone button puts that logo in front of them.

## Why use standalone buttons

**Instant recognition.** A familiar logo shows the customer straight away that their preferred way
to pay is accepted.

**Brand familiarity builds trust.** A payment brand customers know reassures them when they
decide whether to pay.

**Customers expect to see their method.** If customers don't see their payment method, they assume
it isn't available. A standalone button removes that doubt.

**One less step.** The customer skips the method-selection screen, so there's less friction between
payment intent and a completed payment.

## What it looks like

Standalone buttons work anywhere a customer chooses how to pay. Show them alongside the general Ozow
button, not instead of it, so customers can still reach every other method enabled on your account.

> ℹ️ These examples are illustrations, not real merchants. Always use the official button artwork from
> [Logos and branding](https://hub.ozow.com/payment-methods/brand-assets.md).

### E-commerce checkout example

![E-commerce checkout example](https://hub.ozow.com/assets/api-integrations/redirect-to-ozow-one-api/standalone-button-ecommerce-example.png)

### Wallet top-up example

![Wallet top-up example](https://hub.ozow.com/assets/api-integrations/redirect-to-ozow-one-api/standalone-button-wallet-example.png)

## What the customer sees

When a customer taps a standalone button, they skip choosing a payment method and a bank and go
straight to that method's screen. Here's the journey for Capitec Pay.

![Capitec Pay standalone button journey, steps 1 to 4: the customer taps Capitec Pay at checkout,
enters their mobile number on Ozow, and opens the Capitec app to
authorise](https://hub.ozow.com/assets/api-integrations/redirect-to-ozow-one-api/standalone-button-capitec-journey-steps-1-4.png)

![Capitec Pay standalone button journey, steps 5 to 8: the customer approves the payment in the
Capitec app, sees it confirmed by Capitec and Ozow, and returns to the merchant
site](https://hub.ozow.com/assets/api-integrations/redirect-to-ozow-one-api/standalone-button-capitec-journey-steps-5-8.png)

## Integration guide

Add `institutionId` to your [Hosted Checkout](https://hub.ozow.com/integration-methods/apis/money-in/hosted-checkout.md) payment
request. When the `institutionId` is valid, Ozow sends the customer directly to that payment method.

> ℹ️ Each payment method's `institutionId` is listed on [Payment method identifiers](https://hub.ozow.com/integration-methods/apis/money-in/payment-method-ids.md).
> For the general Ozow button, leave out `institutionId`. The customer then chooses from all your
> enabled methods on the Ozow payment page.

Create the payment with `POST https://one.ozow.com/v1/payments` (staging: `https://stagingone.ozow.com/v1/payments`).

```json
{
  "siteCode": "YOUR_SITE_CODE",
  "region": "ZA",
  "amount": {
    "currency": "ZAR",
    "value": 100.00
  },
  "merchantReference": "ORDER-001",
  "expireAt": "2026-12-31T23:59:59Z",
  "returnUrl": "https://yourstore.com/order-complete",
  "institutionId": "YOUR_INSTITUTION_ID"
}
```

> ⚠️ **Important**: Only show a standalone button after Ozow has confirmed your account is enabled
> for that payment method. A button for a method you don't have sends customers to a screen where
> they can't pay.

> ℹ️ **Apple Pay and Google Pay can't be standalone buttons.** To offer them, choose one of these:

> - **Use a card standalone button.** It opens a payment screen where customers can pay by card,
> Apple Pay or Google Pay.
> - **Use [Embedded Wallet](https://hub.ozow.com/integration-methods/apis/money-in/embedded-wallet.md)** to show Apple Pay
> and Google Pay as their own buttons on your checkout.

## Next steps

1. **Confirm your enabled methods.** Check your payment flow to see which payment methods are enabled
   on your account.
2. **Get the official artwork.** Download the button for each method from [Logos and branding](https://hub.ozow.com/payment-methods/brand-assets.md).
   Don't recolour, stretch or rotate it.
3. **Add the buttons and pass the identifier.** Place each standalone button next to the general Ozow
   button and send the matching `institutionId` in the payment request.
4. **Test before going live.** Confirm each button opens the right method.
5. **Go live.**