> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoice Collection

> Automate invoice uploads and buyer details with seamless SFTP integration.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

<Warning>
  **Watch Out!**

  1. Invoice collection is mandatory for any import payment to be eligible for settlement.
  2. Turnaround Time (TAT) for settlement begins **only after a valid invoice** is uploaded.
  3. Ensure each invoice contains the following details:
     * Unique invoice number (Partner's invoice ID or Razorpay Order ID).
     * Partner's or business name.
     * Partner's or business address.
     * Customer's complete address.
     * Description of goods/services.
     * Units sold (time period, quantity and so on).
     * Amount in INR (2 decimal places only. For example, ₹2341.23).
     * Taxes applied.
</Warning>

## Invoice Submission via SFTP

You can automate invoice uploads using **Secure File Transfer Protocol (SFTP)**, enabling streamlined, secure file transfer.

### Steps to Connect with Razorpay via SFTP

<AccordionGroup>
  <Accordion title="Share Your Public Key">
    * Required for setting up SFTP credentials and folder access.
    * Submit your SSH public key to your Razorpay point of contact.
    * **Supported SSH key formats**:
      * RSA (2048-bit or higher). For example, `ssh-rsa`.
      * ECDSA. For example, `ssh-ecdsa`.
      * Ed25519. For example, `ssh-ed25519`.
    * Ensure your key is in the correct format. Using an unsupported or incorrectly formatted key will result in authentication failure.

    <Warning>
      **Watch Out!**

      Never share your private key with anyone. Only the public key should be provided to Razorpay.
    </Warning>
  </Accordion>

  <Accordion title="IP Whitelisting">
    * Only requests from your whitelisted IPs will be accepted.
    * Share a list of authorised outbound IPs to enable secure access.
    * Maximum of 4 IP addresses can be whitelisted.
    * SFTP access will work only from the whitelisted IPs. Attempting to connect from any other IP address will result in connection failure.
  </Accordion>

  <Accordion title="Credentials & Access Details">
    * Razorpay will provide:
      * Hostname: `sftp.razorpay.com`
      * Port: `22`
      * Username
      * Path prefix (based on your `MID`)
    * Use your **private key** (corresponding to the public key you shared) to authenticate while connecting to Razorpay's SFTP.
    * Use an SFTP client to connect.
    * **Test your connection**: Run `telnet sftp.razorpay.com 22` to verify connectivity before attempting SFTP access.
  </Accordion>
</AccordionGroup>

## How to Share Invoices via SFTP

<AccordionGroup>
  <Accordion title="File Path Format">
    Use the following folder and file structure:
    "/invoiceUpload/automated/\< MID >/YYYY-MM-DD/InvoiceNumber.pdf." <br />
    For example: `/invoiceUpload/automated/MDoeHNNpi0nB7m/2025-05-10/INV_09876.pdf`

    <Warning>
      **Watch Out!**

      * You must include your Merchant ID (MID) in the path.
      * You must include the date folder in `YYYY-MM-DD` format.
      * Missing either component will result in upload failure.
      * Once uploaded, invoices become read-only. You cannot edit, rename or delete files after you upload.
      * Do not attempt to upload the same invoice multiple times to the same path.
    </Warning>
  </Accordion>

  <Accordion title="File Types and Flows">
    | Direction         | Filename Format     | Description                                                                                                                       |
    | ----------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
    | Client → Razorpay | `InvoiceNumber.pdf` | Inbound File: This will be the invoices submitted by you to Razorpay. It should always be in PDF format. Example: `INV_09876.pdf` |
  </Accordion>
</AccordionGroup>

## Invoice ID Validation Process

Razorpay enforces strong validation rules to prevent duplicate or invalid invoice usage.

<AccordionGroup>
  <Accordion title="Successful Payments">
    * **Status**: `Captured`
    * **Invoice Action**: Permanently blocked
    * **Note**: Same invoice ID cannot be reused.
  </Accordion>

  <Accordion title="Failed Payments">
    * **Status**: `Failed`
    * **Invoice Action**: Released
    * **Note**: Invoice ID can be reused.
  </Accordion>

  <Accordion title="Payments in Intermediate States">
    * **Status**: `Created` or `Authorised`
    * **Invoice Action**: Temporarily blocked
    * **Note**: Invoice ID is reusable only after final status (`Failed` or `Captured`) is reached.
  </Accordion>
</AccordionGroup>

### Refunded Payments

<AccordionGroup>
  <Accordion title="Auto-Refunded (Never Captured)">
    * **Status**: `Refunded`
    * **Action**: Invoice ID is released.
    * **Note**: ID can be reused.
  </Accordion>

  <Accordion title="Merchant-Initiated Refund (Post-Capture)">
    * **Status**: `Refunded`
    * **Action**: Invoice ID is permanently blocked.
    * **Note**: Cannot be reused.
  </Accordion>
</AccordionGroup>

Partial capture scenarios are not validated by default. Contact Razorpay [Support team](https://razorpay.com/support/).

## AML Screening Process

As per RBI regulations, payments to offshore accounts must undergo AML (Anti-Money Laundering) checks by Razorpay's Authorised Dealer (AD) Bank.

<AccordionGroup>
  <Accordion title="Daily AML Communication">
    * You will receive daily emails listing transactions **flagged** for additional details.
    * **Subject Line**: `Additional Details Required - [Business Name]_MDoeHNNpi0nB7m`.
  </Accordion>

  <Accordion title="Turnaround Time">
    * Share required information within **5 working days** to avoid auto-cancellation.
    * Information may include: Full name, address, ownership, percentage of ownership, nature of business, purpose of payment, business website, company, date of birth/incorporation, place of birth/incorporation and so on.
  </Accordion>

  <Accordion title="Consequences of Delay">
    Missing TAT results in:

    * Razorpay lien-marking the funds or
    * Refund initiation via Dashboard/API.
  </Accordion>
</AccordionGroup>

## Best Practices for Invoice IDs

To ensure seamless experience and compliance:

* **Always generate unique invoice IDs** per payment.
* Acceptable IDs:
  * Razorpay `order_id`.
  * Your internal unique invoice number.
* Do not reuse invoice IDs for different transactions unless the original payment has failed.