RevKeen Docs
Api reference

List payment intents

Returns a list of payment intents with optional filtering.

Related endpoints

  • POST /payment-intents — Create a payment intent
  • GET /payment-intents/{id} — Retrieve a payment intent
  • POST /payment-intents/{id} — Update a payment intent
  • POST /payment-intents/{id}/confirm — Confirm a payment intent
  • POST /payment-intents/{id}/capture — Capture a payment intent
  • POST /payment-intents/{id}/cancel — Cancel a payment intent

Common errors

  • 401 unauthenticated — missing, malformed, or revoked API key.

Pagination

Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.

GET
/payment-intents

Authorization

x-api-key<token>

Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.

In: header

Query Parameters

customer?string

Filter by customer ID

Formatuuid
status?string

Filter by status

Value in"requires_payment_method" | "requires_confirmation" | "requires_action" | "processing" | "succeeded" | "canceled"
created_gte?|

Filter by created_at >= (Unix timestamp)

created_lte?|

Filter by created_at <= (Unix timestamp)

limit?integer

Maximum number of results (1-100)

Default20
Range1 <= value <= 100
starting_after?string

Cursor for pagination - return results after this ID (pi_xxx)

ending_before?string

Cursor for pagination - return results before this ID (pi_xxx)

Response Body

application/json

application/json

curl "https://api.revkeen.com/v2/payment-intents" \  -H "x-api-key: $REVKEEN_API_KEY"
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "object": "payment_intent",
      "amount": 0,
      "amount_capturable": 0,
      "amount_received": 0,
      "currency": "string",
      "customer": "0ac6320b-fa4d-4235-8d23-413a2b863bad",
      "description": "string",
      "last_payment_error": {
        "code": "string",
        "message": "string",
        "decline_code": "string",
        "payment_method": {
          "id": "string",
          "type": "string"
        }
      },
      "metadata": {},
      "next_action": {
        "type": "redirect_to_url",
        "redirect_to_url": {
          "url": "http://example.com",
          "return_url": "http://example.com"
        }
      },
      "payment_method": "f4815f3e-3832-4ed6-92fd-134ab34dea26",
      "receipt_email": "user@example.com",
      "statement_descriptor": "string",
      "statement_descriptor_suffix": "string",
      "status": "requires_payment_method",
      "capture_method": "automatic",
      "client_secret": "string",
      "canceled_at": "2019-08-24T14:15:22Z",
      "cancellation_reason": "duplicate",
      "created": 0,
      "livemode": true
    }
  ],
  "has_more": true,
  "url": "string"
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string"
  }
}
Edit on GitHub