Refund Checkout
Refund a completed Coinbase Business checkout. Supports full and partial refunds. The refund amount must not exceed the remaining refundable amount. Ideal for: customer refunds, order cancellations, dispute resolution, overpayment returns.
Catalog action Integrations coinbase-business
Refund a completed Coinbase Business checkout. Supports full and partial refunds. The refund amount must not exceed the remaining refundable amount. Ideal for: customer refunds, order cancellations, dispute resolution, overpayment returns.
At a Glance
| Field | Value |
|---|---|
| Action ID | coinbase-business-refund-checkout |
| Category | Integrations |
| Connector | coinbase-business |
| Requires gas | No |
| Funds movement | None declared |
| Tags | coinbase, checkout, refund, payment, crypto, finance, write |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
checkoutId | string | Yes | Checkout ID to refund (24-char hex string). Must be a COMPLETED checkout. |
amount | string | Yes | Refund amount (max 2 decimal places). Must not exceed remaining refundable amount. |
currency | string | No | Refund currency. Defaults to checkout's original fiat currency or USDC. |
reason | string | No | Optional reason for the refund (max 500 characters) |
idempotencyKey | string | No | Idempotency key to prevent duplicate refunds on retry. Use a deterministic value (e.g., runId + nodeId) for workflow-triggered refunds. |
apiKeyName | string | No | CDP API Key Name (overrides connector) |
apiKeySecret | string | No | CDP API Key Secret (overrides connector) |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
checkout | object | Yes | Updated checkout with current status |
refund | object | Yes | Refund details |
Examples
json{ "type": "coinbase-business-refund-checkout", "payload": { "checkoutId": "example-checkoutId", "amount": "1000000" }, "children": [], "connector": { "type": "coinbase-business", "id": "conn_coinbase_business" }}
bashcurl -X POST "https://api.b3os.org/v1/actions/coinbase-business-refund-checkout/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "checkoutId": "example-checkoutId", "amount": "1000000" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.