Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.request.network/llms.txt

Use this file to discover all available pages before exploring further.

​
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

1

Create the request

Create a request with POST /v2/request.
2

Pay a partial amount

Fetch payment payload with GET /v2/request//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.
3

Repeat until fully paid

Execute additional partial payments as needed until the request reaches full settlement.
4

Track status and breakdown

Check GET /v2/request/ 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

Installment Plans

Break large payments into smaller amounts

Multiple Funders

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

No-code payment links

Large invoice installments via the Dashboard

Programmatic payment links

Flexible payment options via the API

​
API Reference

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