Integration Documentation

Introduction

This section describes the Payfaci JavaScript library for payment gateway.


Payfaci API is easy to implement in your business software. Our API is well formatted Javascript integration, returns JSON responses.

The JavaScript library designed to simplify the integration of payment popups into web applications. With it, developers can easily create customizable payment popups that can be triggered by user actions such as button clicks.

Supported Currencies

This section describes the currencies supported by Payfaci


Payfaci allows to make transaction with below currencies. Any new currency may update in future.

Currency Name Currency Symbol Currency Code
United States Dollar $ USD
USDT USDT
British pound sterling £ GBP
Naira NGN
EUROS EUR

Get The Api Key

This section describes how you can get your api key.


Please reach out to an administrator on Payfaci to obtain an API key. If you don't have any ? Click Here

Initiate Payment

This section describes the process of initating the payment.


To initiate the payment follow the example code and be careful with the perameters.

Request to the end point with the following parameters below.

Param Name Param Type Description
api_key string (50) Required Your API key
email string (50) Required Paying Customer's email.
currency code string (4) Required Currency Code, Must be in Upper Case. e.g. USD,EUR. check the table above for supported currencies
amount decimal Required Payment amount.
callback_url string (255) Required Callback URL to send status of transaction

Integration with JavaScript

To integrate your payment gateway with a custom JavaScript application, follow these steps:

  1. Add the following script tag to the head section of your HTML document.
  2. Map the payment popup to a button by adding an event listener to the button click event.

Here is an example of how to add the script and map it to a button:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>User's Website</title>
    <style></style>
    <script src="https://payfaci.com/assets/external/payfaci.js"></script>
  </head>
  <body>
    <div></div>
    <button
      id="openPaymentPopup"
      onclick="openPaymentPopup('client_id','client_secret','[email protected]', 'USD', 100, 'https://payfaci.com/callback_url')"
    >
      Pay with Payfaci
    </button>
  </body>
</html>
Callback_url data
{
  "status": 200,
  "paymentStatus": "success"
}
    

Integration with WooCommerce

To integrate your custom JavaScript-based payment gateway with WooCommerce, follow these steps:

Download the plugin here Download Payfaci Plugin

  1. Install and activate the WooCommerce plugin on your WordPress site.
  2. Click on Plugin, then Select Add New, Select Upload Plugin Button, Click on CHoose file to select the downloaded payfaci plugin.
  3. Once install click Activate to activate plugin
  4. Navigate to WooCommerce settings and click on the "Payments" tab.
  5. Click on Finish set up, Select the checkbox to enable Payfaci payment gateway, copy your API_KEY or Click Here to get one
  6. Changing Checkout Page

  7. Navigate to Pages on Wordpress Dashbaord
  8. Click on add new page and copy this shortcode
    [woocommerce_checkout]
  9. Click on woocommerce Setting, Navigate to Advance Tab and click
  10. Click on dropdown menu and select the new checkout page
  11. Scroll down and click on Save changes
  12. Confirm the cart total is same as the input order total in the input box then click on Pay with payfaci

Integration with Shopify

To integrate your payment gateway with Shopify, follow these steps:

  1. Log in to your Shopify admin panel and navigate to the "Online Store" section.
  2. Click on "Themes" and then click on the Three dots beside the customize button then select "Edit code."

In the searchbar type in Theme.liquid then add the script below to the head tag then save

<script src="https://payfaci.com/assets/external/shopify.js"></script>

After, search for the cart-template.liquid and add the script below just under the checkout button

  <button
    type="button" name="Payfaci" class="btn button-buy btn-lg btn-block"
  onclick="openPaymentPopup('CLIENTID', 'CLIENTSECRET', '{{cart.currency.iso_code}}', {{cart.total_price | divided_by: 100.0}}, 'cartDataJson')"
>
  Pay with Payfaci
</button> 

In this button, replace 'APIKEY', with your actual api-key the save

Then you can start receiving payments globally and the money will reflect in your Payfaci balance.

We may use cookies or any other tracking technologies when you visit our website, including any other media form, mobile website, or mobile application related or connected to help customize the Site and improve your experience. learn more

Allow