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 the request
Create a request with POST /v2/request.
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.Repeat until fully paid
Execute additional partial payments as needed until the request reaches full settlement.
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 viaGET /v2/request/{requestId}/pay.
Commonly used with:
- Native & ERC20 payments
- Conversion payments
- Crosschain payments
Used In
Invoicing
Large invoice installments
Checkout
Flexible payment options