> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useagentbank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Portal get payment

> Read a merchant-owned payment aggregate and its observed timeline through the portal API.

```text theme={null}
GET /v1/merchant/payments/:paymentId
```

**Authentication:** `Authorization: Bearer <portal_jwt>`.

## Path parameters

| Parameter | Required | Description |
| - | - | - |
| `paymentId` | Yes | Merchant-owned `pay_...` payment ID. |

```bash theme={null}
curl -sS "$AGENTBANK_BASE_URL/v1/merchant/payments/pay_..." \
  -H "Authorization: Bearer $PORTAL_JWT"
```

## Response

```json theme={null}
{
  "payment_id": "pay_...",
  "merchant_payment_reference": "invoice-1042",
  "status": "in_progress",
  "terminal": false,
  "successful": false,
  "next_action": {"type":"wait","instruction":"Payment is being processed.","poll_after_seconds":10},
  "timeline": [
    {
      "step_id": "step_...",
      "hop_index": 0,
      "event": "crypto_received",
      "detail": "6 USDC received by payment provider. Transaction 0x...",
      "tx_hash": "0x..."
    }
  ]
}
```

The response matches the signed [Get payment](../partner/get-payment) resource
but is read-only and authenticated with the portal JWT.