Simple checkout

Ideal for: Adding a payment step to a page you already have — a cart, a booking form, a sign-up flow. The customer pays without leaving your site. SeerBit Simple Checkout is an inline, responsive payment form that works across all devices. It is fully PCI-compliant and supports every payment method enabled on your account.

How it Works

Simple Checkout allows you to embed a payment form directly on your webpage using the SeerbitPay() JavaScript function. This function processes transactions based on your configuration. If you include a redirect_url in your request, users will be redirected to that URL upon successful payment.

Name	Type	Description	Required
public_key	`string`	Your SeerBit public key, used for secure transactions. Obtain it from the Merchant Dashboard.	Yes
currency	`string`	The transaction currency (e.g., NGN, USD).	Yes
tranref	`string`	Unique transaction reference.	Yes
amount	`string`	Amount to be charged.	Yes
description	`string`	Description of the transaction	Yes
full name	`string`	Customer’s full name (first and last name separated by a space).	Yes

Before you begin

Login to your SeerBit Dashboard.
Navigate to Settings > API Keys.
Copy your Public Key.

Integration Steps

1. Adding the Seerbit.js script to your page

Include the SeerBit JavaScript library in your <head> section and the paywithSeerbit() function in your page body:

<html>
  <head>
    <title>SeerBit Simple Checkout</title>
    <script src="https://checkout.seerbitapi.com/api/v2/seerbit.js"></script>
  </head>
  <body>
    <button onclick="paywithSeerbit()">Pay Now</button>
  </body>
</html>

2. Configure the Checkout

Add a payment button and configure the SeerbitPay() function with your transaction details:

<html>
  <head>
    <title>SeerBit Simple Checkout</title>
    <script src="https://checkout.seerbitapi.com/api/v2/seerbit.js"></script>
  </head>
 <body>
    <button onclick="paywithSeerbit()">Pay Now</button>

    <script type ="text/javascript">
      function paywithSeerbit() {
        SeerbitPay ({
        "public_key": "sbpub_yywuuuywyyttwttwy", //replace with your public key
        "tranref": "order-8f3c1a2e-4b90", // unique per transaction - use a UUID or your own order ID
        "currency": "NGN",
        "country": "NG",
        "amount": "150.00",
        "email": "test@emaildomain.com",
        "mobile_no": "", // Mobile Number
        "productId": "", // Product ID
        "description": "", // Product Description
        "setAmountByCustomer": false, //optional field. Set to true to allow customer set the amount
        "full_name": "John Doe", // Mandatory. (system expects two strings, demarcated by a space)
        "tokenize" : false, // set to true to allow token capture
        "planId" : "", // subscription plan id.
        "pocketReference" : "", // pocket reference number.
        "splitCode" : "", // Split Rule Code.
        "callbackurl": "http://yourdomain.com",
        },
        function callback(response, closeModal) {
         console.log(response) //response of transaction
        },
        function close(close) {
         console.log(close) //transaction close
        })
        }
    </script>

  </body>
</html>

Optional Configuration

Adding this will automatically include all the features and payment methods the seerbit checkout has. Including our advanced fraud detection tools whenever your customers attempts to make a payment

"description": "test payment description",
"splitCode": "100001", // enter your split code if you will using the split settlement feature

Dynamic Split Payment

Dynamic split Payment allows you to share a single transaction with multiple accounts. You can either create the split in advance using Split Rule on the Dashboard and reference it with a splitCode, or define the split dynamically at the time of the transaction.

"split": {
  "type": "FLAT", // PERCENTAGE
  "transactionFee": "SUB_ACCOUNT",  //  ALL_ACCOUNTS, PROPORTIONATE, SUB_ACCOUNT, PARENT_ACCOUNT
  "items": [
     {
       "subAccountCode": "imshia-uba-programme-Qx7aL9",
       "subAccountName": "",
       "value": "3.01"
     },
     {
       "subAccountCode": "ops-costs-2sD4kA",
       "subAccountName": "",
       "value": "2.00"
      }
    ]
  }

Optional Customization

You can tailor the checkout experience to match your brand.

customization: { 
    theme: { 
        border_color: "000000", 
        background_color: "F8F8F8", 
        button_color: "2E6EEB", 
    }, 
    // Choose which payment methods to display 
    payment_method: ["card", "account", "transfer", "wallet", "ussd"], 
    confetti: true, // Show a fun celebration on successful payment 
    logo: "https://yourlogo.url/logo.png", // Your brand logo 
}

Payment references

Generate tranref yourself, one per transaction. It must be unique — SeerBit rejects a reused reference — and it should trace back to your own order records. A UUID or your order ID with a prefix works well; a timestamp does not, because concurrent checkouts can produce the same value. See payment references and retries for what to do when a request times out.

Transaction fees

Who pays the SeerBit transaction fee — you or the customer — is a setting on your merchant dashboard. If the customer is the fee bearer, checkout calculates the fee and shows it to them on top of the amount you sent, so send the amount you want to receive rather than adding the fee yourself. See Transaction fees for the full breakdown.

Testing & Payment Verification

Click your Pay Now button and use our test cards to simulate transactions. No real funds will be debited.
To learn how to verify payments, visit our Payment Verification Guide.

Troubleshooting

If the payment modal does not appear, check your browser console for errors (commonly a missing public_key). For full parameter details, visit the Simple Checkout API Reference.

Get Started

Accept Payments

Payment Methods

After a Payment

Payouts & Wallets

Platforms & Marketplaces

In-Store Payments

Reference

How it Works

Before you begin

Integration Steps

1. Adding the Seerbit.js script to your page

2. Configure the Checkout

Optional Configuration

Dynamic Split Payment

Optional Customization

Payment references

Transaction fees

Testing & Payment Verification

Troubleshooting

​How it Works

​Before you begin

​Integration Steps

​1. Adding the Seerbit.js script to your page

​2. Configure the Checkout

​Optional Configuration

​Dynamic Split Payment

​Optional Customization

​Payment references

​Transaction fees

​Testing & Payment Verification

​Troubleshooting

How it Works

Before you begin

Integration Steps

1. Adding the Seerbit.js script to your page

2. Configure the Checkout

Optional Configuration

Dynamic Split Payment

Optional Customization

Payment references

Transaction fees

Testing & Payment Verification

Troubleshooting