Developer Docs
Integration Overview
Use this guide to move from authentication to live payments and merchant-managed subscriptions.
Base URL: https://api.tinkerpayments.com/v1
Recommended Order
- Authenticate your app and obtain a bearer token.
- Implement idempotency for all write operations.
- Initiate payment when collecting one-time charges.
- Query payment status for reconciliation and UX updates.
- Implement normalized error handling and retry policy.
- Configure webhook verification plus delivery retry handling.
- Add refund/void flows before production launch.
- Complete go-live and security checklist with your compliance team.
SDKs & Plugins
Official SDK links and platform integrations
Authentication
Get app tokens for all requests
Payment Initiate
Create payment sessions
Payment Query
Check payment status by reference
Subscriptions
Plans and subscriptions for merchant customers
Webhooks
Event payloads and verification
Idempotency
Safe retries and duplicate prevention
Error Model
Normalized error codes and handling
Refunds
Refund, void, and partial refund behavior
Methods & Wallets
Payment methods, wallets, and mandates
Rate Limits
Throttling, headers, and pagination
Webhook Delivery
Retries, guarantees, and callback service
Go-Live Checklist
Production readiness checklist
Security
Keys, scopes, and hardening guidance
Platform Plugins
Need another plugin? Contact support.