Prepare the next repayment transaction
Refreshes current dues and returns the next unsigned transaction. This endpoint is normally called by the SDK after a TOKEN_APPROVAL transaction confirms, or to retry an expired preparation. Approval and REPAYMENT amounts use the fixed maximum established when the repayment resource was created. If fresh dues exceed that fixed maximum, Qiro fails the repayment with REPAYMENT_QUOTE_EXPIRED and the partner must create a fresh repayment.
- : Create and prepare repayments.
Stable Qiro identifier for one drawdown repayment workflow.
rpy_01J5TC7H3ABMPattern: ^rpy_[A-Za-z0-9]+$Optional end-to-end request identifier. The SDK supplies one automatically; Qiro generates and echoes one when absent.
cor_repayment_123Next unsigned transaction in the repayment flow.
^rpy_[A-Za-z0-9]+$^(0|[1-9]\d*)$^(0|[1-9]\d*)$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 requested workflow resource 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/repayments/{repayment_id}/prepare HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"repayment_id": "rpy_01J5TC7H3ABM",
"status": "SUBMITTING",
"action": "REPAYMENT",
"sequence": 2,
"amount_base_units": "500440449041000000000000",
"maximum_repayment_base_units": "500440449041000000000000",
"expires_at": "2026-08-12T11:12:00Z",
"transaction": {
"chain_id": 421614,
"to": "0x57923bc2f063a06abc88a1a1c49109191034246e",
"data": "0x1234abcd",
"value": "0"
}
}Last updated