Is there an API I can use to monitor my wallet balance?

Your Smile ID wallet balance is always available by logging into the Smile ID dashboard. However, if you would like to monitor it programmatically there is an API which will tell you your current balance. The default currency is USD.

POST https://[env].smileidentity.com/api/v2/partner/wallet_balance

Where [env] is either "portal" or "prod"

The information returned is the same. The env variable here is to denote which api key you are using to authenticate the request.

JSON request body:

{
  "currency": "<optional 'KES', 'NGN', 'USD'>",
  "environment": "<'test' or 'production' to indicate which API key was used>",
  "partner_id": "<Put your partner ID here>",
  "signature": "<Put signature here>",
  "timestamp": "<Put the timestamp here>"
}

Example response:

{
  "wallet_balance": 500.0,
  "current_as_of": "2020-05-21T20:39:56.173Z"
}

The "current_as_of" field indicates the last time your wallet was debited. We deduct jobs from your wallet as a background process rather than real-time. Much like a credit card bill, there will be a slight delay between the wallet balance and the actions taken by your users.