1. Onboarding
Before you write any code, your business needs to be approved. The onboarding process collects the information we need for KYB verification, compliance screening, and corridor eligibility. Typical timeline: 3-7 business days from application submission to sandbox access, depending on the complexity of your business structure and responsiveness to RFIs.Submit your merchant application
Submit your merchant application
Upload required documents
Upload required documents
Respond to any RFIs
Respond to any RFIs
Approval and sandbox access
Approval and sandbox access
api.antonpayments.dev.2. Sandbox Development
Build your integration against the sandbox atapi.antonpayments.dev. Every API endpoint behaves identically to production — compliance checks are simulated, funds are test balances, and payouts settle instantly.
Typical timeline: 1-3 weeks depending on integration complexity.
Integration checklist
These are not suggestions. Every item below is validated during your certification call.Idempotency keys on all mutations
Idempotency keys on all mutations
POST request that creates or modifies a resource must include an Idempotency-Key header. This prevents duplicate payouts if a request is retried due to network issues or timeouts. Use a unique, deterministic key per operation (e.g., your internal transaction ID). See Idempotency.Webhook integration
Webhook integration
Error handling and retries
Error handling and retries
5xx errors. Respect Retry-After headers on 429 responses. Never retry 4xx errors (except 429). Map error codes to appropriate actions in your system. See Error Handling.Proper amount handling
Proper amount handling
Payout lifecycle handling
Payout lifecycle handling
completed and failed. Account for screening, pending_approval, processing, returned, and cancelled. Each status may require different logic in your system. See Payouts.Balance checks before payouts
Balance checks before payouts
Payee and instrument management
Payee and instrument management
Cursor-based pagination
Cursor-based pagination
limit, cursor, has_more, and next_cursor. Ensure your integration handles pagination correctly for payees, payouts, and batch results. See Pagination.Security checklist
API keys in environment variables or secrets manager
API keys in environment variables or secrets manager
Server-side only
Server-side only
TLS everywhere
TLS everywhere
Webhook signature verification
Webhook signature verification
Anton-Signature header on every webhook delivery using HMAC-SHA256. Reject requests with invalid or missing signatures. See Handle Webhooks.No sensitive data in logs
No sensitive data in logs
3. Certification Call
Once your sandbox integration is complete, schedule a certification call with our team. This is a technical walkthrough — not a sales call. Typical timeline: 1 session (30-60 minutes). Come prepared and it will be straightforward.What we review
- End-to-end payout flow (payee, instrument, payout)
- Webhook consumption and signature verification
- Idempotency key implementation
- Error handling and retry logic
- Security posture (key storage, TLS, logging)
- Balance and status management
- Pagination handling
What to prepare
- Working sandbox integration
- Sample payout logs showing full lifecycle
- Webhook delivery logs with signature verification
- Error handling demonstration
- Your team’s questions about production behavior
4. Fund Your Account
After certification, fund your production account before submitting your first live payout. Typical timeline: 1-2 business days for wire settlement.Receive funding instructions
Send the wire
Confirm balances via the API
5. Move to Production
With certification complete and your account funded, switch to production.Swap your base URL
Swap your base URL
https://api.antonpayments.dev to https://api.antonpayments.com.Use production API keys
Use production API keys
ak_test_... keys with ak_live_.... Generate production keys from the merchant portal.Register production webhook endpoints
Register production webhook endpoints
Verify corridor availability
Verify corridor availability
Update payee and instrument references
Update payee and instrument references
Sandbox vs. production
| Sandbox | Production | |
|---|---|---|
| API URL | api.antonpayments.dev | api.antonpayments.com |
| API keys | ak_test_... | ak_live_... |
| Compliance | Simulated screening (auto-pass) | Real OFAC, PEP, and sanctions checks |
| Funds | Pre-loaded test balances | Real money — must fund account |
| Delivery | Instant simulation | Real rail processing (minutes to days) |
| Webhooks | Delivered normally | Delivered normally |
| Rate limits | Relaxed | Enforced per plan |
Launch checklist
Before sending your first production payout, verify each item:- Base URL set to
https://api.antonpayments.com - Using
ak_live_...API keys (not test keys) - API keys stored in secrets manager (not hardcoded)
- Webhook endpoint registered with production URL
- Webhook signature verification enabled and tested
- Idempotency keys included on all
POSTrequests - Error handling with exponential backoff implemented
- Rate limit handling (
429+Retry-After) implemented - Balance check before payout submission
- All payout statuses handled in your system
- Logging configured without sensitive data exposure
- Monitoring and alerting configured for failures
Launch recommendations
Monitor delivery rates
Monitor webhook delivery
Watch your balances
Track API error rates
4xx and 5xx rates. A sudden increase in client errors could indicate a code regression. An increase in server errors should be reported to Anton support immediately.