Resources
SDKs and Integration Guides
| Resource | Link |
|---|---|
| iOS SDK releases and Swift Package Manager package | koard-ios |
| iOS installation | Installing the SDK |
| Android SDK and examples | koard-android |
| Android installation and KiC package visibility | Installing the SDK |
| Merchant and location setup | Merchant Setup |
| Public REST contracts | API Reference |
| Payments and recovery | Payment Lifecycle |
| Settlement and batch reports | Running Batches |
| Signed webhook handling | Webhook Setup |
Use Swift Package Manager with https://github.com/koardlabs/koard-ios, or the released XCFramework, for iOS. The current Android dependency is:
implementation("com.koard:koard-android-sdk:1.0.7")
Test Cards
COTS contactless acceptance requires actual reader-generated EMV data. Generic keyed PAN/CVV test numbers do not simulate a card tap and are not Koard contactless certification fixtures.
Use the test cards, wallet tokens, and test cases assigned by your processor or network for the selected environment and certification project. Follow Apple Pay sandbox testing when provisioning a supported sandbox wallet. Confirm supported brands, card types, PIN/CVM cases, and expected responses with your certification contact. Do not substitute data from another processor's test suite.
Environments
| Environment | API URL | Use |
|---|---|---|
| UAT | https://api.uat.koard.com |
Integration testing with the assigned UAT processor configuration and test credentials |
| Production | https://api.koard.com |
Approved live merchant configurations |
Keep environment-specific keys, merchant identifiers, and processor configuration IDs together. A processor's separate CERT credentials are not interchangeable with Koard UAT credentials.
Validation Checklist
- Select the active merchant location in app settings and verify its linked terminal.
- Test approved, declined, partial approval, cancellation, and supported refund/tip flows using assigned test cases.
- Verify readiness, supported device eligibility, and the Android KiC package lookup.
- Recover lost responses using a persisted event ID instead of blindly retrying.
- Verify webhook signatures and duplicate delivery handling.
- Reconcile transaction totals against the batch submission and processor report.
- Complete the platform and processor approvals required for production.
Primary Platform References
- Apple Tap to Pay on iPhone
- Apple ProximityReader
- Android package visibility
- Svix signature verification
For merchant configuration or certification questions, contact support@koard.com.
