Skip to main content

How to integrate the API key

Here's a detailed step on how to implement the API feature

Written by Paul Adegbesan

To start using the API, you need to follow a few simple steps to ensure a secure and functional integration:

  1. Account Requirement: You must have a registered business account with Grey Finance.

  2. Generate API Keys: Log in to your Grey Finance business dashboard,

    - Navigate to the "Integrations" section:


    - Click on "Add API Key" and fill in the form, with the following fields:
    You can optionally whitelist your server IP addresses to ensure that all requests coming from other IPs will be rejected.


    - Generate your unique credentials. You will receive the secret key.

  3. Secure Your Credentials: Your API Secret Key is shown only once upon generation. You must copy and store it securely in your application's environment variables and never expose it in publicly accessible code.

  4. Authorization: All requests to the API must be authenticated by including your API key in the Authorization header of every request you send.

  5. Webhook Validation: To ensure the security of your system, every real-time transaction notification you receive from Grey Finance includes a cryptographic signature. Your application must validate this signature using your webhook secret to confirm the message is genuinely from us and has not been tampered with.

Kindly view this https://businessapi.grey.co/docs for detailed steps on adding the API key to your website.

For further assistance, please send an email to [email protected]

Did this answer your question?