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

> ## Agent Instructions
> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.
> When operating Natural directly for a user, use the payments MCP at `https://mcp.natural.com`.
> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.
> Use the Natural CLI for terminal and CI automation.
> Use REST only for unsupported languages or when the user explicitly requests raw HTTP.
> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.
> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.
> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.

# Payments over Voice

> Turn a phone call into a PCI-compliant payment

<img src="https://mintcdn.com/natural-b3c9dd77/_ZzQDNYgSVsMCM43/assets/heroes/voice-hero.jpg?fit=max&auto=format&n=_ZzQDNYgSVsMCM43&q=85&s=55dc4f10f98a9cc7f43ed994cbfff3e1" alt="Accepting a payment over Voice on Natural" className="hero-image" noZoom width="1200" height="640" data-path="assets/heroes/voice-hero.jpg" />

Natural takes card payments over the phone so your voice platform never touches card data.

Your agent can:

* Transfer a call to Natural's card collection agent and get the call back when the payment is done
* Collect card details and charge that card synchronously over a call
* Get voice logs in the dashboard and via API

<Steps>
  <Step title="Get set up for Voice">
    Complete the prerequisites in [Accept payments](/guides/flows/accept-payments).
    Voice requires additional setup to connect your voice platform. Contact
    [hi@natural.com](mailto:hi@natural.com) to get started.
  </Step>

  <Step title="Transfer to Natural">
    Create a payment intent with
    [`POST /payment-intents`](/api-reference/payment-intents/create-payment-intent), then create a
    voice session for that payment intent with
    [`POST /voice/sessions`](/api-reference/voice/create-voice-session).
    Transfer the call to the `dialUri` Natural returns. Natural's agent takes the card and
    processes the payment.

    Read more: [Take a payment over voice](/guides/voice/take-a-payment).
  </Step>

  <Step title="Track payments and review call logs">
    Subscribe to `paymentIntent.completed`, `cardPayment.succeeded`, and `cardPayment.failed`
    webhooks for payment updates, and to `voiceSession.completed` to learn whether each call
    was paid, fell back to a texted checkout link, or ended unpaid. View session logs and transcripts in the dashboard or through
    the API, with card details redacted.

    Read more: [Event catalog](/api-reference/event-catalog) and
    [Call log and transcripts](/guides/voice/call-log).
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.