Client Libraries
Kody provides SDKs for several popular programming languages to simplify integration with the Kody Payments API. These client libraries handle authentication, serialization, and network communication, allowing you to focus on your business logic.
Available Languages
If your preferred programming language is not listed, contact the Kody team to request support for additional languages.
Advantages of Using Client Libraries
- Maintained by Kody: Ensures compatibility with Kody's APIs and keeps up-to-date with the latest changes.
- Built-In Authentication: Securely interact with Kody APIs using pre-configured mechanisms.
- Retry Logic: Automatically retries failed requests for robust communication.
- Language-Specific Idioms: Designed to fit the conventions and idioms of each supported language.
- Efficient Communication: Uses protocol buffers for optimized HTTP request bodies.
- Backward Compatibility: Ensures smooth integration with future API updates.
Implementation Guidelines
- The SDKs are designed for server-side usage to maintain secure API key handling.
- Avoid using the SDKs directly in frontend applications to prevent exposing sensitive credentials.
Best Practices
-
Terminal Readiness: Ensure your terminal is in the proper mode (e.g., "Wait for Orders") before sending payments. Contact Kody support to enable any special terminal features.
-
Secure API Key: Store your API key securely (for example, using environment variables or a secrets manager) and avoid hardcoding it in your source code.
-
Idempotency: Use the optional idempotency keys for both payments and refunds to avoid duplicate processing.
-
Error Handling: Check response statuses and failure reasons for robust error handling.
Test Cards
To make simulated payments in a test store you can open the page Test Cards to access multiple payment methods and also combination of value amounts to create test cases, for both in person terminal payments and online payments.