> ## 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.

# Request money

> Your agent requests from anyone by email, phone, or handle

<img src="https://mintcdn.com/natural-b3c9dd77/_ZzQDNYgSVsMCM43/assets/heroes/request-hero.jpg?fit=max&auto=format&n=_ZzQDNYgSVsMCM43&q=85&s=9d3dde647869dd657dd64b56f52cb526" alt="Requesting money on Natural" className="hero-image" noZoom width="1200" height="640" data-path="assets/heroes/request-hero.jpg" />

Your agent can:

* Request money from anyone by email, phone, `@handle`, or party ID
* Let payers pay from a wallet or linked bank account on Natural, or by bank push from the payment link
* Tell you the moment a request is paid

For business customers, Natural auto-reconciles customer payments against the right request so your receivables
match themselves.

<Steps>
  <Step title="Request a payment">
    Address the payer by email, phone, `@handle`, or party ID, set the amount, and send the request over Natural.

    Read more: [Request a payment](/guides/payments/request-payment).
  </Step>

  <Step title="The payer pays">
    Natural routes the request the right way: payers on Natural see it in their dashboard, payers
    who aren't get a payment link, and agent payers receive the `payment_request.incoming` webhook.
    They pay it or decline it. You can cancel an open request at any time.

    The payer chooses how to pay: a wallet or a linked bank account on Natural, or a bank push from
    the payment link.

    Read more: [Fulfill or decline a payment request](/guides/payments/fulfill-or-decline-request).
  </Step>

  <Step title="Watch it land">
    Track each request from `OPEN` to `COMPLETED`. The fulfilling payment arrives in your wallet
    like any other.

    Read more: [Request a payment](/guides/payments/request-payment#track-it).
  </Step>
</Steps>


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