StepFi-app/StepFi-DocsLight logoStepFi Protocol

Loans API

BNPL loan management endpoints

Loans API

Manage BNPL loans through the StepFi API.

Create Loan

POST /api/v1/loans
Authorization: Bearer {token}
Content-Type: application/json

{
  "vendorAddress": "GVENDOR...",
  "amount": 110000000,
  "installments": 6,
  "loanType": "LearnerInstallment"
}

Amount is in stroops (1 XLM = 10,000,000 stroops). For USDC, 1 USDC = 10,000,000 units.

Response returns unsigned XDR that the learner must sign with their wallet.

Get Loan

GET /api/v1/loans/:id
Authorization: Bearer {token}

List My Loans

GET /api/v1/loans?page=1&limit=10
Authorization: Bearer {token}

Repay Installment

POST /api/v1/loans/:id/repay
Authorization: Bearer {token}
Content-Type: application/json

{
  "installmentIndex": 0
}

Returns unsigned XDR for the learner to sign.

Edit this page on GitHub
Authentication
Reputation