# Coinbase Payment Sessions API **Canonical:** https://apis.io/apis/coinbase/coinbase-payment-sessions-api/ **Provider:** Coinbase — https://apis.io/providers/coinbase/ **Base URL:** https://api.coinbase.com **Documentation:** https://www.coinbase.com/developer-platform/products/wallet-sdk Coinbase Payment Sessions API is one of 52 APIs that [Coinbase](https://apis.io/providers/coinbase/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 12 JSON Schema definitions. Tagged areas include Payment Sessions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and 12 JSON Schemas. Payment Sessions track the full lifecycle of a merchant payment, from authorization through capture, void, or refund. Each session records every operation and balance change across its lifecycle. **Who initiates an authorization.** A session can be authorized in four ways, split by who acts: - **Customer-initiated:** the payer authorizes at payment time by signing. Use **Authorize a payment session with a wallet** or **Authorize a payment session with x402**. These calls are unauthenticated because the payer's signature is the authorization. - **Merchant-initiated:** the merchant charges against an authorization the payer granted earlier, with the payer no longer present. Use **Authorize a payment session with a mandate** (draws on a mandate's standing spending allowance) or **Authorize a payment session with a Coinbase account** (charges a Coinbase account the payer linked over OAuth). Creating, listing, canceling, capturing, voiding, and refunding a session are merchant actions authenticated with your API key. ## Operations (20) | Method | Path | Summary | |---|---|---| | POST | `/v2/payment-sessions` | Create a payment session | | GET | `/v2/payment-sessions` | List payment sessions | | GET | `/v2/payment-sessions/{paymentSessionId}` | Get a payment session | | POST | `/v2/payment-sessions/{paymentSessionId}/cancel` | Cancel a payment session | | GET | `/v2/payment-sessions/{paymentSessionId}/authorizations/wallet/options` | Get wallet authorization options | | POST | `/v2/payment-sessions/{paymentSessionId}/authorizations/wallet` | Authorize a payment session with a wallet | | POST | `/v2/payment-sessions/{paymentSessionId}/authorizations/x402` | Authorize a payment session with x402 | | POST | `/v2/payment-sessions/{paymentSessionId}/authorizations/coinbase` | Authorize a payment session with a Coinbase account | | POST | `/v2/payment-sessions/{paymentSessionId}/authorizations/mandate` | Authorize a payment session with a mandate | | GET | `/v2/payment-sessions/{paymentSessionId}/authorizations` | List payment session authorizations | | GET | `/v2/payment-sessions/{paymentSessionId}/authorizations/{authorizationId}` | Get a payment session authorization | | POST | `/v2/payment-sessions/{paymentSessionId}/captures` | Capture a payment session | | GET | `/v2/payment-sessions/{paymentSessionId}/captures` | List payment session captures | | GET | `/v2/payment-sessions/{paymentSessionId}/captures/{captureId}` | Get a payment session capture | | POST | `/v2/payment-sessions/{paymentSessionId}/voids` | Void a payment session | | GET | `/v2/payment-sessions/{paymentSessionId}/voids` | List payment session voids | | GET | `/v2/payment-sessions/{paymentSessionId}/voids/{voidId}` | Get a payment session void | | POST | `/v2/payment-sessions/{paymentSessionId}/refunds` | Refund a payment session | | GET | `/v2/payment-sessions/{paymentSessionId}/refunds` | List payment session refunds | | GET | `/v2/payment-sessions/{paymentSessionId}/refunds/{refundId}` | Get a payment session refund | ## Machine-readable artifacts (21) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/openapi/coinbase-payment-sessions-api-openapi.yml - **Documentation** — https://docs.cdp.coinbase.com/coinbase-app/advanced-trade-apis/rest-api - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-advanced-trade-asyncapi.yml - **Documentation** — https://docs.cdp.coinbase.com/exchange/docs/welcome - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-exchange-asyncapi.yml - **Documentation** — https://docs.cdp.coinbase.com/prime/docs/rest-requests - **Documentation** — https://docs.cdp.coinbase.com/onramp/docs/welcome - **Documentation** — https://commerce.coinbase.com/docs/api - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/asyncapi/coinbase-commerce-webhooks-asyncapi.yml - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-conversion-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-currency-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-payment-method-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-transfer-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-transaction-summary-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-price-book-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-product-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-candle-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-trade-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-order-book-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-trade-2-schema.json - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/coinbase/refs/heads/main/json-schema/coinbase-profile-schema.json ## Other Coinbase APIs (12) - [Coinbase Wallet SDK](https://apis.io/apis/coinbase/wallet-sdk/) - [Coinbase Data API](https://apis.io/apis/coinbase/data-api/) - [Coinbase AgentKit](https://apis.io/apis/coinbase/agentkit/) - [Coinbase Accounts API](https://apis.io/apis/coinbase/coinbase-accounts-api/) - [Coinbase Activities API](https://apis.io/apis/coinbase/coinbase-activities-api/) - [Coinbase Address Book API](https://apis.io/apis/coinbase/coinbase-address-book-api/) - [Coinbase Allocations API](https://apis.io/apis/coinbase/coinbase-allocations-api/) - [Coinbase Assets API](https://apis.io/apis/coinbase/coinbase-assets-api/) - [Coinbase Balances API](https://apis.io/apis/coinbase/coinbase-balances-api/) - [Coinbase Buy API](https://apis.io/apis/coinbase/coinbase-buy-api/) - [Coinbase Charges API](https://apis.io/apis/coinbase/coinbase-charges-api/) - [Coinbase Checkouts API](https://apis.io/apis/coinbase/coinbase-checkouts-api/) ## Tags Payment Sessions --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/coinbase/coinbase-payment-sessions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/coinbase/.