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.
Acción de catálogo Integraciones coinbase-business
Reembolsa un checkout completado de Coinbase Business. Admite reembolsos totales y parciales. La cantidad del reembolso no debe exceder el importe reembolsable restante. Ideal para: reembolsos a clientes, anulaciones de pedidos, resolución de disputas, devoluciones por sobrepago.
De un vistazo
| Campo | Valor |
|---|---|
| ID de acción | coinbase-business-refund-checkout |
| Categoría | Integraciones |
| Conector | coinbase-business |
| Requiere gas | No |
| Movimiento de fondos | Ninguno declarado |
| Etiquetas | coinbase, checkout, refund, payment, crypto, finance, write |
Esquema de payload
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
checkoutId | string | Sí | ID del checkout a reembolsar (cadena hexadecimal de 24 caracteres). Debe ser un checkout COMPLETADO. |
amount | string | Sí | Cantidad del reembolso (máx. 2 decimales). No debe exceder el importe reembolsable restante. |
currency | string | No | Moneda del reembolso. Por defecto, la moneda fiat original del checkout o USDC. |
reason | string | No | Motivo opcional del reembolso (máx. 500 caracteres) |
idempotencyKey | string | No | Clave de idempotencia para evitar reembolsos duplicados en reintentos. Utilice un valor determinista (p. ej., runId + nodeId) para reembolsos activados por flujos de trabajo. |
apiKeyName | string | No | Nombre de la clave API de CDP (sobrescribe el conector) |
apiKeySecret | string | No | Secreto de la clave API de CDP (sobrescribe el conector) |
Esquema de resultado
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
checkout | object | Sí | Checkout actualizado con el estado actual |
refund | object | Sí | Detalles del reembolso |
Ejemplos
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" }}'
Los campos de carga útil pueden utilizar expresiones de flujo de trabajo como {{$trigger.body.amount}}, {{$nodes.fetch.result.price}} y {{$props.asset}} cuando el valor debe provenir de un desencadenador, un nodo anterior o una propiedad de flujo de trabajo reutilizable.