تاجر جني
Which API?
Merchant API For merchants: manage your own catalogue, orders and finances through the v2 Third-Party API. Application API For partner apps: browse Gini merchants and products, send customers to checkout and follow their orders.

New: Application API docs

Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.

Merchant dashboard
Finance API
Debts

API documentation

Everything you need to integrate with the Gini v2 Third-Party API.

Getting started API reference Store API Finance API Settings API Insights API Wholesale API Resources
Settlements Debts Transactions

Debts

List your debts and read the payments made against any one — the same data as the dashboard's Debts wallet. Read-only.

List debts

Your debts, newest first, each with what is paid and what remains. Paginated.

GET /api/v2.0/third-party/debts
Signed
Query parameters
Field Type Required Description
status string Optional paid or unpaid.
per_page integer Optional 1–100, default 15.
Response 
{
    "data": [
        {
            "id": 7,
            "description": "Chargeback",
            "amount": "50000.00",
            "paid_amount": "20000.00",
            "remaining": "30000.00",
            "is_fully_paid": false,
            "is_fully_paid_at": null,
            "created_at": "2026-08-01T09:00:00.000000Z"
        }
    ],
    "links": [],
    "meta": []
}
Notes
  • remaining is computed (amount − paid_amount, never below zero).
Get a debt

One debt with the payments made against it and the settlement each came from.

GET /api/v2.0/third-party/debts/{debt}
Signed
Notes
  • A debt that is not yours returns HTTP 404 with {'message': 'Debt not found'}.
Debt stats

Your debts wallet at a glance — total owed, paid and outstanding, with paid/unpaid counts.

GET /api/v2.0/third-party/debts/stats
Signed
Previous Settlements Next Transactions