Developer Docs
Integration overview
Start with a sandbox payment, then connect your live provider accounts and configure updates to your app.
Base URL: https://api.tinkerpayments.com/v1
Recommended order
- Authenticate your app and obtain a bearer token.
- Implement the supported payment-initiation idempotency contract.
- 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.
Your first payment
Try a payment in the sandbox
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
Managed billing & trials
Provider-managed seats, free trials and billing state
Webhooks
Event payloads and verification
Idempotency
Safe retries and duplicate prevention
Error model
Normalized error codes and handling
Refunds
Reviewed full and partial refunds
Methods & wallets
Payment methods, wallets, and mandates
Rate limits
Throttling, headers, and pagination
Webhook delivery
Retries, guarantees, and callback service
Payment operations
Follow alerts and resolve payment problems
Go-live checklist
Production readiness checklist
Security
Keys, scopes, and hardening guidance
Platform plugins
Need another plugin? Contact support.