curl -X POST 'https://api.stateset.com/v1/finance/invoices/factor' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"invoice_id": "inv_12345",
"amount": "50000.00",
"currency": "USDC",
"discount_rate": 0.025,
"buyer": {
"id": "did:stateset:buyer:abc123",
"credit_rating": "AAA",
"payment_history": "excellent"
},
"terms": { "net_days": 30, "due_date": "2024-07-25" },
"recourse": false
}'
{
"factoring_id": "fact_8y4mQr5oP2",
"invoice_id": "inv_12345",
"status": "FUNDED",
"advance_amount": "48750.00",
"discount_amount": "1250.00",
"discount_rate": 0.025,
"funded_at": "2024-06-25T12:05:00Z",
"maturity_date": "2024-07-25T23:59:59Z",
"transaction_hash": "0x742d35Cc6634C0532925a3b8D097C00D4dfece08"
}
Factor Invoice
Sell an outstanding invoice for immediate ssUSD, at a discount, without waiting for the buyer to pay.
POST
/
v1
/
finance
/
invoices
/
factor
curl -X POST 'https://api.stateset.com/v1/finance/invoices/factor' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"invoice_id": "inv_12345",
"amount": "50000.00",
"currency": "USDC",
"discount_rate": 0.025,
"buyer": {
"id": "did:stateset:buyer:abc123",
"credit_rating": "AAA",
"payment_history": "excellent"
},
"terms": { "net_days": 30, "due_date": "2024-07-25" },
"recourse": false
}'
{
"factoring_id": "fact_8y4mQr5oP2",
"invoice_id": "inv_12345",
"status": "FUNDED",
"advance_amount": "48750.00",
"discount_amount": "1250.00",
"discount_rate": 0.025,
"funded_at": "2024-06-25T12:05:00Z",
"maturity_date": "2024-07-25T23:59:59Z",
"transaction_hash": "0x742d35Cc6634C0532925a3b8D097C00D4dfece08"
}
Overview
Factoring converts an unpaid invoice into cash now. You receive the advance amount — the invoice face value less the discount — and the funder collects from the buyer at maturity. The discount rate you’re offered is driven by the buyer’s credit, not yours. CallGET /v1/finance/invoices/{invoice_id}/factoring-options first to see the competing rates before
committing to one — see Finance.
recourse decides who absorbs a buyer default. With recourse: false the funder takes the loss;
with true you are liable to repay the advance. Non-recourse costs a higher discount rate — that
spread is the price of the risk transfer. Set it deliberately.Body
string
required
The invoice to factor. Must be outstanding and unpaid.
string
required
Invoice face value, as a decimal string.
string
required
Settlement currency —
USDC or ssUSD.number
required
The agreed rate as a decimal —
0.025 is 2.5%. Take this from the factoring options response
rather than proposing your own.object
required
object
required
boolean
Whether you remain liable if the buyer defaults. Defaults to
false.Response
string
required
Identifier for the factoring position. Track it with
GET /v1/finance/factoring/{factoring_id}.string
required
The invoice that was factored.
string
required
FUNDED once the advance has settled.string
required
What you receive — face value less the discount.
string
required
The fee retained by the funder.
number
required
The rate applied.
string
required
When the advance settled.
string
required
When the buyer’s payment is due.
string
required
On-chain hash of the settlement.
Errors
Succeeds with201. Failures return 400, 401, 403, 422 or 429 with an error body, per the platform status-code contract.
curl -X POST 'https://api.stateset.com/v1/finance/invoices/factor' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"invoice_id": "inv_12345",
"amount": "50000.00",
"currency": "USDC",
"discount_rate": 0.025,
"buyer": {
"id": "did:stateset:buyer:abc123",
"credit_rating": "AAA",
"payment_history": "excellent"
},
"terms": { "net_days": 30, "due_date": "2024-07-25" },
"recourse": false
}'
{
"factoring_id": "fact_8y4mQr5oP2",
"invoice_id": "inv_12345",
"status": "FUNDED",
"advance_amount": "48750.00",
"discount_amount": "1250.00",
"discount_rate": 0.025,
"funded_at": "2024-06-25T12:05:00Z",
"maturity_date": "2024-07-25T23:59:59Z",
"transaction_hash": "0x742d35Cc6634C0532925a3b8D097C00D4dfece08"
}
Related
- Finance API — factoring, PO financing, and lending
- Pay Invoice
- Loan Request — borrow against collateral instead
Last modified on August 29, 2026