# Devdraft Documentation ## Docs - [ ](https://devdraft.ai/docs/guide/home.md) - [Identity Verification](https://devdraft.ai/docs/guide/kyc-basics.md): Verification levels, accepted ID types, and document submission guidelines. - [Required Fields](https://devdraft.ai/docs/guide/customer-verification-guide.md): All fields and documents needed to complete individual KYC or business KYB verification. - [Business Verification](https://devdraft.ai/docs/guide/kyb-documents.md): Documents required for KYB verification: formation docs, ownership proof, UBO identification, and proof of address. - [Verification Statuses](https://devdraft.ai/docs/kyc-statuses.md): Understand your verification status, what each one means, and how long the review process takes. - [Payout Rails](https://devdraft.ai/docs/guide/rails/payout-rails.md): All supported payout rails for sending funds from your Devdraft account to bank accounts and mobile wallets worldwide. - [Payin Rails](https://devdraft.ai/docs/guide/rails/payin-rails.md): All supported payin rails for receiving funds into your Devdraft account. - [Transaction States](https://devdraft.ai/docs/guide/logistics/transaction_states.md): Understand the lifecycle of a Devdraft transfer and what each status means. - [Processing windows & cutoff times](https://devdraft.ai/docs/guide/logistics/processing_windows_&_cutoff_times.md) - [Transaction Limits](https://devdraft.ai/docs/guide/transaction_limits.md): Your sending and receiving limits and how to request a higher limit. - [Transaction Monitoring](https://devdraft.ai/docs/guide/resources/fraud_transaction_monitoring.md): How Devdraft monitors transactions for fraud and compliance. - [Supported Countries](https://devdraft.ai/docs/guide/resources/supported_countries_list.md): Country risk classifications and supported bank-transfer rails, reviewed at least quarterly against OFAC, EU, UN, and FATF. - [FAQ guidance for users](https://devdraft.ai/docs/guide/resources/FAQ_guidance_for_users.md) - [Refunds FAQ](https://devdraft.ai/docs/guide/resources/refunds-faq.md): Common questions about refunds, processing times, fees, and tracking. - [Quickstart](https://devdraft.ai/docs/developers/home/quickstart.md): Get your API keys and make your first request. - [Use Cases](https://devdraft.ai/docs/developers/home/use-cases.md): Common integration patterns for the Devdraft API. - [Networks and Currencies](https://devdraft.ai/docs/developers/home/networks-and-currencies.md): Supported payment rails, stablecoin networks, and currencies on Devdraft. - [API Request Authentication](https://devdraft.ai/docs/developers/home/api-request-authentication.md): How to authenticate your API requests to Devdraft. - [Rate Limiting](https://devdraft.ai/docs/developers/home/rate-limiting.md): API rate limits and how to handle them. - [Idempotency](https://devdraft.ai/docs/developers/home/idempotency.md): Safely retry API requests without creating duplicate operations. - [Create Stablecoin Payment Intent](https://devdraft.ai/docs/developers/payment-intents/create-stablecoin-payment-intent.md): Transfer stablecoins across networks. - [Create Bank Payment Intent](https://devdraft.ai/docs/developers/payment-intents/create-bank-payment-intent.md): Accept fiat payments via ACH, Wire, and SEPA. - [Get Transaction Status](https://devdraft.ai/docs/developers/payment-intents/get-transaction-status.md): Retrieve the current status and details of a payment intent transaction - [Webhooks](https://devdraft.ai/docs/developers/webhooks/overview.md): Listen for real-time events. - [Create Webhook](https://devdraft.ai/docs/developers/webhooks/create-webhook.md): Register webhook endpoints for receiving real-time event notifications from your Devdraft application - [List Webhooks](https://devdraft.ai/docs/developers/webhooks/list-webhooks.md): Retrieve all webhooks associated with your Devdraft application - [Fetch Webhook](https://devdraft.ai/docs/developers/webhooks/fetch-webhook.md): Retrieve detailed information about a specific webhook endpoint - [Delete Webhook](https://devdraft.ai/docs/developers/webhooks/delete-webhook.md): Remove webhook endpoints from your Devdraft application - [List Wallets](https://devdraft.ai/docs/developers/wallets/list-wallets.md): Retrieve all Devdraft wallets associated with your application - [Direct Wallet Transfer](https://devdraft.ai/docs/developers/transfers/direct-wallet-transfer.md): Initiate blockchain-to-blockchain transfers from external wallets to your Devdraft wallets - [Direct Bank Transfer](https://devdraft.ai/docs/developers/transfers/direct-bank-transfer.md): Initiate bank-to-wallet transfers from external bank accounts to your Devdraft wallets - [Stablecoin Conversion](https://devdraft.ai/docs/developers/transfers/stablecoin-conversion.md): Convert between different stablecoins and networks using Devdraft's cross-chain infrastructure - [SDK Quickstart](https://devdraft.ai/docs/sdks/sdk-quickstart.md): Get started with Devdraft SDKs to integrate payment transfers and webhooks into your application - [TypeScript SDK Reference](https://devdraft.ai/docs/sdks/typescript-sdk-reference.md): Complete reference for the Devdraft TypeScript SDK with all available methods and examples - [Python SDK Reference](https://devdraft.ai/docs/sdks/python-sdk-reference.md): Complete reference for the Devdraft Python SDK with all available methods and examples - [Go SDK Reference](https://devdraft.ai/docs/sdks/go-sdk-reference.md): Complete reference for the Devdraft Go SDK with all available methods and examples - [Java SDK Reference](https://devdraft.ai/docs/sdks/java-sdk-reference.md): Complete reference for the Devdraft Java SDK with all available methods and examples - [PHP SDK Reference](https://devdraft.ai/docs/sdks/php-sdk-reference.md): Complete reference for the Devdraft PHP SDK with all available methods and examples - [Ruby SDK Reference](https://devdraft.ai/docs/sdks/ruby-sdk-reference.md): Complete reference for the Devdraft Ruby SDK with all available methods and examples - [C# SDK Reference](https://devdraft.ai/docs/sdks/csharp-sdk-reference.md): Complete reference for the Devdraft C# SDK with all available methods and examples - [Authenticated health check endpoint](https://devdraft.ai/docs/api-reference/api-health/authenticated-health-check-endpoint.md) - [Public health check endpoint](https://devdraft.ai/docs/api-reference/api-health/public-health-check-endpoint.md) - [Process a test payment](https://devdraft.ai/docs/api-reference/test-payments/process-a-test-payment.md): Creates a new payment. Requires an idempotency key to prevent duplicate payments on retry. ## Idempotency Key Best Practices - [Get payment details by ID](https://devdraft.ai/docs/api-reference/test-payments/get-payment-details-by-id.md) - [Refund a payment](https://devdraft.ai/docs/api-reference/test-payments/refund-a-payment.md): Refunds an existing payment. Requires an idempotency key to prevent duplicate refunds on retry. ## Idempotency Key Benefits for Refunds - [Get all customers with filters](https://devdraft.ai/docs/api-reference/customers/get-all-customers-with-filters.md): Retrieves a list of customers with optional filtering and pagination. This endpoint allows you to search and filter customers based on various criteria. - [Create a new customer](https://devdraft.ai/docs/api-reference/customers/create-a-new-customer.md): Creates a new customer in the system with their personal and contact information. This endpoint allows you to register new customers and store their details for future transactions. - [Get a customer by ID](https://devdraft.ai/docs/api-reference/customers/get-a-customer-by-id.md): Retrieves detailed information about a specific customer. This endpoint allows you to fetch complete customer details including their contact information and status. - [Update a customer](https://devdraft.ai/docs/api-reference/customers/update-a-customer.md): Updates an existing customer's information. This endpoint allows you to modify customer details while preserving their core information. - [Get all payment links](https://devdraft.ai/docs/api-reference/payment-links/get-all-payment-links.md) - [Create a new payment link](https://devdraft.ai/docs/api-reference/payment-links/create-a-new-payment-link.md): Creates a new payment link with the provided details. Supports both simple one-time payments and complex product bundles. - [Get a payment link by ID](https://devdraft.ai/docs/api-reference/payment-links/get-a-payment-link-by-id.md) - [Update a payment link](https://devdraft.ai/docs/api-reference/payment-links/update-a-payment-link.md) - [Create a stable payment intent](https://devdraft.ai/docs/api-reference/payment-intents/create-a-stable-payment-intent.md): Creates a new stable payment intent for stablecoin-to-stablecoin transfers. This endpoint allows you to create payment intents for transfers between different stablecoins and networks. Perfect for cross-chain stablecoin swaps and conversions. - [Create a bank payment intent](https://devdraft.ai/docs/api-reference/payment-intents/create-a-bank-payment-intent.md): Creates a new bank payment intent for fiat-to-stablecoin transfers. This endpoint allows you to create payment intents for bank transfers (ACH, Wire, SEPA) that convert to stablecoins. Perfect for onboarding users from traditional banking to crypto. - [Get all webhooks](https://devdraft.ai/docs/api-reference/webhooks/get-all-webhooks.md): Retrieves a list of all webhooks for your application. Requires webhook:read scope. - [Create a new webhook](https://devdraft.ai/docs/api-reference/webhooks/create-a-new-webhook.md): Creates a new webhook endpoint for receiving event notifications. Requires webhook:create scope. - [Get a webhook by id](https://devdraft.ai/docs/api-reference/webhooks/get-a-webhook-by-id.md): Retrieves details for a specific webhook. Requires webhook:read scope. - [Delete a webhook](https://devdraft.ai/docs/api-reference/webhooks/delete-a-webhook.md): Deletes a webhook configuration. Requires webhook:delete scope. - [Update a webhook](https://devdraft.ai/docs/api-reference/webhooks/update-a-webhook.md): Updates an existing webhook configuration. Requires webhook:update scope. - [Get wallets for an app](https://devdraft.ai/docs/api-reference/wallets/get-wallets-for-an-app.md) - [Create a direct wallet transfer](https://devdraft.ai/docs/api-reference/transfers/create-a-direct-wallet-transfer.md) - [Create a direct bank transfer](https://devdraft.ai/docs/api-reference/transfers/create-a-direct-bank-transfer.md) - [Create a stablecoin conversion](https://devdraft.ai/docs/api-reference/transfers/create-a-stablecoin-conversion.md) - [Create an external bank transfer](https://devdraft.ai/docs/api-reference/transfers/create-an-external-bank-transfer.md) - [Create an external stablecoin transfer](https://devdraft.ai/docs/api-reference/transfers/create-an-external-stablecoin-transfer.md) - [Get all liquidation addresses for a customer](https://devdraft.ai/docs/api-reference/liquidation-addresses/get-all-liquidation-addresses-for-a-customer.md): Retrieve all liquidation addresses associated with a specific customer. - [Create a new liquidation address for a customer](https://devdraft.ai/docs/api-reference/liquidation-addresses/create-a-new-liquidation-address-for-a-customer.md): Create a new liquidation address for a customer. Liquidation addresses allow customers to automatically liquidate cryptocurrency holdings to fiat or other stablecoins based on configured parameters. - [Get a specific liquidation address](https://devdraft.ai/docs/api-reference/liquidation-addresses/get-a-specific-liquidation-address.md): Retrieve a specific liquidation address by its ID for a given customer. - [Get USDC balance for an app](https://devdraft.ai/docs/api-reference/app-balances/get-usdc-balance-for-an-app.md): Retrieves the total USDC balance across all wallets for the specified app. This endpoint aggregates USDC balances from all associated wallets and provides: - Total USDC balance across all chains and wallets - Detailed breakdown by individual wallet and blockchain network - Contract addresses an… - [Get EURC balance for an app](https://devdraft.ai/docs/api-reference/app-balances/get-eurc-balance-for-an-app.md): Retrieves the total EURC balance across all wallets for the specified app. This endpoint aggregates EURC balances from all associated wallets and provides: - Total EURC balance across all chains and wallets - Detailed breakdown by individual wallet and blockchain network - Contract addresses an… - [Get all stablecoin balances for an app](https://devdraft.ai/docs/api-reference/app-balances/get-all-stablecoin-balances-for-an-app.md): Retrieves both USDC and EURC balances across all wallets for the specified app. This comprehensive endpoint provides: - Complete USDC balance aggregation with detailed breakdown - Complete EURC balance aggregation with detailed breakdown - Total USD equivalent value across both currencies - Ind… - [Get USD to EUR exchange rate](https://devdraft.ai/docs/api-reference/exchange-rates/get-usd-to-eur-exchange-rate.md): Retrieves the current exchange rate for converting USD to EUR (USDC to EURC). This endpoint provides real-time exchange rate information for stablecoin conversions: - Mid-market rate for reference pricing - Buy rate for actual conversion calculations - Sell rate for reverse conversion scenarios - [Get EUR to USD exchange rate](https://devdraft.ai/docs/api-reference/exchange-rates/get-eur-to-usd-exchange-rate.md): Retrieves the current exchange rate for converting EUR to USD (EURC to USDC). This endpoint provides real-time exchange rate information for stablecoin conversions: - Mid-market rate for reference pricing - Buy rate for actual conversion calculations - Sell rate for reverse conversion scenarios - [Get exchange rate between specified currencies](https://devdraft.ai/docs/api-reference/exchange-rates/get-exchange-rate-between-specified-currencies.md): Retrieves the current exchange rate between two specified currencies. This flexible endpoint allows you to get exchange rates for any supported currency pair: - Supports USD and EUR currency codes - Provides comprehensive rate information - Real-time market data - [Get all products](https://devdraft.ai/docs/api-reference/products/get-all-products.md): Retrieves a list of products with pagination. This endpoint allows you to fetch products with optional pagination. - [Create a new product](https://devdraft.ai/docs/api-reference/products/create-a-new-product.md): Creates a new product with optional image uploads. This endpoint allows you to create products with detailed information and multiple images. - [Upload images for a product](https://devdraft.ai/docs/api-reference/products/upload-images-for-a-product.md): Adds new images to an existing product. This endpoint allows you to upload additional images for a product that already exists. - [Get a product by ID](https://devdraft.ai/docs/api-reference/products/get-a-product-by-id.md): Retrieves detailed information about a specific product. This endpoint allows you to fetch complete product details including all images. - [Update a product](https://devdraft.ai/docs/api-reference/products/update-a-product.md): Updates an existing product's information and optionally adds new images. This endpoint allows you to modify product details and manage product images. - [Delete a product](https://devdraft.ai/docs/api-reference/products/delete-a-product.md): Deletes a product and its associated images. This endpoint allows you to remove a product and all its associated data. - [Get all invoices](https://devdraft.ai/docs/api-reference/invoices/get-all-invoices.md) - [Create a new invoice](https://devdraft.ai/docs/api-reference/invoices/create-a-new-invoice.md) - [Get an invoice by ID](https://devdraft.ai/docs/api-reference/invoices/get-an-invoice-by-id.md) - [Update an invoice](https://devdraft.ai/docs/api-reference/invoices/update-an-invoice.md) - [Get all taxes with filters](https://devdraft.ai/docs/api-reference/taxes/get-all-taxes-with-filters.md): Retrieves a list of taxes with optional filtering and pagination. - [Tax ID required for updates](https://devdraft.ai/docs/api-reference/taxes/tax-id-required-for-updates.md): This endpoint requires a tax ID in the URL path. Use PUT /api/v0/taxes/{id} instead. - [Create a new tax](https://devdraft.ai/docs/api-reference/taxes/create-a-new-tax.md): Creates a new tax rate that can be applied to products, invoices, and payment links. - [Tax ID required for deletion](https://devdraft.ai/docs/api-reference/taxes/tax-id-required-for-deletion.md): This endpoint requires a tax ID in the URL path. Use DELETE /api/v0/taxes/{id} instead. - [Get a tax by ID](https://devdraft.ai/docs/api-reference/taxes/get-a-tax-by-id.md): Retrieves detailed information about a specific tax. - [Update a tax](https://devdraft.ai/docs/api-reference/taxes/update-a-tax.md): Updates an existing tax's information. - [Delete a tax](https://devdraft.ai/docs/api-reference/taxes/delete-a-tax.md): Deletes an existing tax. - [May](https://devdraft.ai/docs/changelogs/2026/may.md): Instant USD payments via FedNow. You get paid in seconds, any day, any time. - [April](https://devdraft.ai/docs/changelogs/2026/april.md): MXN payments via SPEI. Receive pesos from clients, send pesos to Mexican bank accounts, and manage MXN beneficiaries directly in your Devdraft account. - [February](https://devdraft.ai/docs/changelogs/2026/february.md): Refund tracking across payment rails and on-chain transaction hash visibility. - [August](https://devdraft.ai/docs/changelogs/2025/august.md): Virtual account creation on demand, network consolidation to Base, transaction details view, and redesigned transfers page. ## OpenAPI Specs - [swagger](https://devdraft.ai/docs/swagger.yml) - [openapi](https://devdraft.ai/docs/api-reference/openapi.json) ## Optional - [Website](https://www.devdraft.ai) - [Help Center](http://support.devdraft.ai/en/) - [Sitio Web](https://www.devdraft.ai) - [Centro de Ayuda](http://support.devdraft.ai/en/)