Prepare the borrower transaction
Returns unsigned calldata only while the drawdown is READY_FOR_SUBMISSION, or returns the same unexpired stored preparation for an idempotent retry. Preparations are valid for ten minutes. Preparation atomically moves the resource to SUBMITTING because the transaction may be broadcast immediately after this response.
The partner signs and broadcasts the returned transaction using the designated wallet. Qiro never receives a private key and this endpoint does not submit a blockchain transaction. The Qiro SDK can perform preparation, wallet submission, and immediate receipt verification as one client-side method.
- : Create and prepare partner drawdowns.
Stable Qiro identifier for one partner drawdown workflow.
drw_01J5T6CNR5ZEPattern: ^drw_[A-Za-z0-9]+$End-to-end request identifier. When the body contains correlation_id, both values must match.
cor_drawdown_123A short-lived unsigned transaction bound to the approved facility and wallet.
Invalid schema, field format, or correlation identifier.
The bearer token is missing, invalid, or expired.
The authenticated partner does not own the resource or lacks the required scope.
The drawdown was not found for the authenticated partner.
Idempotency, workflow state, or verified facility identity conflicts with the request.
The request is valid but rejected by facility, policy, liquidity, or contract rules.
Contract, RPC, subgraph, or reconciliation infrastructure is temporarily unavailable.
POST /v1/drawdowns/{drawdown_id}/prepare HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
X-Correlation-ID: text
Accept: */*
{
"drawdown_id": "drw_01J5T6CNR5ZE",
"status": "SUBMITTING",
"expires_at": "2026-08-12T10:40:00Z",
"transaction": {
"chain_id": 421614,
"to": "0x57923bc2f063a06abc88a1a1c49109191034246e",
"data": "0x1234abcd",
"value": "0"
}
}Last updated