checkout: A JavaScript repository from tutipay

Fastest way to add payment in your App.

This application is build on top of NOEBS to provide simple and clean payment subsystem for developers in sudan.

ℹ️ What is noebs web portal

A generic web view payment interface. Very secure, simple and easy to use, i18n and support for Ar/En and powered by noebs.

📦 Features

🎭 Customizable
🔰 Secure
💯 Reliability
Support multi languages Arabic, English

🏁 Getting Started

To have a in-app purchasing experience, you MUST send a message to adonese@soluspay.net that contains:

activity name (eg. store name , business name etc.. )
Fill in this document so we can create a biller ID for you. Biller ID is a unique identifer that you can use to accept payments. You can fill the form here and send it to adonese@soluspay.net

a biller ID is the link between your bank account and EBS.

🔧 How it works

You request this service via email. Where you send us brief info about your business
The next step is quite important and it requires an interference from us (for the time being). You need to fill biller form document. It is an official document from CBOS to register billers, or service providers like you.
We create a new namespace for you (or simply: a username for you, you see we are not that great at naming things!)
Now, to accept payments, you simply redirect your users to this super awesome, super secure and simple payment page!
After the payment is done, a user will be notified by an SMS about the money deducted from them AND you will instantaneuosly receive the amount! Just that, simple and secure!
Hooks are supported: Do you have an endpoint in your server and you want to receive the payment result without needing to go to our server! You can do that. Request it at adonese@soluspay.net
Custom URLs are supported too: whether you want to host this page on your domain name, OR you want to use a subdomain (from our domain name), all that is supported!
Got any other requests? No worries, just ping us here, or send us an email and we can deliver it to you in no time!

https://pay.noebs.dev/{activity_name}?id={id}&amount={amount}&lang=ar

Parameters description

+ activity_name -> required ,determine the namespace (username of Solus account)

+ id -> required , payment ID.

+ amount -> required , the required amount SDG.

! lang -> optional , page language defalut is english.

🌈 Customization

Color scheme in NOEBS web portal is primary driven from LOGO colors.

//tailwind.config.js

      colors: {
        background: "#F6F6F6",
        primary: "#E70E02",
        secondary: "#EEAC5A",
        deepOrange: "#E54A1F",
      },

primary is the dominant color.

📜 Project structre

src
├── App.js                  # Main layout
├── i18n.js                 # Localization (AR,EN)
├── index.js                # Bundle
├── App                     # Application files
│   ├── API                 # API calls hook
│   ├── assets              # Contain all svg used
│   ├── Components          # Individual components (abstract)
│   ├── Screens             # screens layout 
│   ├── Store               # contexts centralization (context api) 
...

Complex integrations and multi-tenants system

If your system supports multi-tenants, for example you are a store front and you want the fund to be transmitted to different destinations based on a custom ID you provide (a unique ID you generated in your system), Noebs can surely help you with this scenario out of the box.

You can request this integration, by sending an email to: adonese@soluspay.net.

Want to customize this page or self-host it

1- Download the repo or clone the repo:

2- Install it and run:

npm i
npm run start

tutipay/checkout