Skip to main content
POST
Capture payment

Authorizations

Authorization
string
header
required

Authorization header using the Bearer scheme. Learn more about JWT tokens in the Coinbase Developer Portal.

Headers

x-idempotency-key
string
required

Unique identifier to ensure request idempotency

Path Parameters

paymentId
string
required

The unique identifier of the payment to capture.

Body

application/json

Request payload for capturing a payment using the payment ID. This simplified endpoint fetches payment details from the database.

amount
string
required

Amount to capture in the escrow protocol.

Example:

"50.00"

feeBps
integer<int32>
required

Fee in basis points.

Example:

"50"

feeReceiver
string
required

Address of the fee receiver.

Example:

"0x8078EB517712aAAdcCE9a0C5Ec04dC2DC5Ef8793"

distributeRewards
RewardInput · object[]

List of rewards to distribute during payment capture.

Example:
metadata
Metadata · object

Metadata for the payment operation that will be returned in the webhook.

Example:

Response

A successful response.

Response payload for payment capture requests.

operationId
string
required

Identifier for the payment operation.

Example:

"op-2341434"

rewardOperations
RewardOperation · object[]

List of reward operations with detailed information, if rewards were processed.

Example:
invalidRewardInputs
InvalidRewardInput · object[]

List of rewards that were invalid/unable to be processed with detailed reasoning

Example: