Authentication

Browpay API works in two modes. Live Mode and Sandbox Mode

• The Live mode keys are retrieved from the main dashboard at https://dashboard.browpay.com and the Live mode API endpoint is at https://api.browpay.com/v1/

  • In the Live mode there are real payments, real effects and data. Only switch to live api endpoint after you have reviewed your test integrations thoroughly.

• The Sandbox Mode keys are retrieved from the sandbox dashboard environment at https://sandbox.browpay.com and the Sandbox mode API endpoint is at https://s-api.browpay.com/v1/

  • In the Sandbox mode you have mock transactions, test payments and test transactions. Here is where you get the liberty to test and run your demo integrations just as it would respond in real transactions, but in sandbox no real money is processed.

    Also Note: that we are bound to erase sandbox data after a year; which means you only get a year data interval for every tests you make.

Sign up at https://sandbox.browpay.com to switch to sandbox mode and retrieve your test keys.

API KEYS

• Secret Key: Your secret key authorizes your API requests. It is required to authenticate your API calls. You are expected to protect your secret keys from the public and do not expose it in your frontend.

• Public Key: Your public key is primarily used to decrypt the webhook payloads we send to you. Further updates on public key utilization will be published in due time.

• Encryption Key: The encryption also works as a pair to the public key in decrypting the webhook payloads we send to you. We are working hard to ensure the security of your data while you consume our endpoints.

To retrieve your keys, navigate to API Keys in your dashboard menu and copy your keys.

Browpay API Keys page

IMPORTANT

If you suspect that your keys have been exposed or compromised, navigate to API KEYS in your dashboard menu and generate new keys to deactivate the previously exposed ones for your safety.

A sample secret key authorization would look like this:

Node JS

const axios = require('axios');

const apiUrl = 'browpay-api-endpoint';
const token = 'Your-secret-key';

axios.get(apiUrl, {
  headers: {
    'Authorization': `Bearer ${token}`
  }
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

Python

import requests

api_url = 'browpay-api-endpoint'
token = 'your-secret-key'

headers = {
    'Authorization': f'Bearer {token}'
}

response = requests.get(api_url, headers=headers)

print(response.json())

PHP

$options = [
    'http' => [
        'header' => "Authorization: Bearer 'your-secret-key'",
    ],
];

$context = stream_context_create($options);
$response = file_get_contents('browpay-api-endpoint', false, $context);

echo $response;