diff --git a/api-features/partial-payments.mdx b/api-features/partial-payments.mdx index 2c44750..f74a1e8 100644 --- a/api-features/partial-payments.mdx +++ b/api-features/partial-payments.mdx @@ -3,30 +3,39 @@ title: "Partial Payments" description: "Split payments across multiple transactions and funding sources" --- - -**AI-Generated Content** – This page was generated with AI assistance and may contain inaccuracies. While likely close to accurate, please verify critical details with the [stable documentation](https://docs.request.network) or [contact support](https://github.com/orgs/RequestNetwork/discussions). - - ## Overview -Partial payments allow requests to be fulfilled through multiple transactions, enabling split payments, installment plans, and flexible funding approaches. +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 -```mermaid -graph TD - A[Request: $1000] --> B[Payment 1: $400] - A --> C[Payment 2: $300] - A --> D[Payment 3: $300] - B --> E[Request Fulfilled] - C --> E - D --> E -``` - -**Benefits:** -- **Flexible Payment Plans:** Installments and split payments -- **Multiple Funding Sources:** Different wallets, chains, or currencies -- **Risk Management:** Partial fulfillment tracking + + +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 @@ -42,15 +51,17 @@ graph TD ## Supported Payment Types -Works with all payment types except Crypto-to-fiat payments: +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 +- Conversion payments - Crosschain payments -- Batch payments ## Used In - + Large invoice installments @@ -58,12 +69,8 @@ Works with all payment types except Crypto-to-fiat payments: Flexible payment options - - - Partial subscription payments - -## Implementation Details +## API Reference -See [API Reference - Partial Payments](/api-reference/partial-payments) for complete technical documentation. \ No newline at end of file +For full endpoint schemas and examples, see [Request Network API Reference](https://api.request.network/open-api).