--- title: Developer Documentation | ZifyPay description: Full developer API references, SDK integration guides, and testing environments for ZifyPay. --------------------------------------------------------------------------------------------------------- # Developer Documentation Welcome to the ZifyPay Developer Docs — your complete guide to integrating with our powerful POS and fuel retail technology stack. Whether you're building a custom fuel station interface, integrating payment terminals, or creating dashboards with our APIs, this is your starting point. --- ## Getting Started ### 🔐 API Authentication All API requests must be authenticated using your API key and terminal credentials. You’ll receive these after onboarding. Use HTTPS for all endpoints. ```http Authorization: Bearer YOUR_API_KEY ``` ### 📦 SDK Installation ```bash npm install @zifypay/sdk ``` ```js import ZifyPay from '@zifypay/sdk'; const client = new ZifyPay; ``` --- ## API Reference ### 🧾 Transactions * `POST /api/v1/transaction/sale` * `POST /api/v1/transaction/void` * `POST /api/v1/transaction/refund` ### 🛢️ Fuel Pump Control * `POST /api/v1/pump/start` * `POST /api/v1/pump/stop` * `GET /api/v1/pump/status` ### 🛍️ Retail POS * `POST /api/v1/inventory/add` * `GET /api/v1/inventory` * `POST /api/v1/checkout` --- ## Webhooks Subscribe to real-time event updates such as completed transactions, pump usage, or low inventory alerts. ```json ``` --- ## Testing Environment We provide a full sandbox mode for testing payments, pump controls, and inventory sync. Use test credentials provided in your dashboard. * Base URL: `https://sandbox-api.zifypay.com` * Live URL: `https://api.zifypay.com` --- ## Support Need help integrating? Contact our developer support team at **[dev@zifypay.com](mailto:dev@zifypay.com)** or visit our [Help Center](/help). --- Stay updated with the [Changelog](/changelog).