SomPayKit

Checkout form

Name, Somali phone number with wallet detection, wallet picker, total and Pay button.

Live preview

Install

npx shadcn@latest add https://sompaykit.aoubak.com/r/checkout-form.json

Adds components/sompaykit/checkout-form.tsx, the wallet picker, shadcn's button and input, and sompaykit-base (theme colors, so/en/ar strings, formatters, icons). Installs @sompaykit/core and @sompaykit/react.

Usage

'use client';

import { CheckoutForm } from '@/components/sompaykit/checkout-form';

export function Checkout({ order }: { order: { id: string; total: number; items: number } }) {
  return (
    <CheckoutForm
      charge="/api/pay" // see /docs/react#your-api-routes
      orderId={order.id}
      amount={order.total} // display only: the server calculates the real total
      currency="USD"
      itemCount={order.items}
      locale="so"
      onResult={(result) => {
        if (result.instructions) {
          // Manual mode: show <ManualPayCard instructions={result.instructions} />
        }
      }}
    />
  );
}

The form calls usePayment() for you, so double taps and resends after a dropped connection never charge twice.

  • The wallet is detected from the phone prefix, but the customer's own pick always wins (numbers move between operators).
  • mode="auto" changes the button to "Pay $18.00 with EVC Plus" for PIN-prompt providers.
  • On mobile the Pay button sticks to the bottom of the screen.

Props

PropTypeDefault
chargestring | ChargeFn—Your charge route or function.
amountnumber—Shown to the customer only.
currency'USD' | 'SLSH'—
orderIdstring—Sent to your server to look up the total.
itemCountnumber—Shows an "N items" line.
mode'manual' | 'auto''manual'Changes the button label.
walletsMobileWallet[]all fourWallets to offer, in order.
locale'so' | 'en' | 'ar''so'Arabic switches to right-to-left.
askNamebooleantrueAsk for the customer's name.
defaultValues{ name?: string; phone?: string }—Prefill, e.g. for a signed-in customer.
onResult(result) => void—Called once the server has started the payment.
classNamestring—

On this page