> For the complete documentation index, see [llms.txt](https://docs.qiro.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qiro.fi/developer-section/qiro-instant-settlement.md).

# Qiro Instant Settlement

Qiro Instant Settlement lets an approved partner request, track, and repay credit against a Qiro-managed revolving line of credit.

The integration is non-custodial. Qiro validates workflow state, prepares unsigned blockchain transactions, reconciles verified contract events, and sends signed webhooks. The partner controls the designated wallet, signs transactions, broadcasts them, and pays gas. Qiro never receives the wallet private key.

Status APIs are the system of record. Webhooks are at-least-once notifications that help the partner react quickly, but the partner should reconcile final state through the relevant status endpoint.

## What to use

| Business task                | Recommended SDK/API path                                           |
| ---------------------------- | ------------------------------------------------------------------ |
| Authenticate                 | `POST /oauth/token`                                                |
| Read approved facility state | `GET /v1/facilities/{facility_id}`                                 |
| Request a drawdown           | SDK `requestDrawdown(...)` or drawdown REST workflow               |
| Activate a pending facility  | SDK `activateFacility(...)` or activation REST workflow            |
| Repay one funded drawdown    | SDK `repayDrawdown(...)` or repayment REST workflow                |
| Repay and close a facility   | SDK `repayAndCloseFacility(...)` or facility closure REST workflow |
| Receive lifecycle updates    | Signed webhooks plus status reconciliation                         |

Default recovery and drawdown cancellation are planned contract workflows, but they are not enabled in the current partner API or SDK.

The exact API contract is maintained in the OpenAPI specification file at `openapi.yaml`. The GitBook owner will register that file and insert the rendered OpenAPI Reference separately.

## Documentation map

* [Overview](https://docs.qiro.fi/developer-section/qiro-instant-settlement/overview.md)
* [Authentication](https://docs.qiro.fi/developer-section/qiro-instant-settlement/authentication.md)
* [Facilities](https://docs.qiro.fi/developer-section/qiro-instant-settlement/facilities.md)
* [Drawdowns](https://docs.qiro.fi/developer-section/qiro-instant-settlement/drawdowns.md)
* [Repayments](https://docs.qiro.fi/developer-section/qiro-instant-settlement/repayments.md)
* [Facility closures](https://docs.qiro.fi/developer-section/qiro-instant-settlement/facility-closures.md)
* [Facility activation](https://docs.qiro.fi/developer-section/qiro-instant-settlement/facility-activation.md)
* [SDK](https://docs.qiro.fi/developer-section/qiro-instant-settlement/sdk.md)
* [Webhooks](https://docs.qiro.fi/developer-section/qiro-instant-settlement/webhooks.md)
* [Errors and idempotency](https://docs.qiro.fi/developer-section/qiro-instant-settlement/errors-and-idempotency.md)
