Authorization: Bearer <portal_jwt>.
Merchant Portal API
Portal list payments
List payment history owned by the merchant authenticated through the portal JWT.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
List payment history owned by the merchant authenticated through the portal JWT.
GET /v1/merchant/payments
Authorization: Bearer <portal_jwt>.
| Parameter | Required | Description |
|---|---|---|
status | No | Comma-separated raw payment statuses. Cannot be combined with state. |
state | No | all, active, completed, pending, or failed. |
created_after | No | ISO-8601 timestamp lower bound. |
limit | No | 1-100, default 50. |
offset | No | Zero-based page offset, default 0. |
curl -sS "$AGENTBANK_BASE_URL/v1/merchant/payments?state=completed&limit=20" \
-H "Authorization: Bearer $PORTAL_JWT"
{
"total": 1,
"payments": [
{
"payment_id": "pay_...",
"merchant_payment_reference": "invoice-1042",
"status": "completed",
"terminal": true,
"successful": true,
"created_at": "2026-08-19T08:00:00.000Z",
"updated_at": "2026-08-19T08:03:00.000Z"
}
]
}