Authentication - PayX

PayX uses API Keys to authenticate requests. You can view and manage your API keys in the PayX Dashboard.

API Keys

Every account has two sets of keys:

Test Keys: Use these for development and testing. No real money will be moved.
Live Keys: Use these for production. Real money will be moved.

Key Type	Header Name	Example
Secret Key	`x-api-key`	`sk_test_...` or `sk_live_...`

Authenticating Requests

All API requests must be made over HTTPS. To authenticate, include your Secret Key in the x-api-key header of your request.

curl -X POST https://payx.company/api/v1/charge \
  -H "x-api-key: your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10.0,
    "phoneNumber": "0551234987",
    "network": "MTN"
  }'

Keep your Secret Keys private. Do not share them in client-side code (browsers, mobile apps) or public repositories like GitHub.