Skip to main content
GET
/
v2
/
payment-sessions
/
{paymentSessionId}
/
refunds
List payment session refunds
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/payment-sessions/{paymentSessionId}/refunds \
  --header 'Authorization: Bearer <token>'
{
  "refunds": [
    {
      "refundId": "refund_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
      "paymentSessionId": "paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
      "source": {
        "accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
        "asset": "usdc"
      },
      "status": "succeeded",
      "amount": "0.50",
      "metadata": {
        "customer_id": "cust_12345",
        "order_id": "order_67890"
      },
      "reason": "Customer returned the item.",
      "onchainTransactions": [
        {
          "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
          "network": "base"
        }
      ],
      "createdAt": "2025-06-15T12:40:00.000Z",
      "updatedAt": "2025-06-15T12:41:00.000Z"
    }
  ],
  "nextPageToken": "eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="
}

Authorizations

​
Authorization
string
header
required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

​
paymentSessionId
string
required

The unique identifier of the payment session. The ID of the payment session, a UUID prefixed by paymentSession_.

Pattern: ^paymentSession_[a-f0-9\-]{36}$
Example:

"paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad"

Query Parameters

​
pageSize
integer
default:20

The number of resources to return per page.

​
pageToken
string

The token for the next page of resources, if any.

Response

Successfully listed refunds.

​
refunds
object[]
required

The list of refunds.

​
nextPageToken
string

The token for the next page of items, if any.

Example:

"eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="