# Airtm Purchases / Payins API

**Canonical:** https://apis.io/apis/airtm/airtm-purchases-payins-api/  
**Provider:** Airtm — https://apis.io/providers/airtm/  
**Base URL:** https://api.enterprise.airtm.com/v2  
**Documentation:** https://docs.airtm.com/

Airtm Purchases / Payins 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 Purchases / Payins. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

## Overview The Payins endpoint (also known as Purchases) enables your organization to accept payments from users for products, services, or any other transactions. This endpoint is essential for e-commerce platforms, service providers, and any business that needs to collect payments from customers through the Airtm platform. ## What are Payins? Payins represent incoming payments to your enterprise account. When a user makes a purchase or payment to your organization, it creates a payin operation that can be tracked and managed through this endpoint. ### Key Features - **Flexible Payment Processing** - Accept payments for various products and services - **Multi-Currency Support** - Process payments in different currencies - **Real-Time Status Updates** - Track payment progress in real-time - **Secure Checkout Process** - Redirect users to secure Airtm payment pages - **Webhook Integration** - Receive instant notifications on payment status changes - **Reference Code Tracking** - Link payments to your internal order systems ## Payment Flow 1. **Create Purchase** - Your system creates a purchase request with payment details 2. **User Checkout** - User is redirected to Airtm's secure checkout page 3. **Authentication** - User logs into their Airtm account to complete payment 4. **Processing** - Payment is processed and status updates are provided 5. **Completion** - Payment is completed and funds are transferred to your account ## Status Management ### Purchase Status Values | Status | Final? | Description | | ----------- | ------ | ------------------------------------------------- | | `created` | No | Purchase created, awaiting user payment | | `confirmed` | Yes | Payment completed successfully, funds transferred | | `canceled` | Yes | User canceled the purchase, no funds transferred | | `failed` | Yes | Payment processing failed | > [!TIP] > Implement case-insensitive status comparisons in your code to handle potential variations.

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/airtm/refs/heads/main/openapi/airtm-purchases-payins-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

Purchases / Payins

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/airtm/airtm-purchases-payins-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/airtm/.