partial-payments.mdx

title	Partial Payments
description	Split payments across multiple transactions and funding sources

Overview

Partial payments let you settle a request over multiple transactions instead of one full payment.

This is useful for installments, split settlement, and staged collections.

How It Works

Create a request with [POST /v2/request](https://api.request.network/open-api/#tag/v2request/POST/v2/request). Fetch payment payload with [GET /v2/request/{requestId}/pay](https://api.request.network/open-api/#tag/v2request/GET/v2/request/{requestId}/pay) and pass `amount` in query parameters to pay only part of the request.

The amount query parameter is human-readable and must be greater than 0.

Execute additional partial payments as needed until the request reaches full settlement. Check [GET /v2/request/{requestId}](https://api.request.network/open-api/#tag/v2request/GET/v2/request/{requestId}) for status and conversion/payment breakdown fields.

Key Behavior

• Partial payments are applied incrementally against the same request
• Request status reflects progress until full settlement
• For conversion flows, breakdown fields expose paid vs remaining values

Use Cases

Break large payments into smaller amounts Group payments or shared expenses

Supported Payment Types

Partial settlement can be used in request-based payment flows where payment payloads are fetched via GET /v2/request/{requestId}/pay.

Commonly used with:

• Native & ERC20 payments
• Conversion payments
• Crosschain payments

Used In

Large invoice installments Flexible payment options

API Reference

For full endpoint schemas and examples, see Request Network API Reference.