ReferenceApi
Issue refund
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
receiptId*string
reason*string
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/seller/refunds" \ -H "Content-Type: application/json" \ -d '{ "receiptId": "string", "reason": "string" }'{ "refundReference": "string", "receipt": { "receiptId": "string", "mandateId": "string", "intentId": "string", "policyDecisionId": "string", "agent": { "agentId": "string", "name": "string", "environment": "development", "runtimeAttestation": { "property1": null, "property2": null } }, "seller": { "sellerId": "string", "name": "string", "domain": "string", "verified": false, "minimumAssuranceLevel": "softwareApproved" }, "resource": { "resourceId": "string", "sellerId": "string", "method": "GET", "pathTemplate": "string", "description": "string", "pricing": { "type": "fixed", "amount": "string", "asset": "string" }, "configurationSource": "dashboard", "acceptedPaymentChallengeTypes": [ "x402" ], "minimumAssuranceLevel": "softwareApproved", "paymentConfig": {} }, "amount": "string", "asset": "string", "enforcementPath": "offchain", "paymentProtocol": "x402", "paymentChallengeType": "x402", "settlementMode": "offchainAuthorized", "feeQuote": { "feeQuoteId": "string", "feeScheduleId": "string", "buyerOrganizationId": "string", "sellerOrganizationId": "string", "settlementMode": "offchainAuthorized", "enforcementPath": "offchain", "paymentProtocol": "x402", "paymentChallengeType": "x402", "chain": "string", "asset": "string", "grossAmount": "string", "sellerNetAmount": "string", "openPermitFeeAmount": "string", "providerFeeAmount": "0", "networkFeeAmount": "0", "feePayer": "buyer", "feeRecipient": "string", "feeScheduleHash": "string", "expiresAt": "string", "createdAt": "string", "metadata": {} }, "approvalProofHash": "string", "paymentCredentialHash": "string", "settlementReference": "string", "sellerVerificationStatus": "verified", "resourceDeliveryStatus": "pending", "createdAt": "string", "settledAt": "string", "failureReason": "string", "refundReference": "string", "auditHash": "string" }}{ "type": "about:blank", "title": "string", "status": 0, "detail": "string", "instance": "string", "requestId": "string", "code": "string", "category": "buyer_action_required", "actor": "buyer", "retryable": true, "payment": { "chain": "string", "asset": "string", "tokenAddress": "string", "tokenDecimals": 0, "amount": "string", "amountAtomic": "string", "requiredAmount": "string", "requiredAmountAtomic": "string", "balance": "string", "balanceAtomic": "string", "payer": "string", "payTo": "string" }, "nextActions": [ { "type": "fund_wallet", "label": "string", "description": "string", "href": "http://example.com", "address": "string", "chain": "string", "asset": "string", "amount": "string", "metadata": { "property1": null, "property2": null } } ], "debug": { "property1": null, "property2": null }, "errors": [ { "detail": "string", "pointer": "string" } ]}{ "type": "about:blank", "title": "string", "status": 0, "detail": "string", "instance": "string", "requestId": "string", "code": "string", "category": "buyer_action_required", "actor": "buyer", "retryable": true, "payment": { "chain": "string", "asset": "string", "tokenAddress": "string", "tokenDecimals": 0, "amount": "string", "amountAtomic": "string", "requiredAmount": "string", "requiredAmountAtomic": "string", "balance": "string", "balanceAtomic": "string", "payer": "string", "payTo": "string" }, "nextActions": [ { "type": "fund_wallet", "label": "string", "description": "string", "href": "http://example.com", "address": "string", "chain": "string", "asset": "string", "amount": "string", "metadata": { "property1": null, "property2": null } } ], "debug": { "property1": null, "property2": null }}{ "type": "about:blank", "title": "string", "status": 0, "detail": "string", "instance": "string", "requestId": "string", "code": "string", "category": "buyer_action_required", "actor": "buyer", "retryable": true, "payment": { "chain": "string", "asset": "string", "tokenAddress": "string", "tokenDecimals": 0, "amount": "string", "amountAtomic": "string", "requiredAmount": "string", "requiredAmountAtomic": "string", "balance": "string", "balanceAtomic": "string", "payer": "string", "payTo": "string" }, "nextActions": [ { "type": "fund_wallet", "label": "string", "description": "string", "href": "http://example.com", "address": "string", "chain": "string", "asset": "string", "amount": "string", "metadata": { "property1": null, "property2": null } } ], "debug": { "property1": null, "property2": null }}{ "type": "about:blank", "title": "string", "status": 0, "detail": "string", "instance": "string", "requestId": "string", "code": "string", "category": "buyer_action_required", "actor": "buyer", "retryable": true, "payment": { "chain": "string", "asset": "string", "tokenAddress": "string", "tokenDecimals": 0, "amount": "string", "amountAtomic": "string", "requiredAmount": "string", "requiredAmountAtomic": "string", "balance": "string", "balanceAtomic": "string", "payer": "string", "payTo": "string" }, "nextActions": [ { "type": "fund_wallet", "label": "string", "description": "string", "href": "http://example.com", "address": "string", "chain": "string", "asset": "string", "amount": "string", "metadata": { "property1": null, "property2": null } } ], "debug": { "property1": null, "property2": null }}{ "type": "about:blank", "title": "string", "status": 0, "detail": "string", "instance": "string", "requestId": "string", "code": "string", "category": "buyer_action_required", "actor": "buyer", "retryable": true, "payment": { "chain": "string", "asset": "string", "tokenAddress": "string", "tokenDecimals": 0, "amount": "string", "amountAtomic": "string", "requiredAmount": "string", "requiredAmountAtomic": "string", "balance": "string", "balanceAtomic": "string", "payer": "string", "payTo": "string" }, "nextActions": [ { "type": "fund_wallet", "label": "string", "description": "string", "href": "http://example.com", "address": "string", "chain": "string", "asset": "string", "amount": "string", "metadata": { "property1": null, "property2": null } } ], "debug": { "property1": null, "property2": null }}{ "type": "about:blank", "title": "string", "status": 0, "detail": "string", "instance": "string", "requestId": "string", "code": "string", "category": "buyer_action_required", "actor": "buyer", "retryable": true, "payment": { "chain": "string", "asset": "string", "tokenAddress": "string", "tokenDecimals": 0, "amount": "string", "amountAtomic": "string", "requiredAmount": "string", "requiredAmountAtomic": "string", "balance": "string", "balanceAtomic": "string", "payer": "string", "payTo": "string" }, "nextActions": [ { "type": "fund_wallet", "label": "string", "description": "string", "href": "http://example.com", "address": "string", "chain": "string", "asset": "string", "amount": "string", "metadata": { "property1": null, "property2": null } } ], "debug": { "property1": null, "property2": null }}