CommetCommet
GitHubDiscordStatus
Get transaction GETList transactions GETRefund transaction POSTRetry transaction POST
DocumentaciónRecursosConstruir con AIAPI ReferenceWebhooks

List transactions

List payment transactions with cursor-based pagination. Filter by status or customer email.

GET
/transactions

List payment transactions with cursor-based pagination. Filter by status or customer email.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

cursor?string
Length1 <= length
limit?integer
Range1 <= value <= 100
status?string

Value in

  • "pending"
  • "succeeded"
  • "failed"
  • "refunded"
  • "disputed"
customerEmail?string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/transactions"
{  "object": "list",  "data": [    {      "id": "txn_1a2b3c4d",      "invoiceId": "inv_1a2b3c4d",      "grossAmount": 2000,      "subtotal": 2000,      "taxAmount": 0,      "presentmentAmount": 2000,      "currency": "usd",      "provider": "commet",      "status": "succeeded",      "customerEmail": "user@example.com",      "customerName": "user@example.com",      "paidAt": "2026-09-07T12:00:00.000Z",      "createdAt": "2026-09-07T12:00:00.000Z",      "updatedAt": "2026-09-07T12:00:00.000Z",      "object": "transaction",      "livemode": false,      "paymentContext": {        "reason": "recurring_billing",        "paymentLinkId": null,        "recovery": null      }    }  ],  "hasMore": false}
{  "error": {    "type": "validation_error",    "code": "validation_error",    "message": "The request contains an invalid parameter.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/validation_error.md"  }}
{  "error": {    "type": "authentication_error",    "code": "unauthorized",    "message": "A valid API key is required.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/unauthorized.md"  }}
{  "error": {    "type": "authentication_error",    "code": "forbidden",    "message": "You do not have permission to perform this operation.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/forbidden.md"  }}
{  "error": {    "type": "rate_limit_error",    "code": "rate_limited",    "message": "Too many requests. Retry after the interval specified in the Retry-After header.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/rate_limited.md"  }}
{  "error": {    "type": "internal_error",    "code": "internal_error",    "message": "An unexpected error occurred while processing the request.",    "doc_url": "https://commet.co/docs/api-reference/2026-08-27/errors/internal_error.md"  }}

Get transaction GET

Retrieve a single payment transaction by its public ID, including provider details.

Refund transaction POST

Issue a full refund and return the provider-neutral refund resource with its actual status.