Overview

Once you submit a payout, you will want to track its progress through compliance screening, processing, and delivery. Anton provides two ways to do this: polling the API and receiving webhook notifications.

Checking Status via the API

Retrieve the current status of any payout by calling the GET endpoint with the payout ID:

curl https://api.antonpayments.dev/v1/payouts/pay_cng3q8s6ek9kc5qg1h2g \
  -H "Authorization: Bearer ak_test_..."

The response includes the current status field along with timestamps for when the payout was created and last updated.

Listing Recent Payouts

To view all your recent payouts, use the list endpoint with cursor-based pagination:

curl "https://api.antonpayments.dev/v1/payouts?limit=10" \
  -H "Authorization: Bearer ak_test_..."

The response includes has_more and next_cursor fields. To fetch the next page, pass the cursor:

curl "https://api.antonpayments.dev/v1/payouts?limit=10&cursor=pay_def456" \
  -H "Authorization: Bearer ak_test_..."

Checking Status via the Portal

In the merchant portal, navigate to Payouts to see a list of all your payouts with their current status. Click on any payout to view its full details, including a timeline of all status transitions.

Using Webhooks (Recommended)

For production integrations, webhooks are the recommended way to track payouts. Instead of polling, Anton pushes real-time notifications to your server whenever a payout changes status.

curl https://api.antonpayments.dev/v1/webhooks \
  -X POST \
  -H "Authorization: Bearer ak_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks/anton",
    "events": ["payout.completed", "payout.failed", "payout.returned"]
  }'

You will receive webhook deliveries for each subscribed event as the payout progresses.

What Each Status Means

created -- The payout has been accepted and funds have been reserved from your balance. This is the initial status.
pending_screening -- The payout is undergoing compliance checks including OFAC, PEP, and sanctions screening, plus velocity rule evaluation.
screening_failed -- The payout was blocked by compliance checks. The Anton operations team will review and either clear or reject it.
pending_approval -- The payout is a high-value or sensitive transaction that requires maker-checker approval before it can proceed.
manual_review -- Risk rules have flagged this payout for human review. An analyst will evaluate and either clear it for processing or reject it.
processing -- The payout has been approved and submitted to the payment rail provider for delivery.
sent -- The rail provider has confirmed dispatch. Funds are on their way to the payee.
completed -- Funds have been delivered successfully to the payee. This is a terminal status.
failed -- Delivery failed due to an issue such as an incorrect account number or bank rejection. This is a terminal status. Reserved funds are released back to your balance.
returned -- Funds were returned after a delivery attempt was made (for example, the recipient bank rejected the deposit). This is a terminal status.
cancelled -- The payout was cancelled before it reached processing. Reserved funds are released. This is a terminal status.

When to Expect Transitions

Sandbox: All transitions happen within seconds, allowing you to test your status handling logic quickly.
Created to pending_screening: Immediate.
Screening: Usually seconds. Rarely, manual review can take up to a few hours.
Processing to sent: Typically minutes.
Sent to completed: Same-day for domestic rails. One to three business days for international SWIFT transfers. Minutes for crypto payouts.

If a payout stays in pending_screening for more than 10 minutes in production, contact Anton support for assistance.

Tracking Payout Status