Retrieve a payment intent
title: "Retrieve a payment intent" description: "GET /v1/payment-intents/:id — fetch the latest status and on-chain details for an intent." section: "API reference" order: 12 updated: "2026-04-18" sourcePath: "content/docs/api/payment-intents/retrieve.mdx"
GET/v1/payment-intents/:id
Returns the current state of a payment intent. The API is the source of truth — call this on application startup to backfill any webhooks you may have missed.
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | required | Payment intent ID, e.g. pi_3L9k...42. |
Example
curl https://api.bchainpay.com/v1/payment-intents/pi_3L9k42 \
-H "Authorization: Bearer $BCHAINPAY_API_KEY"Response — 200 OK
{
"id": "pi_3L9k...42",
"object": "payment_intent",
"status": "completed",
"amount_cents": 4999,
"currency": "USD",
"settlement_currency": "USDC",
"network": "polygon",
"address": "0x9f3a...b41C",
"pocket_id": "pkt_usdc_polygon",
"tx_hash": "0x7d2e...01ab",
"confirmations": 32,
"reference": "INV-2026-001",
"expires_at": "2026-04-18T13:00:00Z",
"created_at": "2026-04-18T12:00:00Z",
"completed_at": "2026-04-18T12:08:11Z"
}Errors
| Status | Code | Meaning |
|---|---|---|
404 | payment_intent_not_found | No intent with that ID belongs to this merchant. |