Welcome


To start integrating BoldWallet™, you need a boldwallet™ account.

SignUp now

We need two vital things which are Our Masterkey and Servicekey.

Lets get it...

  • On Boldwallet Dashboard, Goto Integrations and click Add application


  • Add Integrations





    PARAMETERS
    1. Caption
    2. Application URL: this the full application (e.g https://your url and not your url) of your url NB Boldwallet uses this url for confirmmation in case fallback when there is low network connectivity
    3. Application Return URL: this is the full URL where boldwallet returns the user after every transaction process .Be it cancelled transaction ,declined or successfull transaction. this is a compulsory field but Boldwallet does not apply this plugin transaction processing such as wordpress
    4. Who Pays the Charge: who bears the charge of the transaction
    5. Bank Reconciliation Bank
    6. Account Name Reconciliation Bank Name
    7. Account No Reconciliation Account no



  • Application Listing





    Upon Registeration of an application , the application is under test mode, but when you want to go live you can switch it to Live Mode
    Our Aim has been achieved, your Masterkey and Service ID has also been created

Validations Errors


Boldwallet™ Response is classified into three distinct variables

  1. "3" meaning Declined - this is returned when incorrect card details are sent (e.g wrong expiry date, cvv too short, invalid card number…), most of these errors can be determined before the cards are sent to the server/issuer.
  2. "2" meaning Cancelled - this is returned when the transaction is sent to the issuer but returns a message other than successful.
  3. "1" meaning success - this is returned when the transaction has succeeded.

Validation Errors

Validation errors will be sent in the format:

{
  status: "0",
  status_request :"0",
  information:"Result Found", message: "Validation error occured" ,
  CustomerFirstname: "" ,
  CustomerEmail : "",
  CustomerLastname: "" ,
  currency: "" ,
  Amount:"" }

The field can either be number ,expiry or cvv .

Failed

Charge errors will be sent in the format:

{
  status: "0",
  status_request :"0",
  information:"No Result Found",
  message: "Validation error occured" 
}

Success

The success response of the promise will be invoked for either a successful charge or one that requires authentication.

A successful charge will send a response that looks like this:

{
  status: "0",
  status_request :"0",
  information:"Result Found",
  message: "Validation error occured" ,
  CustomerFirstname: "" ,
  CustomerEmail : "",
  CustomerLastname: "" ,
  currency: "" ,
  Amount: "",
  bwuniqid:"",

}

 

Checkout


boldwallet.js makes it easy to collect card details on your page by redirecting to a 3D Secure link without having the information touch your server. We do this so that we will handle the complex payment flow and give you the details of the transactions after processing.

Useful links

Dependencies

  • HTML page with functional html tags

Step 0. Load Boldwallet.js

Boldwallet™ JS into your page

    <script src="https://bwalletpay.com/api/1.2/api.js"></script>

Step 1. Create the transaction

Before sending card details to boldwallet™.js, we expect you to initialize the transaction on your client side. Pass the customer's email, amount and any other relevant data to us, and we will redirect to 3D processor for card processing

// Initialize boldwalletObject object
 var boldpaidSetup = {
masterkey: "11619935",
servicekey: "BW13",
email: "charles@premiumesowp.com",
firstname: "EMEKA",
lastname: "EZEUKO",
description: "Description Desds",
phonenumber:"08068094681",
currency:"560",
amount:"100",
bwuniqid:"unique Transaction id ";
}
<button onclick="paynow()"> Paynow</button>

<form action="https://bwalletpay.com/processor/regtran" method="post">

<input type="text" name="description" required />

<input type="text" name="total" required/>
<input type="text" name="customerFirstName" required />
<input type="text" name="customerLastName" required/>
<input type="text" name="customerEmail" required/>
<input type="text" name="customerPhoneNumber" required/>
<input type="text" name="currency" required/>
<input type="text" name="servicekey" required/>
<input type="text" name="masterkey" required/>
<input type="text" name="bwuniqueid" required/>

<button type="submit">Submit</button></form>

 

After payment processing the processor takes the user back to clients return website url page.

Sample code available!

You will not need to worry about this too much, just download our sample javascript from https://github.com/PREMIUMESOWP/boldwallet then design the html screens for each type.

N.B: After succefull validation, its adviced to perform a check to confirm the status of the transacions as shown here

Boldwallet™ Button


Boldwallet button simply integrates with your website to show predefined forms as designed by boldwallet.

The boldwallet_button must be defined to capture the necessary functions and contains 4 different currency selections

 

Dependencies

  • HTML page with functional html tags

Step 0. Load Boldwallet.js

Boldwallet™ JS into your page

    <script src="https://bwalletpay.com/api/1.2/api.js"></script>
var boldwallet_button = {
masterkey: "11619935",
servicekey: "13",
bwuniqid: "13",
description:"Welcome Nigeria"


}
<button onclick="btpush()"> Paynow</button>

After payment processing the processor takes the user back to clients return website url page.

Sample code available!

You will not need to worry about this too much, just download our sample javascript from https://github.com/bwallet/bwalletpayJS-Sample-code then design the html screens for each type.

N.B: After succefull validation, its adviced to perform a check to confirm the status of the transacions as shown here

Getting Started


This shows you how to accept payments super fast with boldwallet™


This is a five part series that attempts to guide you till you conclude integration.

While we used PHP in this series, attempt is made to focus on pseudocode so you can apply to any language.

Part 0:  Prerequisites
Part 1:  Transaction Parameters
Part 2:  Boldwallet™ Button  or BoldWallet™ Checkout  
Part 4: Verify Payment
Part 5: Menu menu.  

 

Prerequisites


Before starting integration, be sure to:

  1. Check our acceptable use policy . If you have any questions about your business and its acceptability please send an email to support@bwalletpay.com . The team is available to discuss and clarify any issues.

  2. Boldwallet API is dependent on JQuery API and appends JQuery library is none is avalaible upon request

 

 

API Keys


This section describes what API keys are and how to retrieve them;



Boldwallet™ authenticates your API requests using your account’s API keys. If you do not include your key when making an API request or use one that is incorrect or outdated, Boldwallet™ returns a null to your response.

All API requests exist in either test or live mode, and one mode cannot be manipulated by data in the other. To get your live and test API keys sign up here




There are also two types of API keys: publishable and secret.

  • Service Key keys are meant solely to identify your account with Boldwallet™ , they aren’t secret. In other words, they can safely be published in places like your Boldwallet™ JavaScript code, or in an Android or iPhone app. Service keys only have the power to create a transaction.

  • Master Key keeps track of your transactions and time when it was performed.



NB: Master Key can Service keys are used to perform crucial Transactions Request to BoldWallet™



Obtaining your API Keys

Your API keys are available in the Dashboard by navigating to Integrations - >

If you cannot see your API keys in the Dashboard, this means you have not created any application on the platform..

 

Test and live modes

The test and live modes function almost identically, with a few necessary differences:

  • In test mode, payments are not processed by card networks or payment providers rather by the test environment enlosed with BoldWallet™ platform and only recognized the test cards

 

Earn From Boldwallet


We track the users you refer to us using ref_user parameter, so you earn for every transaction they perform using their Masterkey and servicekey provided the amount is more than NGN2500
ref_user parameter: YOUR_USERNAME

Its very simple to use and integrate.

 

N.B: YOUR_USERNAME is your boldwallet username

Verify Payment


After integrating Boldwallet™ and a user has successfully paid, you need to verify that the payment was successful with Boldwallet™ before giving value to your customer on your website.

We strongly recommend you still do a server side verification to be double sure no foul play occurred during the payment flow.

Below are the important things to check for when validating the payment:

Verify the transaction reference.

Verify the data.status of the transaction to be successful.

Verify the currency to be the expected currency

Most importantly validate the amount paid to be equal to or at least greater than the amount of the value to be given.

Below are sample code snippets showing how to implement server-side validation in different programming languages

Below are sample code snippets showing how to implement server-side validation in different programming languages

Below are sample code snippets showing how to implement server-side validation in different programming languages

Verify endpoint for Live and Test environment.


     
    
<?php   

           

      $json = CONFIRM URL  
      $refid = trim($_GET['refno']);
      
      $refid = trim($_GET['refno']);   
      $refdy = "?refid=".$refid."&&masterkey=".$masterkey."&&stafd=stat";
      
      $url = $json."".$refdy;
       $jsonfile =  file_get_contents($url);
       $var = json_decode($jsonfile);
       
       if($var->status_request == "1"){
       if($var->status == "1"){
       
        echo "Payment was successfull";
        
        }else{
		
		echo "Payment Decline/Cancelled";

         };

          }else{

           echo "Error:1209";

           } ;

 

   ?>

const express = require('express');

const request = require('request');

const bodyParser = require('body-parser');

const path = require('path');

const app = express();

app.use(bodyParser.json());
app.use(bodyParser.urlencoded({extended: false}))

//bwallet callback
app.get('/bwallet/callback', (req,res) => {

const refid = req.query.reference;
const masterkey = 45556;

verifyTransaction(refid, (error,body)=>{
if(error){
//handle errors appropriately
console.log(error);
}
response = JSON.parse(body);
//setting callback data to json
const data = _.at(response.data, ['refid','masterkey']);
//callback data
[refid, masterkey] = data;

//Post callback request
request({
url: " https://bwalletpay.com/processor/verify",
method: "GET",
json: true,
body: data
}, function (error, response, body){


});

 

})
});

//start server port listening
app.listen(3000);

 
    

String url = CONFIRM URL;
String masterkey="your application master key";
String refid = "YOUR GET PARAMETER of GET request refno";
String cont = "masterkey="+masterkey+"&refid="+refid+"&gfh=09";
URL obj = new URL(url);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
// optional default is GET
con.setRequestMethod("GET");
//add request header
con.setRequestProperty("User-Agent", "Mozilla/5.0");
int responseCode = con.getResponseCode();

BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
JSONObject myResponse = new JSONObject(response.toString());
if(myResponse.getString("status_request").equalsIgnoreCase("1")){
if(myResponse.getString("status").equalsIgnoreCase("1")){

System.out.println("Payment made successfully");

}else{
if(myResponse.getString("status").equalsIgnoreCase("3")){
System.out.println("Unable to complete transaction");
}else{
System.out.println("Sorry pending payment");
}
};

}

}


 

