Skip to main content
Moflay uses saved Daraja credentials to talk to Safaricom on your behalf. You manage those credentials per environment in the dashboard.

​
What credentials Moflay uses

Depending on the environment, you may need some or all of the following:
  • Consumer key
  • Consumer secret
  • Business shortcode
  • Passkey
  • Business type, such as till or paybill

​
How credentials are used

When your app creates a payment, Moflay uses the credentials for the active environment to authenticate with Daraja and send the STK push request.
You do not need to build your own Daraja token exchange when you use Moflay.

​
Sandbox vs production

  • Sandbox: You can usually start with shared test credentials, and you can optionally bring your own sandbox credentials.
  • Production: You must provide your own verified live credentials before real payments can be processed.

​
Manage credentials in the dashboard

  1. Open Credentials.
  2. Select the environment you want to configure.
  3. Enter or review the credential fields.
  4. Save the configuration.

​
Verify the result

The best verification is an environment-specific payment test:
  • Use a sandbox key in sandbox after saving sandbox credentials
  • Use a production key in production after saving live credentials