wire docs

Retrieve a PaymentIntent

Returns one PaymentIntent. Poll this (or listen for the `payment_intent.succeeded` webhook) to learn whether the buyer paid. Always re-check `status` server-side before fulfilling an order.

GET/v1/payment_intents/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

Secret API key as a bearer token: Authorization: Bearer sk_live_…. Test keys (sk_test_…) are refused with 401 test_mode_unavailable. Keys are issued per project in the dashboard. Never expose a secret key in browser or mobile code.

In: header

Path Parameters

id*string

PaymentIntent id (pi_…).

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/payment_intents/pi_k3vq7m2xw5nbt4rj6yhc2dpa7e"
{
  "id": "pi_k3vq7m2xw5nbt4rj6yhc2dpa7e",
  "object": "payment_intent",
  "amount": 15000,
  "currency": "MNT",
  "description": "Order #1001",
  "status": "requires_action",
  "client_secret": "cs_n2xk5q7mw3tz4vbr6jcy2gfa7m",
  "automatic_operator": true,
  "allowed_operators": [],
  "selected_operator": "op_example",
  "next_action": {
    "type": "qr",
    "qr": {
      "text": "0002010102121531...",
      "deeplinks": [
        {
          "name": "Example bank",
          "link": "examplebank://pay?qr=0002010102121531..."
        }
      ]
    }
  },
  "metadata": {
    "order_id": "1001"
  },
  "livemode": true,
  "created": 1791774000,
  "expires_at": 1791774900
}

{
  "error": {
    "type": "api_error",
    "code": "test_mode_unavailable",
    "message": "test keys are not accepted by this API; use a live secret key",
    "request_id": "req_8f3a1c9e5b7d2f4a6c0e9b1d"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_missing",
    "message": "no such payment_intent",
    "request_id": "req_8f3a1c9e5b7d2f4a6c0e9b1d"
  }
}