# Airtm Payments / Payouts API **Canonical:** https://apis.io/apis/airtm/airtm-payments-payouts-api/ **Provider:** Airtm — https://apis.io/providers/airtm/ **Base URL:** https://api.enterprise.airtm.com/v2 **Documentation:** https://docs.airtm.com/ Airtm Payments / Payouts API is one of 24 APIs that [Airtm](https://apis.io/providers/airtm/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Payments / Payouts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference. ## Overview The Payouts endpoint enables your organization to send payments to recipients worldwide through the Airtm platform. This powerful endpoint supports both individual and bulk payment processing, making it ideal for paying employees, contractors, freelancers, vendors, or any other recipients who have Airtm accounts. ## What are Payouts? Payouts represent outgoing payments from your enterprise account to recipient users. The payout process is designed to be flexible, secure, and reliable, with multiple options for creating and managing payments based on your specific needs. ### Key Features - **Two-Step or One-Step Processing** - Choose your preferred workflow - **Real-Time Status Tracking** - Monitor payment progress instantly - **Comprehensive Recipient Management** - Support for new and existing users - **Webhook Integration** - Receive instant status notifications ## Payment Processing Options ### 1. Two-Step Process (Create + Commit) **Best for:** Careful review and approval workflows 1. **Create Payout** - Generate payout instruction 2. **Review Details** - Verify recipient and amount information 3. **Commit Payout** - Execute the payment ### 2. One-Step Process (Direct) **Best for:** Automated systems and immediate processing - **Create and Execute** - Single API call processes payment immediately - **Streamlined Workflow** - Reduces API calls and complexity - **Instant Processing** - Payment begins processing immediately ## Status Management ### Payout Status Values | Status | Final? | Description | Next Actions | | ----------- | ------ | ---------------------------------------------------------------- | --------------------------- | | `created` | No | Payout instruction created, awaiting commit | Call commit endpoint | | `committed` | No | Payout committed and queued for processing | Monitor status updates | | `pending` | No | Awaiting recipient action (account creation, verification, etc.) | Wait for recipient action | | `completed` | Yes | Payment successfully delivered to recipient | None - payment complete | | `canceled` | Yes | Payout canceled, funds returned to sender | None - transaction reversed | | `failed` | Yes | Payment failed due to processing error | Contact support if needed | ### Detailed Status Descriptions #### Created Status - Payout instruction has been successfully created - Funds are not yet committed from your account - You can still modify or cancel the payout - Must call commit endpoint to proceed #### Committed Status - Payout has been committed for processing - Funds are placed in escrow - Processing has begun but not yet completed - Cannot be canceled once committed #### Pending Status The payout is waiting for recipient action: - **New User:** Recipient needs to create an Airtm account - **Verification Required:** Recipient exceeds $1,000 threshold and needs ID verification - **US Recipients:** Must complete ID verification and configure payment method - **Account Issues:** Recipient account may have restrictions A pending payout can still be canceled before it is processed. #### Completed Status - Payment has been successfully processed - Funds have been credited to recipient's account - Final status - no further action needed - Success webhook sent (if configured) #### Canceled Status - Payout was canceled before or during processing - Funds have been returned to your account - Can occur due to: - Manual cancellation - Recipient unable to receive funds - Account restrictions - Compliance issues #### Failed Status - Rare occurrence of processing failure - Contact [enterprise@airtm.com](mailto:enterprise@airtm.com) for assistance - May require manual intervention to resolve ## Recipient Management ### New Recipients When sending to users who don't have Airtm accounts: 1. **Payout Created** - Payment is created with recipient email 2. **Email Notification** - Recipient receives invitation to join Airtm 3. **Account Creation** - Recipient creates Airtm account 4. **Payment Completion** - Funds are automatically credited ### Existing Recipients For users with existing Airtm accounts: - Payments are typically processed faster - Fewer verification requirements - Direct credit to their account balance ### Recipient Verification Requirements #### $1,000+ Threshold Recipients receiving amounts that bring their total inflow over $1,000 must: - Complete ID verification - Provide government-issued identification - Verify personal information #### US Recipients All US-based recipients must: - Complete ID verification regardless of amount - Configure a valid payment method - Meet additional compliance requirements ## Machine-readable artifacts (4) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/airtm/refs/heads/main/openapi/airtm-payments-payouts-api-openapi.yml - **Documentation** — https://docs.airtm.com/ - **APIReference** — https://docs.airtm.com/ - **Webhooks** — https://raw.githubusercontent.com/api-evangelist/airtm/refs/heads/main/asyncapi/airtm-webhooks.yml ## Other Airtm APIs (12) - [Airtm Wallet Resource (Connect) API](https://apis.io/apis/airtm/airtm-wallet-resource-connect-api/) - [Airtm Account Status API](https://apis.io/apis/airtm/airtm-account-status-api/) - [Airtm API Keys API](https://apis.io/apis/airtm/airtm-apikeys-api/) - [Airtm Bulk Payments API](https://apis.io/apis/airtm/airtm-bulk-payments-api/) - [Airtm Bulk Payouts API](https://apis.io/apis/airtm/airtm-bulk-payouts-api/) - [Airtm Deposits API](https://apis.io/apis/airtm/airtm-deposits-api/) - [Airtm Embedded Catalog API](https://apis.io/apis/airtm/airtm-embedded-catalog-api/) - [Airtm Embedded Quotes API](https://apis.io/apis/airtm/airtm-embedded-quotes-api/) - [Airtm Embedded Receivers API](https://apis.io/apis/airtm/airtm-embedded-receivers-api/) - [Airtm Embedded Senders API](https://apis.io/apis/airtm/airtm-embedded-senders-api/) - [Airtm Embedded Transactions API](https://apis.io/apis/airtm/airtm-embedded-transactions-api/) - [Airtm External Bank Account API](https://apis.io/apis/airtm/airtm-external-bank-account-api/) ## Tags Payments / Payouts --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/airtm/airtm-payments-payouts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/airtm/.