> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useyala.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Yala Payout APIs

> Integrate cross-border payouts and wallet services with a single API.

<Hero title="Global Payouts Built on Stablecoin Rails." subtitle="Build seamless cross-border payout experiences with real-time FX and instant settlement." ctaPrimary={{ label: "Start building", href: "/quickstart" }} ctaSecondary={{ label: "Explore the API", href: "/api-reference/introduction" }} image="/images/hero-light.png" />

## Why build with Yala

<Columns cols={3}>
  <Card title="Global coverage" icon="globe">
    Send funds to key corridors across Africa, Europe, Asia, and North America with local settlement rails.
  </Card>

  <Card title="Real-time FX" icon="chart-line">
    Quote transparent exchange rates and fees instantly so customers always know what they pay.
  </Card>

  <Card title="Enterprise security" icon="shield-check">
    Protect every transaction with API key authentication, business-scoped access control, idempotency protection, and comprehensive audit logs.
  </Card>
</Columns>

## What you can build

<Columns cols={2}>
  <Card title="Customer payouts" icon="bank">
    Initiate one-off or recurring payouts to marketplace sellers, suppliers, or gig workers.
  </Card>

  <Card title="Treasury automation" icon="arrows-rotate">
    Automate payout workflows with programmatic FX conversion, idempotent requests, and webhook-driven status updates—no manual intervention required.
  </Card>

  <Card title="Multi-currency wallets" icon="wallet">
    Leverage multi-currency wallets (USD, NGN, EUR, GBP, CNY, INR, and more) funded directly in the Yala platform—debit balances programmatically via API with automatic FX conversion.
  </Card>

  <Card title="Embedded finance" icon="bolt">
    Launch branded cross-border remittance flows directly inside your product.
  </Card>

  <Card title="Compliance-friendly flows" icon="shield-halved">
    Build compliant payout flows with idempotency guarantees, webhook notifications, and complete audit trails—every transaction is traceable and secure.
  </Card>
</Columns>

## Get started quickly

<Steps>
  <Step title="Request sandbox access" icon="key" href="mailto:developers@useyala.com">
    Request sandbox access from your Yala relationship manager or email Yala Developer Support at <a href="mailto:developers@useyala.com">[developers@useyala.com](mailto:developers@useyala.com)</a>. Use <code>gateway.staging.useyala.com</code> when testing against the sandbox app.
  </Step>

  <Step title="Get payment methods" icon="calculator" href="/api-reference/endpoint/get-methods">
    Use the methods endpoint to get rates, fees, and required beneficiary fields for your corridor.
  </Step>

  <Step title="Initiate transactions" icon="paper-plane" href="/api-reference/endpoint/initiate">
    Create payouts programmatically, attach compliance metadata, and track status changes via webhooks.
  </Step>
</Steps>

## Resources

<Columns cols={2}>
  <Card title="Postman Collection" icon="file-code" href="/guides/postman-collection">
    Import the ready-to-use Postman collection with all endpoints pre-configured for the payout APIs.
  </Card>

  <Card title="Authentication" icon="lock" href="/guides/authentication">
    Learn how to sign requests with API keys and manage environments securely.
  </Card>

  <Card title="Error handling" icon="triangle-exclamation" href="/guides/errors">
    Standardize how your integration responds to validation, authorization, and upstream issues.
  </Card>

  <Card title="OpenAPI Spec" icon="code">
    Use the OpenAPI specification in this documentation for code generation and API exploration.
  </Card>
</Columns>

<Note>
  Need help or custom payment corridors? Email our developer support team at [developers@useyala.com](mailto:developers@useyala.com).
</Note>
