# Create a Service Source: https://docs.fapshi.com/en/api-reference/create-a-service Learn how to create a service on the Fapshi dashboard to begin collecting or disbursing payments using the API. *** To use our API endpoints, you’ll need to [create a service](https://www.fapshi.com/en/help-and-support/how-to-create-a-service-to-get-api-credentials). A service is a representation of the service or platform you want to use to collect or disburse payments. You can create two kinds of service: 1. **Collection Service**: This will be used to collect money on your platform. All funds will be reflected in this service on your dashboard. 2. **Disbursement Service**: You can use this to issue payouts programmatically on your platform. You cannot use the same service for both collections and disbursement. If you need both functionalities, you must create two separate services. By default, payouts are deactivated on **Live Mode**. So, you have to [Contact Support](https://wa.me/237658610472) with your **API User** to request for activation. This should only be done when you have tested the functionality with the test keys. ## How to Create a Service 1. Log into your dashboard and click **Developers** on the extreme bottom left of the screen. 2. Click the "New Service" button. 3. Fill in the required details and confirm. The service name is the name of your website or app. - The domain name can be what you have already bought or what you intend to buy. i.e. You must not own it yet. Note that you cannot use **fapshi.com** as your domain name, since this is the Fapshi domain. 4. Once the service is created, open it. Your `apiuser` and `apikey` for that service will be displayed; **Sandbox** under **Sandbox** and **Live** under **API**. Copy these carefully, especially the `apikey` because they are sensitive. 5. Store the credentials securely (e.g., in an environment file or secure vault). Do not hard-code or commit them in public repos. Also, rotate the keys if necessary. # Get Service Balance Source: https://docs.fapshi.com/en/api-reference/endpoint/balance en/api-reference/openapi.json GET /balance Returns the current balance of the service account. ## Endpoint `GET /balance` Returns the current balance of the service account. Balance in sandbox environment is randomly generated on each request. # Initiate a Direct Payment Request Source: https://docs.fapshi.com/en/api-reference/endpoint/direct-pay en/api-reference/openapi.json POST /direct-pay Send a payment request directly to a user's mobile device. Direct pay is disabled by default on live environment; Follow the steps in the [Activate Direct pay on your Live Fapshi API guide](https://www.fapshi.com/en/help-and-support/how-to-activate-direct-pay-for-your-fapshi-api) to enable direct pay in live mode. ## Endpoint `POST /direct-pay` Send a payment request directly to a user's mobile device. You are responsible for building your own checkout and verifying payment status. Direct payment transactions cannot and do not expire. Consequently, their final state is either **SUCCESSFUL** or **FAILED**. Handle this endpoint with care; misuse can result in account suspension. ## Parameters | Name | Required | Type | Description | | :--------- | :------- | :------ | :--------------------------------------------------------------------------- | | amount | Yes | integer | Amount to be paid (minimum 100 XAF). | | phone | Yes | string | Phone number to request payment from (e.g., 67XXXXXXX). | | medium | No | string | `"mobile money"` or `"orange money"`. Omit to auto-detect. | | name | No | string | Payer’s name. | | email | No | string | Payer’s email to receive receipt. | | userId | No | string | Your system’s user ID (1–100 chars; a–z, A–Z, 0–9, -, \_). | | externalId | No | string | Transaction/order ID for reconciliation (1–100 chars; a–z, A–Z, 0–9, -, \_). | | message | No | string | Reason for payment. | | | | | | ## Response * `200 OK` with JSON body containing: * `message`: success message * `transId`: transaction ID to track payment status * `dateInitiated`: date when the payment was initiated * Errors return 4XX with failure message. # Expire a Payment Transaction Source: https://docs.fapshi.com/en/api-reference/endpoint/expire-pay en/api-reference/openapi.json POST /expire-pay Expire a payment link to prevent further payments. ## Endpoint `POST /expire-pay` Expire a payment link to prevent further payments. Only transactions that were created with the [initiate-pay](/en/api-reference/endpoint/initiate-pay) endpoint can be expired. ## Parameters | Name | Required | Type | Description | | :------ | :------- | :----- | :------------------------------ | | transId | Yes | string | ID of the transaction to expire | ## Response * Returns details of the expired transaction if successful. * Returns `400 Bad Request` with message `"Link already expired"` if the transaction was already expired. # Generate a Payment Link Source: https://docs.fapshi.com/en/api-reference/endpoint/initiate-pay en/api-reference/openapi.json POST /initiate-pay Create a payment link to redirect users to a Fapshi-hosted checkout page. ## Endpoint `POST /initiate-pay` Generate a payment link where users complete payment on a prebuilt Fapshi checkout page. ## Parameters | Name | Required | Type | Description | | :---------- | :------- | :------ | :--------------------------------------------------------------------------- | | amount | Yes | integer | Amount to be paid (minimum 100 XAF). | | email | No | string | If set, the user won't have to provide an email during payment. | | redirectUrl | No | string | URL to redirect the user after payment. | | userId | No | string | Your internal user ID (1-100 chars; a-z, A-Z, 0-9, -, \_). | | externalId | No | string | Transaction/order ID for reconciliation (1-100 chars; a-z, A-Z, 0-9, -, \_). | | message | No | string | Reason for payment. | ## Response * `200 OK` with JSON body containing: * `message`: success message * `link`: URL for user payment * `transId`: transaction ID to track payment status * `dateInitiated`: date when the payment was initiated * Errors return 4XX with a message explaining the failure. Payment links expire after 24 hours and cannot be used afterward. # Get Payment Transaction Status Source: https://docs.fapshi.com/en/api-reference/endpoint/payment-status en/api-reference/openapi.json GET /payment-status/{transId} Retrieve the status of a payment transaction using its transaction ID. ## Endpoint `GET /payment-status/:transId` Check the status of a payment by transaction ID. ## Status Values | Status | Meaning | | :--------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | CREATED | Payment not yet attempted. | | PENDING | User is in process of payment. | | SUCCESSFUL | Payment completed successfully. | | FAILED | Payment failed. | | EXPIRED | This means 24 hours have passed since the payment link was generated and no successful payment attempt was made in that time interval OR the link got [manually expired](/en/api-reference/endpoint/expire-pay) to prevent payment. | No payments can be made after the status is SUCCESSFUL or EXPIRED. For a given transaction ID, you can make at most **6 requests per minute**. Exceeding this limit returns a **429** response. It is generally better to rely on [webhook notifications](/en/api-reference/endpoint/webhook) to know when a payment status changes, rather than polling this endpoint. # Make a Payout Source: https://docs.fapshi.com/en/api-reference/endpoint/payout en/api-reference/openapi.json POST /payout Send money to a user's mobile money, orange money or fapshi account via a payout-enabled service. ## Endpoint `POST /payout` Send money to a user's mobile money, orange money or fapshi account via a payout-enabled service. After enabling payouts for a service, that service can no longer collect payments. Use separate services for collections and payouts. Payout is disabled by default in the live environment. To activate payouts in live environment, first implement and test payouts in sandbox environment, then send an email to Developer Support at [support@fapshi.com](mailto:support@fapshi.com) with your Live API User ONLY and mention that you want to enable payouts on your service. MAKE SURE YOU SEND THE LIVE API USER of your PAYOUT SERVICE. ## Parameters | Name | Required | Type | Description | | :--------- | :---------- | :------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------- | | amount | Yes | integer | Amount to send (minimum 100 XAF). | | phone | Conditional | string | Recipient phone number (e.g., 67XXXXXXX). Required when `medium` is not specified or not `"fapshi"`. | | medium | No | string | `"mobile money"`, `"orange money"`, or `"fapshi"`. Auto-detected if omitted (requires `phone`). When set to `"fapshi"`, `email` is required instead of `phone`. | | name | No | string | Recipient's name. | | email | Conditional | string | Recipient's email. Required when `medium` is `"fapshi"`. Optional for payout confirmation receipt when `medium` is not `"fapshi"`. | | userId | No | string | Your system's user ID for payout tracking (1-100 chars; allowed: a-z, A-Z, 0-9, -, \_). | | externalId | No | string | Transaction/order ID for reconciliation (1-100 chars; allowed: a-z, A-Z, 0-9, -, \_). | | message | No | string | Description or reason for payout. | ### Required Fields * **When `medium` is not specified**: `amount` and `phone` are required. * **When `medium` is `"fapshi"`**: `amount` and `email` are required. ### Sandbox Testing When testing payouts with `medium` set to `"fapshi"` in the sandbox environment: * **Emails that always return successful transactions**: `test.success@fapshi.com` and `messi.champion@fapshi.com` * **Emails that always return failed transactions**: `test.failed@fapshi.com` and `penaldo.test@fapshi.com` * **Other emails**: Transaction status will be determined in a stochastic (random) manner # Search Transactions Source: https://docs.fapshi.com/en/api-reference/endpoint/search-transactions en/api-reference/openapi.json GET /search Search for transactions using various filter criteria. ## Endpoint `GET /search` Search for transactions based on criteria. ## Query Parameters | Name | Description | Allowed Values | | :----- | :----------------------------------------------------------------------- | :------------------------------------------- | | status | Filter transactions by status. | `created`, `successful`, `failed`, `expired` | | medium | Filter by payment medium. | `mobile money`, `orange money` | | start | Start date (YYYY-MM-DD) for filtering initiated transactions. | Date format | | end | End date (YYYY-MM-DD) for filtering initiated transactions. | Date format | | amt | Exact amount to filter by. | Integer | | limit | Maximum number of results (default 10). | 1 to 100 | | sort | Sort order: `asc` or `desc`. Defaults to descending (most recent first). | `asc`, `desc` | Invalid query parameter values are ignored. # Get Transactions by User ID Source: https://docs.fapshi.com/en/api-reference/endpoint/transaction-by-user en/api-reference/openapi.json GET /transaction/{userId} Retrieve all transactions associated with a specific user ID. ## Endpoint `GET /transaction/:userId` Retrieve all transactions associated with a specific user ID. * Returns an array of transaction objects related to the specified user. # Webhook Integration Source: https://docs.fapshi.com/en/api-reference/endpoint/webhook en/api-reference/openapi.json WEBHOOK /webhook/payment-status Learn how to integrate webhooks to receive real-time payment status updates from Fapshi. A webhook is an API endpoint made available to external applications that can be called to notify your application whenever a significant event occurs. This allows your app to react or respond immediately to these events. You can set a webhook URL per service on your Fapshi dashboard. When set, a **POST** request will be sent to this webhook URL whenever the status of a payment changes to: * **SUCCESSFUL** — when a payment attempt completes successfully * **FAILED** — when a payment attempt fails (usually on operator networks like MTN Mobile Money or Orange Money) * **EXPIRED** — when a payment link expires after 24 hours without successful payment The payload of the webhook request will be the same as the response body returned when [querying a payment status](/en/api-reference/endpoint/payment-status). ## How Webhooks Work Webhook Sequence Diagram 1. **Payment Initiated**: Your external application initiates a payment by calling one of Fapshi's payment endpoints (e.g., [initiate-pay](/en/api-reference/endpoint/initiate-pay) or [direct-pay](/en/api-reference/endpoint/direct-pay)). 2. **Payment Processed**: Fapshi Server processes the payment transaction. This includes handling the payment flow, communicating with payment operators, and updating the transaction status. 3. **Webhook Sent**: When the payment status changes to SUCCESSFUL, FAILED, or EXPIRED, Fapshi Server automatically sends a POST request to your configured webhook URL with the updated transaction details. 4. **Webhook Received**: Your external application receives the webhook notification and can process it accordingly (e.g., update your database, send notifications, trigger other workflows). Your server should respond quickly to webhook requests to avoid timeouts, ideally with a 200 status code. Fapshi sends only one webhook request per event, regardless of whether your server responds or not. ## Webhook Security You can authenticate the origin of a webhook request by setting a webhook secret on the Fapshi dashboard. When a secret is configured, every webhook request includes a header called `x-wh-secret` whose value is the secret you set on the dashboard. Comparing the value in this header to the secret you configured tells you whether the request came from Fapshi. As a security measure, the dashboard does not let you view or determine whether a webhook secret has already been set for a service. ## Webhook Payload Format # Getting Started with the API Source: https://docs.fapshi.com/en/api-reference/getting-started Learn how to set up and use the Fapshi API, from creating API keys to making authenticated requests and understanding the API’s structure and capabilities. *** If you're new to the API, we recommend reviewing the [Preliminary Knowledge](/en/api-reference/preliminary-knowledge) section first. It contains essential information about authentication, request structure, response formats, and general rules for interacting with the API. The **Fapshi API** empowers you to build seamless and fully customized payment experiences within your website, app, or service. Whether you're collecting payments or disbursing funds, the API gives you everything you need to go live quickly — in minutes, not days. Have questions, feedback, or suggestions? Reach out via [support@fapshi.com](mailto:support@fapshi.com), or join the conversation in our [Slack developer community](https://fapshicommunity.slack.com/archives/C034Q50QB6U). We're always listening — to the good, the bad, the confusing, and the wishlist. ## Prerequisites Before diving in, make sure the following are in place: * A [Fapshi account](https://dashboard.fapshi.com/auth/signup) * Your account is [activated](/en/guides/getting-started/activate-account) * You’ve [created a service](/en/api-reference/create-a-service) from your dashboard (this will provide your [API Key and API User](/en/api-reference/preliminary-knowledge/api-credentials)) ## What You Can Do with the API The Fapshi API supports two primary operations: ### 1. **Collect Payments** You can collect payments using either: * [`Initiate Pay`](/en/api-reference/endpoint/initiate-pay): Provides a prebuilt checkout page where your customers complete payments through a Fapshi-hosted interface. Great for rapid setup. * [`Direct Pay`](/en/api-reference/endpoint/direct-pay): Offers full control. You’ll build your own payment form and handle validations and user experience on your end, while using our backend to process the transaction. Read the [Direct pay Vs Initiate Pay article](https://www.fapshi.com/en/help-and-support/direct-pay-vs-initiate-pay-all-you-need-to-know) to understand the difference between the two and know which one to choose. ### 2. **Disburse Funds** Send money to one or multiple mobile money accounts via our [disbursement endpoint](/en/api-reference/endpoint/payout). This is useful for payouts, salary distribution, or financial services. *** You’re now ready to begin! Head over to the [Preliminary Knowledge](/en/api-reference/preliminary-knowledge) section for details on available parameters, responses, and usage examples. # API Credentials Source: https://docs.fapshi.com/en/api-reference/preliminary-knowledge/api-credentials Learn how to authenticate your API requests to Fapshi using your API User and API Key. *** To successfully access any of Fapshi’s developer endpoints, you must include valid **API credentials** in every request. These credentials authenticate you and ensure secure access to Fapshi services. ## Overview API credentials consist of: * `apiuser` – your unique API user identifier * `apikey` – a secret key that acts like a password These two parameters must be included in the **headers** of your HTTPS requests. If omitted or incorrect, the API will return an authentication error. ## How to Use Credentials in Requests Include the `apiuser` and `apikey` in the header of every API call like so: **Headers:** `apiuser: YOUR_API_USER` `apikey: YOUR_API_KEY` This applies to both **sandbox** and **live** environments. ## Security & Responsibility Your `apiuser` and `apikey` combination is essentially your **username and password** for the Fapshi API. Never share them or expose them in client-side code (like in JavaScript running in the browser). You are **fully responsible** for any misuse of your credentials. Misuse of API credentials that results in violations of Fapshi's [Terms & Conditions](https://fapshi.com/en/terms-and-conditions) or [Privacy Policy](https://fapshi.com/en/privacy-policy) may lead to account suspension or permanent deactivation. *** Need help? Contact [support@fapshi.com](mailto:support@fapshi.com) or visit our [Help & Support Center](https://fapshi.com/en/help-and-support). # Live vs Sandbox Environment Source: https://docs.fapshi.com/en/api-reference/preliminary-knowledge/environment Understand the difference between Fapshi’s test (sandbox) and live environments, and how to switch between them securely. *** Fapshi provides two separate environments for developers: * **Sandbox (Test) Environment** * **Live (Production) Environment** Each environment is designed to serve a specific purpose and requires its own credentials and base URL. ## 1. Sandbox Environment (Test Mode) The **Sandbox environment** is used for testing and development. It allows you to explore how the Fapshi API works **without using real money**. Although no real transactions occur, the API behaves **exactly like the live environment**, ensuring a seamless transition from testing to production. ### Key Features * No real funds involved * Identical API behavior as live * Separate credentials and base URL * Ideal for development and integration testing ### Sandbox Base URL [https://sandbox.fapshi.com](https://sandbox.fapshi.com) ### Simulating Payments When testing local payment methods (e.g., Mobile Money), you can **simulate success or failure** depending on the number used. ### Test Numbers Table
Status Provider Test Numbers
✅ Success MTN Cameroon 670000000, 670000002, 650000000
Orange Cameroon 690000000, 690000002, 656000000
❌ Failure MTN Cameroon 670000001, 670000003, 650000001
Orange Cameroon 690000001, 690000003, 656000001
If you use any number **not listed above**, the transaction outcome will be determined randomly. ## 2. Live Environment (Production Mode) The **Live environment** is where real transactions happen. To use this environment: * You must have an [activated account](/en/guides/getting-started/activate-account) * You must [create a service](/en/api-reference/create-a-service) * You will receive unique **Live API credentials** for each service ### Live Base URL [https://live.fapshi.com](https://live.fapshi.com) **Live API keys are sensitive.** You’ll only see your `apikey` once, so copy and store it safely. You can generate a new key if compromised — this will immediately revoke the old one. ## Switching From Sandbox to Live When moving your application from testing to production: 1. **Replace your Sandbox credentials** (`apiuser` and `apikey`) with your **Live credentials** 2. **Switch the base URL** from: `https://sandbox.fapshi.com` to `https://live.fapshi.com` 3. **Double-check** your integration for live readiness Once you switch to the live environment and update your credentials and base URL, you're good to go! *** Need help? Reach out to [support@fapshi.com](mailto:support@fapshi.com) or visit our [Help & Support Center](https://fapshi.com/en/help-and-support). # Request Status Source: https://docs.fapshi.com/en/api-reference/preliminary-knowledge/request-status Understand how Fapshi API handles successful and failed requests, including response codes and formatting guidelines. *** When interacting with the **Fapshi Payment API**, it’s important to understand how the system responds to different types of requests. This helps in properly handling errors and managing successful transactions within your application. ## ✅ Successful Requests Any successful request made to the API will return an HTTP **status code of `200`**, indicating that the operation was processed correctly.\ The content of the response body will vary depending on the endpoint you called, but you can always expect structured data in a JSON format. **Example response for a successful request:** ```json theme={null} { "message": "Request successful", "link": "https://checkout.fapshi.com/payment/685ac112ea66cd72c5e6cf1e", "transId": "ll7J2fl4", "dateInitiated": "2025-06-25T11:34:04.450Z" } ``` ## ❌ Failed Requests If something goes wrong, Fapshi will return a **4XX HTTP error code**, depending on the nature of the issue: * **400** – Bad Request (e.g., missing or malformed parameters) * **403** – Forbidden (e.g., invalid credentials) * **404** – Not Found (e.g., resource doesn’t exist) * **429** – Too Many Requests (e.g., rate limit exceeded) The body of the response will always contain a `message` field that gives a clear explanation of the failure reason. **Example error response:** ```json theme={null} { "message": "Invalid API credentials" } ``` Make sure to always read the `message` field of the response to determine the reason for failure and guide your debugging process. ## IP Whitelisting If one or more IP addresses are whitelisted on the Fapshi dashboard, only servers using those IPs can make transaction creation requests: * [Generate a payment link](/en/api-reference/endpoint/initiate-pay) * [Initiate direct pay](/en/api-reference/endpoint/direct-pay) * [Make a payout](/en/api-reference/endpoint/payout) When one or more IP addresses are whitelisted, a transaction creation request from a server whose IP is not on the whitelist receives a **403** response—even if your API credentials are valid. This applies only to the transaction creation endpoints listed above; other API requests are not subject to IP whitelisting. If your server's IP address changes frequently, it is preferable not to whitelist any specific IP address. IP whitelisting is a security measure that prevents unrecognized servers from creating transactions using your API credentials. ## 🔁 Request Formatting Guidelines To avoid unexpected failures, keep in mind the following formatting rules: * All request bodies must be **JSON encoded**. * **GET requests must not contain a body**. If you include a body in a GET request, the API will immediately return an error. You can find SDK implementations of all API endpoints in different programming languages in our [GitHub SDK repository](https://github.com/Fapshi/SDKs). *** Need help? Contact us at [support@fapshi.com](mailto:support@fapshi.com) or visit our [Help & Support Center](https://fapshi.com/en/help-and-support). # Activate your Account Source: https://docs.fapshi.com/en/guides/getting-started/activate-account How do I activate my Fapshi account? You can no longer test the Fapshi API in test mode without activating your account. Read this [Essential points before continuing](https://www.fapshi.com/en/help-and-support/essentials-to-note-when-submitting-your-fapshi-account-activation-request). *** ## Steps to Activate Your Fapshi Account 1. **Log in to your Fapshi Dashboard**: Go to [Fapshi Dashboard](https://dashboard.fapshi.com) and log in with your credentials. 2. **Navigate to Settings**: Click the **Account tab**. If you're using the mobile app, navigate to **Settings** and the tap **"Activate Account"**. 3. **Complete KYC Verification**: Fill in the required information for KYC (Know Your Customer) verification. This will include uploading identification documents and providing business information. Read this guide well so you fill the details correctly [https://www.fapshi.com/en/help-and-support/essentials-to-note-when-submitting-your-fapshi-account-activation-request](https://www.fapshi.com/en/help-and-support/essentials-to-note-when-submitting-your-fapshi-account-activation-request) 4. **Submit for Review**: Once you have completed the KYC form, submit it for review. You will receive a notification once your account is activated. Account activation is usually completed within 48 hours or less. If you do not receive an email stating whether or not your account has been activated after the said time, please, [contact support](https://wa.me/237658610472). 5. **Start Receiving Payments**: After your account is activated, you can start receiving live payments through Fapshi. We recommend you test your integration in the [Sandbox](/en/api-reference/preliminary-knowledge/environment#1-sandbox-environment-test-mode) before going live. Also, **you may have to logout and login to your account to see the changes**. ## Additional Information * For the ID, we only accept **JPG, JPEG,** and **PNG** picture formats; make sure your pictures are in any of these formats. If they're not, you could use [Image Online Converter](https://image.online-convert.com/convert-to-png) to convert them into any of the formats listed above. Also, please ensure the pictures are clear enough such that one can effortlessly see the details on them. * If you're using an ID receipt, ensure to submit the part where the validity was extended (back of ID). For reference, the following is a list of valid IDs in decreasing order of preference: * Cameroonian National ID Card * Cameroonian Passport * Cameroonian ID Card receipt The submitted document must be valid at the time of submission. We DO NOT ACCEPT any other ID documents or expired IDs. * Your business name is a unique identifier for your business. **Be sure to use the correct name as you will not be able to change it later**. Also, include a valid physical address that can be traced; ideally, this address will contain a street (neighborhood) and city. We advise that you put a phone number that can be contacted on WhatsApp. ## Troubleshooting **Solution:** This error usually occurs when the image you uploaded is not in a supported format or is too large. The supported formats are JPG, JPEG, and PNG. If you see a red image name, it means the image is not valid. Please ensure that your images are in one of the supported formats and are not too large. **Solution:** Check your spam or junk folder or refresh your inbox. If you still do not find an email, [contact support](https://wa.me/237658610472). # Create an account Source: https://docs.fapshi.com/en/guides/getting-started/create-account Start integrating payments in under 3 minutes Creating an account on Fapshi is **simple and FREE**. With an account, you can **access ALL Fapshi products** and start receiving payments. ## Steps 1. **Visit the Signup Page**: Go to [The Signup page](https://dashboard.fapshi.com/auth/signup) or download the Mobile App for [Android](https://play.google.com/store/apps/details?id=com.fapshi) or [iOS](https://apps.apple.com/ng/app/fapshi/id6443700859) and fill in your **username**, **email**, **phone number**, and **password**. * If you are using the mobile app, tap on **"Don't have an account? Sign up"** to register. Note the following when creating your account: * Your username must have a minimum of 4 characters and a maximum of 40 characters, usernames can only have letters, numbers, underscores, hyphens, and spaces. * All payment receipts and relevant information on Fapshi are sent to your email, so, make sure you provide a valid email, preferably one you use very often. * We advise that you use your WhatsApp phone number for registration. * Your password must be at least six characters long. 2. **Verify your Email**: To be sure that your email is valid, you will receive a verification email with a verification code. Copy and paste this code in the email verification box to verify your email address. Once this is done, you will be redirected to the login page. * If you do not receive the verification email, check your **Spam folder**. If you're using an iPhone, check the **Junk folder**. When you copy the code, please report the email as **"not spam"** so that subsequent Fapshi emails appear in your inbox instead. * If you still do not receive the email, you can request a new verification code by clicking on the **"Resend Code"** button on the Email Verification page. **DO NOT SKIP THE EMAIL VERIFICATION STEP!** If you do not verify your email, you will not be able to log in to your account. Once your account is created, you can log in to [The Fapshi Dashboard](https://dashboard.fapshi.com). If after five attempts you are unable to sign in, you won't be able to do so until after one hour. Thus, use the [**Forgot Password**](https://dashboard.fapshi.com/forgot-password) option in case you forget your password. This is to prevent phishing attacks on your account. # Mobile App Source: https://docs.fapshi.com/en/guides/getting-started/mobile-app How do I use the Fapshi mobile app? *** Fapshi offers a mobile application for both [iOS](https://apps.apple.com/ng/app/fapshi/id6443700859) and [Android](https://play.google.com/store/apps/details?id=com.fapshi) devices. Use the app to view business metrics, track and manage payments and customers, transfer funds between services, and initiate payouts. You can also create payment links, and more. Fapshi Mobile App ## Download the Mobile App You can download the Fapshi mobile app from the following links: * [iOS on App Store](https://apps.apple.com/ng/app/fapshi/id6443700859) * [Android on Google Play](https://play.google.com/store/apps/details?id=com.fapshi) ## Features of the App The app is available in English and French, and automatically defaults to the device language set in your system preferences. If you don't yet have a Fapshi account, you can create one directly from the app. | | | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Monitor your business | | | Accept payments | | | Manage payments | | | Payouts | | | Account Settings | | ## Limitations The app is mostly for monitoring and managing your Fapshi account and payments. [Developer features](/en/api-reference/) are not available in the app. You can use the [web dashboard](https://dashboard.fapshi.com) for more advanced features like API access, webhooks, and more. However, you can monitor payments, make payouts and more with the app. Also, most [No-code solutions](/en#2-no-code-solutions) are available in the app. ### Push Notifications Push notifications are messages sent directly to a user’s device from a mobile app. To enable push notifications from the app, you must allow notifications from Fapshi in the settings of your phone. You can customize which notifications you want to receive in the app settings. You can activate or deactivate notifications for payments to your services. To do this, go to **Services**, select the service, and toggle the notifications on or off. Types of notifications include: * New payments (for payment links, event tickets, and services) * Successful payouts * Company updates/information * Successful transfers ### Accept Payments The app allows you to manage payment links, voting contests, and sell event tickets online, view their details, and track their performance. To create a payment link, go to the **"Payment Links"** section, select the kind of link you want to create and fill in the required details. You can set the amount, description, and other parameters. If you don't know which kind of link to select, check the [Payment links](/en/guides/no-code-solutions/payment-links) section. For event tickets, go to the **"Event Ticketing"** section and tap Create Event. Fill in the title and ticket categories (all other fields are optional) and submit. The same procedure applies for Voting contests. Tap on a payment link, contest, or event to share the link, view its details, edit, or track its performance. ### Manage Payments You can manage payments from the **Balances/Services** screen of the app. Select this tab to view all your services. From there, you can view your service balances, transfer funds between services, and view the transactions for a particular service. To withdraw the money in your service, you have to transfer it to your main balance. ### Payouts You can initiate payouts from the **Payouts** section of the app. Here, you can view all your payout transactions, including their status and details. To initiate a new payout, select the method **(MoMo, OM, or bank account)**, fill in the amount, PIN, and confirm. Funds withdrawn via MTN MoMo or Orange Money are received instantly, while bank transfers may take up to two working days. ### Account Settings You can configure basic account settings directly from the app. This includes setting your Fapshi PIN, submitting account details for activation, editing your profile, setting up two-step verification, and contacting support. Visit our [Help and Support center](https://fapshi.com/en/help-and-support) for guides on how to perform any of these actions. # Balances Source: https://docs.fapshi.com/en/guides/managing-payments/balances Understand how Fapshi balances work, including service-specific balances and your main wallet balance. *** Fapshi gives you the possibility to manage your funds in the easiest way possible. Whether you're using the platform as a merchant or for personal purposes, understanding how your balances are structured is essential. If there are any disputes on your account, they will also appear on this page. ## Balance Structure There are two types of balances on Fapshi: 1. **Main Wallet Balance** 2. **Service-specific Balances** ### Main Wallet Balance This is your **default wallet**. All payments received through **no-code solutions** such as: * [Payment Links](/en/guides/no-code-solutions/payment-links) * [Invoices](/en/guides/no-code-solutions/invoicing) * [Event Ticketing](/en/guides/no-code-solutions/event-ticketing) * [Voting Contest](/en/guides/no-code-solutions/voting-contest) * [Products and Stores](/en/guides/no-code-solutions/products) ...are recorded in your **Main Wallet Balance**. You can view your wallet balance directly from the **Balances** tab on the Fapshi Dashboard or Mobile App. ### Service-Specific Balances If you're a developer or merchant using Fapshi services programmatically (via APIs, Plugins, or SDKs), each **service you create** has its own dedicated balance. These balances are **independent**, meaning: * Each service receives its own payments * You can view the balance for each service separately * You can **transfer funds** between services (useful for cash-in-pay-out use cases) or to your **main wallet balance** for withdrawal. This structure makes it easier to separate finances across different projects or use cases. To withdraw money from your service, you must transfer the money into your main balance. ## How to View Your Balances You can view both your **Main Wallet Balance** and your **Service-specific Balances** from the Balances/Servicess tab: * On Web: Go to **Dashboard > Balances** * On Mobile: Tap the **Balances/Services** tab at the bottom of the app Each service or balance will be listed along with its total funds and a history of recent transactions. ## Moving Funds Between Balances You can **transfer funds**: * From one service to another * From a service to your **Main Wallet Balance** (for payout) To do this: 1. Open the **Balances** tab 2. Tap on the service you want to transfer from 3. Tap **Transfer** 4. Select the destination and amount 5. Confirm using your Fapshi PIN If you want to withdraw money you've collected via a service, you must transfer the funds into your main wallet balance. ## Notes * Balances are displayed in **XAF (FCFA)**. * You can withdraw your funds at any time via [Payouts](/en/guides/managing-payments/payouts). *** Need help? Contact [support@fapshi.com](mailto:support@fapshi.com) or visit our [Help & Support Center](https://fapshi.com/en/help-and-support). # Bulk Payments Source: https://docs.fapshi.com/en/guides/managing-payments/bulk-payments Send money to multiple mobile money accounts at once with just a click using Fapshi Bulk Payments. *** Fapshi allows you to **send money to multiple recipients** at once through mobile money — ideal for salaries, stipends, group disbursements, project payouts, or financial aid. With just a few simple steps, you can disburse funds in bulk with a single click. Bulk Payments are available directly from your dashboard. All payments are made instantly to recipients' MTN Mobile Money accounts. ## How Bulk Payments Work Follow these steps to disburse funds in bulk: ### Step 1: Top Up Your Fapshi Account Before making any payments, ensure your account has enough funds to cover the total amount to be sent. * Go to the **Topup** section of your dashboard. * Add funds equal to or greater than the total disbursement amount. You can top up using MTN Mobile Money, Orange Money, or via a bank transfer/deposit. ### Step 2: Prepare the Recipient List Download the **CSV template** provided in the **Bulk Payments** section. Fill in the required fields for each recipient: * Full Name * Mobile Money Number * Amount to be sent Ensure all numbers are valid and registered under MTN Mobile Money. ### Step 3: Upload and Pay Once your CSV file is ready: 1. Go to **Balances > Bulk Payments** 2. Upload the completed CSV file. You can download a sample CSV file from the dashboard and just fill it. 3. Click the **Make Payment** button and confirm with your Fapshi PIN. If your balance is sufficient, the money will be sent automatically to each recipient listed in the file. You’ll see a confirmation message and can track the status of each payment directly on the dashboard. ## Features & Benefits * ✅ Instant transfers to multiple mobile money accounts * 💼 Perfect for salaries, project funding, and bulk disbursements * 🧾 CSV format makes managing large recipient lists easy * 📄 Downloadable transaction reports for record-keeping *** Need assistance? Contact [support@fapshi.com](mailto:support@fapshi.com) or visit our [Help & Support Center](https://fapshi.com/en/help-and-support). # Payouts Source: https://docs.fapshi.com/en/guides/managing-payments/payouts Learn how to withdraw funds from your Fapshi account using the Payouts feature. *** You can withdraw money from your Fapshi account at any time using the **Payouts** feature. Whether you're using Fapshi as a business or for personal transactions, payouts are how you move your funds to a mobile money or bank account. Payouts are free, and you can withdraw funds **24/7** — anytime, any day. ## How to Do a Payout Follow these steps to initiate a payout from your dashboard: **Step 1:** Log into your dashboard and go to **Balances > Payouts** **Step 2:** Click the **“Make a Withdrawal”** button at the top right. **Step 3:** Fill in the necessary details: * Select the destination (MTN MoMo, Orange Money, or bank account) * Enter the amount you wish to withdraw * Enter your **Fapshi PIN** * You can optionally add a note for reference * Confirm the transaction To do a payout, you need to have a Fapshi PIN.\ If you haven't set one yet, check our [guide to set your PIN](https://fapshi.com/en/help-and-support/how-to-set-your-fapshi-pin).\ Forgot your PIN? See [what to do here](https://fapshi.com/en/help-and-support/forgot-pin). **Step 4:** Once confirmed, the transaction will be processed, and the payout will appear under your **Payouts** page. Your **account balance will be updated** accordingly. ## Requirements * Your **Main Wallet Balance** must be **greater than or equal** to the amount you want to withdraw. * You must have **Set your Fapshi PIN** to approve payouts. ## Notes * ✅ Payouts are processed instantly via MTN MoMo and Orange Money. * 🏦 Bank transfers may take up to **2 working days**. * 💡 You can always view the full history of your payout transactions in your dashboard or app. *** Need help? Contact us via [support@fapshi.com](mailto:support@fapshi.com) or visit our [Help & Support Center](https://fapshi.com/en/help-and-support). # Topping Up Your Balance Source: https://docs.fapshi.com/en/guides/managing-payments/topups Learn how to add funds to your Fapshi main wallet or service balance using Mobile Money, float transfer, bank deposit, or transfers from your main wallet. *** WE ADVISE THAT YOU TOP UP THROUGH THE [FAPSHI MOBILE APP](https://fapshi.com/en/mobile-app). So, the steps below are for the mobile app. Keeping funds in your Fapshi account allows you to make payouts, fund services, and manage your business more efficiently. You can top up either your: 1. **Main Wallet Balance** 2. **Service Balance** Top ups are typically processed within a few hours and, in most cases, no later than one business day. If it delays, [contact support](https://wa.me/237658610472). ## Top Up Methods Fapshi supports the following top up methods: * **Mobile Money/Float transfer** * **Bank deposit** When you request a top up, Fapshi will display the payment details required for your selected method. ## Topping Up Your Main Wallet Your **Main Wallet Balance** can be used for payouts and transfers to your services. To request a top up: 1. Open the **Manage Funds** tab. 2. Select **Topups**. 3. Tap **Request a Top Up**. 4. Enter the amount you want to top up. 5. Review the payment instructions displayed. 6. Complete the transfer using Mobile Money, Float, or Bank Deposit. 7. Upload your proof of payment. 8. Submit your request. You'll receive an email once your top up has been verified and your wallet has been credited. ## Topping Up a Service There are two ways to fund a service. ### Option 1: Deposit Funds into the Service This method allows you to deposit funds directly into a service. To do so: 1. Open the **Services** tab. 2. Select the service you want to fund. 3. Tap **Topup Funds into this Service**. 4. Enter the amount you want to top up. 5. Review the payment instructions displayed. 6. Complete the transfer using Mobile Money, Float, or Bank Deposit. 7. Upload your proof of payment. 8. Submit your request. You'll receive an email once your top up has been processed. ### Option 2: Transfer Funds from Your Main Wallet If you already have funds in your Main Wallet Balance, you can instantly transfer them to any service. To do so: 1. Open the **Services** tab. 2. Select the service you want to fund. 3. Tap **Topup Funds into this Service**. 4. Select **Topup from Main Balance**. 5. Enter the amount. 6. Confirm the transfer using your Fapshi PIN. Transfers from your Main Wallet Balance to a service are processed instantly. ## Processing Time Most top up requests are completed within a few hours and, in all normal circumstances, within one business day. If your top up has not been processed after one business day, please [contact support](https://wa.me/237658610472) and include your proof of payment for faster assistance. ## Notes * Top ups are available for both your **Main Wallet Balance** and individual **Service Balances**. * Payment instructions are generated when you submit a top up request. * Always upload a clear proof of payment to help speed up verification. * All balances are displayed in **XAF (FCFA)**. *** Need help? Contact [support@fapshi.com](mailto:support@fapshi.com) or visit our [Help & Support Center](https://fapshi.com/en/help-and-support). # Event Ticketing Source: https://docs.fapshi.com/en/guides/no-code-solutions/event-ticketing Create events, track bookings, and sell event tickets and registration online through Fapshi *** Fapshi empowers you to sell your event tickets online via a link that shows your event details and ticket categories. Interested persons can select a ticket category and quantity and pay directly online. They'll receive a receipt of payment, while you'll have access to all bookings directly on your Fapshi dashboard or mobile app. ## How to Create an Event **Step 1:** Log into your dashboard and navigate to **Collections > Events**. **Step 2:** Click the "Create an event" button at the top right. **Step 3:** Fill in the required details and confirm. You have to add the different ticket categories and their prices. Insert how much you want to receive in the "Income field" (Revenue field on the Mobile App) and the amount for the category will be generated automatically for you. Save the spot category to add another or proceed. Even though it's optional, we recommend adding the event flyer, date, time, and location. These make the event page more UI friendly and informational. Event creation **Step 4:** Your event link & code will be generated and you can copy and share them! ## How to Book Tickets If you tap the event link, it will open the event page. Event page The booking process can be divided into three simple steps: ### Step 1: Select the ticket category Select the ticket category and insert the quantity of tickets you want to buy. ### Step 2: Fill in your information Fill in your Name, Email, and Payment number **(This is the number of the MTN MoMo or Orange Money account the money will be deducted from)**. Ensure you have enough money in your account to pay for the tickets, else, the transaction will fail. Also, you must select a ticket (spot) category to proceed. ### Step 3: Payment Confirm payment by tapping the **Pay Now** button. Once you do, a popup will appear on your phone to fill in your MoMo or OM PIN. Do so to confirm payment. If the transaction is successful, a receipt of payment will be generated which will serve as your digital ticket. You can download it and keep for reference. You will also receive an email. ## How to Check Bookings All transactions (failed or successful) will appear on your Fapshi dashboard. Fapshi provides you with out-of-the-box booking management so that you can focus on the event proper. You can download all the bookings as **PDF** or **Excel sheet** and use this for check-ins. Event bookings If you're using the mobile app, the steps are the same. Open the **Collections** tab, select **Event ticketing** or tap **Event ticketing** on the home screen and follow the same steps. # Invoicing Source: https://docs.fapshi.com/en/guides/no-code-solutions/invoicing Create simple or advanced invoices with Fapshi and send them to your clients via email. Collect payments online, track invoice status, and automate receipts. *** Fapshi permits its users to create invoices for their clients; invoices serve as proof of payment. You can create a **simple invoice** showing the amount to be paid and a note for the client, or an **advanced invoice** including items, their quantities, prices, and total. Creating any of these will generate an invoice that will be automatically sent to your client's email. ## How to Create a Simple Invoice A simple invoice permits both you and your client to have proof of payment. Here's how you would create one: **Step 1**: Log into your dashboard and navigate to **More > Payments > Invoices**. **Step 2**: Click the "Create an invoice" button at the top right and select "Simple invoice". **Step 3**: Fill in the required details, you can leave the note field empty if you don't see the need to leave your client a message. Should you need to provide more details, such as the items, their prices, etc, create an [Advanced Invoice](#how-to-create-an-advanced-invoice) instead. Simple invoice **Step 4**: Your invoice will be generated and sent to the client's email. **Step 5**: When your customers click on the payment link on the invoice, the Fapshi payment page will be displayed for them to pay. **Step 6**: When your client pays, he/she will receive a payment receipt through his/her email and can download the receipt. We have implemented action items to help you handle invoicing on Fapshi. The invoice page on your dashboard displays a list of all invoices you've created, each having an action button at the extreme right. Click on it and explore the options! ## How to Create an Advanced Invoice With advanced invoices, you can include as many items as necessary, their quantities and unit prices to the invoice. Basically, the advanced invoice conveys more information to the client. Below are the steps to create one: **Step 1**: Log into your dashboard and navigate to **More > Payments > Invoices**. **Step 2**: Click the "Create an invoice" button at the top right and select "Advanced invoice". **Step 3**: Fill in the required details, add and save as many items as is needed for the invoice. You can leave the note field empty, if you don't see the need to leave your client a message. If it is not necesary to include items in your invoice, create a [Simple Invoice](#how-to-create-a-simple-invoice) instead. Advanced invoice **Step 4**: Your invoice will be generated and sent to the client's email. **Step 5**: When your customers click on the payment link on the invoice, the Fapshi payment page will be displayed for them to pay. **Step 6**: When your client pays, he/she will receive a payment receipt through his/her email and can download the receipt. If an invoice has been paid for, you cannot edit or send a reminder for it. However, you can duplicate or resend it. Check out these actions, how they work, and when to use them in the [Help & Support Center](https://fapshi.com/en/help-and-support). # Payment Links Source: https://docs.fapshi.com/en/guides/no-code-solutions/payment-links What are Payment Links and how can I use them? *** No need to have a website to start selling online! Simply create a Fapshi payment link and send to your customers to instantly receive your payment. Fapshi currently allows you to create payment links and donation links. Each of these links have different use cases for which they are best suited. See the [How to know which link to choose](https://www.fapshi.com/en/products/payment-links) section below for details: ## Donation Link This is best suited for donations, crowdfunding, group contributions, njangi's, and any form of payment that involves more than one person paying. ### How to Create a Donation Link **Step 1:** Log into your dashboard and navigate to **Collections > Donations**. **Step 2:** Click the "Create Donation link" button at the top right. **Step 3:** Fill in the required details; you can select a fixed amount for the donation or select the "let the donor decide" option so the donor can decide what amount to donate. Even so, you can optionally set a minimum amount for the donation. If you select the "Show donations" option, donors will be able to see those who have donated or contributed before them, the date/time, and the amounts paid. Donation Link creation **Step 4:** Your payment link will be generated and you can copy and share with your donors! **Step 5:** When donors click on the link, the Fapshi payment page will be displayed for them to pay. **Step 6:** When someone pays, he/she will receive a payment receipt through his/her email and can download the receipt. If you're using the mobile app, the options are the same. Open the **Collections** tab, select **Donations** and follow the same steps. ## Payment Link Perfect for one-time payments, subscriptions with fixed prices, webinar fees, etc. ### How to Create a Payment Link **Step 1:** Log into your dashboard and navigate to **Collections > Family & Friends**. **Step 2:** Click the "Create a link" button at the top right. **Step 3:** Fill in the required details; you must input an amount. If you want to collect money for contributions, you should create a [Donation Link](#donation-link) instead. Simple Link creation **Step 4:** Your payment link will be generated and you can copy and share with your client! **Step 5:** When someone clicks the link, the Fapshi payment page will be displayed for them to pay. **Step 6:** When your client pays, he/she will receive a payment receipt through his/her email and can download the receipt. If you're using the mobile app, the options are the same. Open the **Collections** tab, select **Payment Link** and follow the same steps. *** The minimum amount that can be paid through a payment link is **500 FCFA**. You could set an expiry date after which no one could make payments through the payment link. We charge a fee for payments made through payment links. Visit our [Pricing Calculator](https://fapshi.com/en/pricing#pricing-calculator) to see how much you'll be charged for the amount paid. # Products Source: https://docs.fapshi.com/en/guides/no-code-solutions/products Create and sell products easily using Fapshi’s payment link system. Manage your listings, share links, and collect payments directly on the platform. *** A product is anything you want to sell or be paid for; it could be electronics, fashion items, books, services, etc. Fapshi gives you the possibility to create products and sell them through a payment link. All payments are made directly on the platform, and can be seen on your dashboard. You can withdraw your funds at anytime through a [Payout](/en/guides/managing-payments/payouts). ## How to Create your Product **Step 1**: Log into your dashboard and navigate to **More > Store > Products**. **Step 2**: Click the "Add a Product" button at the top right. **Step 3**: Fill in the required details; make sure to upload a picture of your product. You can also add more pictures of the product by uploading to the product gallery. On Fapshi, you cannot post products whose prices are less than **500 FCFA**. Also, the following product names are forbidden, i.e., you can't give your products these names: **"fapshi", "pending", "invoice", "donation", "payment link"**. **Step 4**: Your product will be created; you can see its details on the Products page on your dashboard, from where you can copy and share its link. You can add your products to your store (a unified view for your products). You can also preview your products, edit, or delete them. **Step 5**: When your customers click on the product link, the product view and payment portal will be displayed from where they can pay. **Step 6**: When your client pays, he/she will receive a payment receipt through his/her email and can download the receipt. We charge a fee for product purchases. Visit our [Pricing Calculator](https://fapshi.com/en/pricing#pricing-calculator) to see how much you'll be charged for the amount paid. # Stores Source: https://docs.fapshi.com/en/guides/no-code-solutions/stores Create your own store on Fapshi and showcase all your products in one place. Let customers browse, add to cart, and place orders easily via a simple link. *** Your store is a unified view of products which you add to it. With a store, people can see all your products in one place. However, you need to activate your account to own a verified store – it's free! ## How to Add Products to your Store Anyone who visits your store can add any of your products to their cart, and place an order. You'll be able to see this on the "Orders" section of your dashboard. This is how to setup your store: **Step 1**: Log into your dashboard and navigate to **More > Store > Store**. **Step 2**: Click on the pen icon to edit your vendor (store) credentials (logo, phone number, address, description, etc). **Step 3**: Access your products page and add products to your store. **Step 4**: Copy your store's link and share so your customers can order your products. Treat Your Customers Well! Your customers can review, rate, or report your store. Their ratings on your store matter a lot because others will be compelled to buy from you if you're rated high, hence, endeavour to serve your customers well. Encourage your satisfied clients to leave a review and rating to boost your sales. If your store is reported, we will verify the claims and take appropriate actions. However, to avoid being reported, serve your customers well! **Step 5**: When your customers access your store's link, they'll be able to add products to a cart and place an order. When they do so, you will receive a notification on your dashboard and an email. Every order placed for products from your store will appear under the "Orders" section on your dashboard. You will also receive a notification. You have to confirm the orders before they can pay. Also, endeavour to deliver products to your clients in the shortest time possible for better customer service. **Step 6**: Visit the **Orders** section of your dashboard to confirm their orders. It is also important that you discuss with the customer. When you confirm the order, an invoice will be sent to them. The invoice contains a payment link. The link will open a portal where they can fill in their payment details. Step 7: When your client pays, he/she will receive a payment receipt through his/her email and can download the receipt. Be careful what you post! If your product(s) is(are) judged to violate our [Terms & Conditions](https://fapshi.com/en/terms-and-conditions), we will block your account and you will not be able to withdraw your funds. So, make sure you read and follow our [Terms & Conditions](https://fapshi.com/en/terms-and-conditions#section-1) on what you can't sell on Fapshi. If your store is reported, we will freeze your account until you are able to justify yourself against the claims. # Voting Contest Source: https://docs.fapshi.com/en/guides/no-code-solutions/voting-contest Organize paid voting contests online through Fapshi *** Fapshi empowers you to host paid voting contests online via a link that shows your contest details and contestants. Voters can vote for their favorite contestants by paying a fee. They'll receive a receipt of payment, while you'll have access to all votes directly on your Fapshi dashboard or mobile app. ## How to Create a Contest **Step 1:** Log into your dashboard and navigate to **Collections > Contest**. **Step 2:** Click the "Create contest" button at the top right. **Step 3:** Fill in the required details and confirm. You can choose to add the contestants and at the time of creating the contest or later. Insert the price per vote and proceed. **Step 4:** Your contest will be generated and you can copy and share the link, together with linnk for each contestant! ## How to Vote If you tap the contest link, it will open the contest page. The voting process can be divided into three simple steps: ### Step 1: Select the contestant Select the contestant you want to vote for and insert the number of votes you want to cast. ### Step 2: Fill in your information Fill in your Name, Email, and Payment number **(This is the number of the MTN MoMo or Orange Money account the money will be deducted from)**. Ensure you have enough money in your account to pay for the votes, else, the transaction will fail. ### Step 3: Payment Confirm payment by tapping the **Vote Now** button. Once you do, a popup will appear on your phone to fill in your MoMo or OM PIN. Do so to confirm payment. If the vote is successful, a receipt of payment will be generated which will serve as your digital ticket. You can download it and keep for reference. You will also receive an email. ## How to Check Votes All votes (failed or successful) will appear on your Fapshi dashboard. Fapshi provides you with out-of-the-box voting management so that you can focus on the contest proper. You can download all the votes as **PDF** or **Excel sheet**. If you're using the mobile app, the steps are the same. Open the **Collections** tab, select **Voting Contest** or tap **Voting contest** on the home screen and follow the same steps. # WooCommerce Source: https://docs.fapshi.com/en/guides/third-party-integrations/woocommerce Easily integrate Fapshi with your WooCommerce store to accept payments without writing any line of code. *** If you have a WooCommerce store, you can integrate with Fapshi with no coding required! All you'll need is an activated Fapshi account. * If you don't have a Fapshi account, you can [sign up here](https://dashboard.fapshi.com/auth/signup) * If you have an account but haven't activated it yet, [follow this guide](/en/guides/getting-started/activate-account) to activate your account. - MTN Mobile Money - Orange Money ## Installing Fapshi on WooCommerce ### Requirements * Create a service and obtain your [Fapshi API Keys](/en/api-reference/create-a-service) * Install [WooCommerce](https://woocommerce.com/) in your WordPress website * PHP version: 5.6.0 - 8.1.0 #### Recommended * Latest WordPress version * PHP 5.6 or greater * MySQL 5.6 or greater ### Automatic Installation * Login to your WordPress Dashboard. * Click on **“Plugins > Add New”** from the left menu. * In the search box, type **Fapshi Woocommerce**. * Click on Install Now on **Fapshi Woocommerce** to install the plugin on your site. * Confirm the installation. * Activate the plugin. * Click on **“WooCommerce > Settings”** from the left menu and click the “Checkout” tab. * Click on the **Fapshi link** from the available Checkout Options * Check the [Configuration section](#configuring-the-plugin) to Configure your **Fapshi Woocommerce** settings accordingly. ### Manual Installation 1. Download the plugin from [this GitHub repository](https://github.com/Fapshi/Plugins). **We've updated the plugin!** We recently updated the plugin for new versions of WordPress. Switch to the [wp-woocommerce branch](https://github.com/Fapshi/Plugins/tree/wp-woocommerce) to use the most recent version. If you're using an older version of WordPress, feel free to use the plugin in the [main branch](https://github.com/Fapshi/Plugins/tree/main). If you were already using the old version of the plugin and have updated your WordPress to the recent version, add this shortcode `[woocommerce_checkout]` to your **Checkout page** to keep using the old plugin. 2. Log into your WordPress Admin dashboard. 3. Navigate to **Plugins > Add New**, then click **Upload Plugin**. 4. Choose the downloaded ZIP file, then click **Install Now** and **Activate**. 5. Go to **WooCommerce > Settings > Payments**. 6. Click on **Fapshi** from the available checkout options. 7. Configure your **Fapshi WooCommerce** settings accordingly. ## Configuring the Plugin Available configuration options: * Enable or disable the Fapshi payment gateway * Toggle between test mode and live mode * Add your API Key and API User * Add a webhook To obtain a live API key and user, [create a service](/en/api-reference/create-a-service) and switch to it, then copy your Live API key and user. ## Best Practices * Always confirm the status of transactions using your Fapshi Dashboard. * Keep your API keys secure and private. * Update to the latest version of the plugin regularly. ## Support Need help? * 📧 [Contact Support](mailto:support@fapshi.com) * 💬 [Join our developer community on Slack](https://fapshicommunity.slack.com/join/shared_invite/zt-1dz7tl3kj-Wl_mdNxiiCI31i8mrVIrtQ#/shared-invite/email) * 🐦 Follow [Fapshi on LinkedIn](https://cm.linkedin.com/company/fapshiinc) [@fapshi on X](https://x.com/fapshi) ## Frequently Asked Questions ### 1. What do I need to use the plugin? A [Fapshi account](https://dashboard.fapshi.com/auth/signup). Make sure to activate your account. ### 2. Is the plugin free? Yes, it's 100% free. ### 3. What are the pricing fees? Check out our [Pricing & Fees](https://fapshi.com/pricing) page, or use the [Pricing Calculator](https://fapshi.com/pricing/#pricing-calculator) for accurate billing insights. ## Are You Writing Custom Code? Visit the [API Reference](/en/api-reference/) for advanced manual integration options. # Introduction Source: https://docs.fapshi.com/en/index Discover Fapshi’s API for online payments collection, disbursement, and transaction management. Get started with our guides and API references. **Start Here!** To integrate our API on your solution, check the [API Requisites](/en/api-reference/getting-started#prerequisites). If you already have a Fapshi account and have created a service, read the [Preliminary Knowledge Section](/en/api-reference/preliminary-knowledge). ## Welcome to Fapshi Hello! We're thrilled to welcome you to Fapshi, your trusted platform for seamless payments. Fapshi empowers businesses to effortlessly accept, manage, and disburse payments from customers. This documentation provides all the resources you need to integrate the Fapshi API into your website or app. Our documentation is divided into two key sections: Designed for both developers and non-developers, these offer insights into how payments are processed and provide a general integration & usage workflow. Dives deep into each endpoint. This is perfect for experienced developers or those familiar with payment integrations via code who want to explore our APIs directly. ## Overview Fapshi is a payment gateway that enables businesses to accept **MTN MoMo** and **Orange Money** payments online, offering a fast and secure way to collect funds from customers. #### Build a Seamless Payment Experience Provide your customers with a convenient payment option, boosting confidence and increasing conversion rates. #### Accept Payments on Any Platform Fapshi's tools are built to standard, allowing you to integrate payments on any technology stack that suits your business. #### Developers First We believe payments are a problem solved through code. As developers ourselves, we've crafted APIs that make integrating Fapshi's payment workflow into your business a breeze. ## Our Solutions Fapshi offers tailored payment solutions to simplify how your business accepts payments. Our products are categorized into three types to meet your specific needs: #### 1. Fapshi API The Fapshi API is designed for businesses that want to directly integrate payments into their website or app. It gives you full control over the user experience, allowing seamless integration with your systems and databases. #### 2. No-Code Solutions Accept payments without needing a website using these user-friendly tools accessible via the [Fapshi dashboard](https://dashboard.fapshi.com) or [Mobile App](https://fapshi.com/en/mobile-app): * **Links**: Create payment links and share them with customers through SMS, email, WhatsApp, or other messaging platforms to collect payments instantly. This is very useful for contributions, donations, njangis, etc. * **Event Ticketing**: Create and manage event tickets with payment links, enabling participants to book tickets directly online. * **Voting**: Collect payments for voting campaigns or polls, pageant contests, etc. * **Invoicing**: Generate professional invoices with embedded payment links, allowing customers to settle bills professionally. * **Stores**: Set up a digital storefront to sell products or services, seamlessly accepting payments. * **Products**: Manage and sell your products through customizable product pages, optimized for mobile money payments. * **Bulk payments**: Effortlessly send payments to multiple mobile money or Fapshi accounts at once just by clicking a button, ideal for payroll or mass disbursements. #### 3. Third-Party Plugins Fapshi offers plugins for seamless integration with e-commerce platforms like **WordPress WooCommerce** and other popular platforms (Coming soon). These no-code solutions enable you to start accepting payments in **less than 5 minutes**. ## Feedback and Support We value your input! If you have feedback about our documentation, products, or APIs, please [reach out to us](mailto:feedback@fapshi.com?subject=Suggest%20Edits%20to%20Fapshi%20Documentation\&body=Please%20describe%20your%20suggestions%20here.) or [suggest a feature](https://fapshi.com/en/suggest-feature). Your suggestions help us enhance our tools for a better user experience. For any questions not covered here, our support team is ready to assist via [Slack](https://fapshicommunity.slack.com/archives/C034Q50QB6U), [Email](mailto:support@fapshi.com), or [WhatsApp](https://wa.me/237658610472).