Before you begin
You’ll need an Anton Payments account and an API key. If you don’t have one yet, register for a sandbox account or contact our team.
Sandbox mode — All examples use test API keys (ak_test_...). No real money moves in sandbox. Switch to ak_live_... keys when you’re ready for production.
Step 1: Authenticate
Every API request requires a Bearer token in the Authorization header. Your API key looks like ak_test_... (sandbox) or ak_live_... (production).
curl https://api.antonpayments.com/v1/merchant \
-H "Authorization: Bearer ak_test_your_key_here"
If you get back your merchant profile, you’re authenticated and ready to go.
Step 2: Create a beneficiary
Before you can send money, you need to register the recipient. A beneficiary stores the recipient’s identity and payment details.
curl https://api.antonpayments.com/v1/beneficiaries \
-X POST \
-H "Authorization: Bearer ak_test_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"type": "individual",
"first_name": "Jane",
"last_name": "Smith",
"email": "[email protected]",
"country": "GB",
"currency": "GBP",
"bank_account": {
"account_number": "12345678",
"sort_code": "123456"
}
}'
id from the response — you’ll need it in the next step.
Step 3: Send a payout
Now send money to your beneficiary. The payout goes through compliance screening and routing automatically.
curl https://api.antonpayments.com/v1/payouts \
-X POST \
-H "Authorization: Bearer ak_test_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"beneficiary_id": "ben_cng3q8s6ek9kc5qg1h1g",
"amount": "250.00",
"currency": "GBP",
"description": "Invoice #1042 payment",
"reference": "INV-1042"
}'
Step 4: Check the status
Poll the payout to see it progress through the lifecycle:
curl https://api.antonpayments.com/v1/payouts/pay_cng3q8s6ek9kc5qg1h2g \
-H "Authorization: Bearer ak_test_your_key_here"
created → pending_screening → processing → sent → completed ✓
Don’t poll — use webhooks. Set up a webhook subscription to get notified instantly when payout status changes. Polling is fine for testing, but webhooks are the way to go in production. What’s next?
