Authentication

The GovBill API uses a key pair (Public and Secret Keys) for authentication. To make an authenticated request to our API, you need to pass custom headers as described in this section.

Obtain the Keys

The Public and Secret keys are shared in the email that's sent to you when your account is approved. These keys should be sent as headers with the header names; public-key and secret-key

Please ensure that your keys are stored safely and not shared with the public. In the event your keys are compromised, please contact us immediately for assistance. You an alternatively regenerate the secret key from within your merchant account dashboard

Request Headers

For most of the API requests, only the public-key header is required. Scenarios that require the secret-key header will be described accordingly;

Header Name	Value	Required
Content-Type	application/json	YES
public-key	The Public Key as shared in the account approval email	YES
secret-key	The Secret Key as shared in the account approval email	NO