API Parameters


When receiving payments on a website, the visitor would usually get to a page at which to make payment. At this time, we would already know:

  1. The visitor's unique identifier (This is usually an email on most websites)
  2. The amount they should be charged
  3. Whether the payment will be recurring.
  4. The item(s) for which they will be making payment.

At this point, Boldwallet™ can be called upon. It is from this point that the posts in this series will guide you to concluding integration.

  1. Master Key : this is part of the API key used to peform client action on Boldwallet™
  2. Secret Key : Secret key is the same with Master key but it can be used alone to authorize transaction on boldwallet™ account
  3. Firstname:
  4. Lastname :
  5. Email : must be a valid email
  6. Amount : must be a valid number
  7. ref_user : your username if you want to earn for every transactions
  8. Phonenumber :
  9. Description :
  10. bwuniqid : this is unique transaction reference number allotted to every transaction by your system more like orderid , its also returned after payment for confirmation
  11. Currency Code :this is the isomeric code of individual currency


Plugins

Plugins make Boldwallet integrations a lot faster. Here are the plugins we have at the moment, please feel free to contact support@bwalletpay.com if you need help developing a plugin or you've developed a plugin and want it to be listed here or you need a plugin that is not listed below

We've got you covered.

WordPress



 


 

Test Cards


Here’s are some cards that work on our test environment;



Successful Transaction


Card Number: 5078 5078 5078 5078 (Verve)
Expiry Date: 09/2020
CVV: 281
PIN: 1212

Card Number: 5105 1051 0510 5100 (MasterCard)
Expiry Date: 09/2020
CVV: 091
PIN: 1212

Card Number: 4222 2222 2222 5642 (Visa)
Expiry Date: 09/2020
CVV: 083
PIN: 1212