--- title: "Accept chargeback" method: POST path: "/chargebacks/{chargebackId}/accept" tags: ["Chargebacks"] --- # Accept chargeback `POST /chargebacks/{chargebackId}/accept` Accept the chargeback without contesting it ## Path parameters - `chargebackId` string, required ## Headers - `Idempotency-Key` string, required - `X-Instance-ID` string, nullable ## Request body - object - `customerPartyId` string — Connected customer to act on behalf of. - `data` object, required - `attributes` object, required - `version` integer, required ## Response `200` Successful Response - object - `data` object, required - `id` string, required - `type` 'chargeback', required - `attributes` object, required - `amount` integer, required — Disputed amount in the currency's smallest unit. - `currency` string, required — Reported ISO 4217 currency of the disputed amount. - `status` 'needsResponse' | 'expired' | 'accepted' | 'submitted' | 'underReview' | 'won' | 'lost', required — Response and outcome state. Submitted means Natural accepted the response. Under review requires provider acknowledgment. Accepted and expired are not provider-reported losses. - `network` 'visa' | 'mastercard' | 'discover' | 'unknown', required — Card network that reported the case. - `reason` object, required - `category` 'fraud' | 'authorization' | 'processingError' | 'duplicate' | 'notReceived' | 'unacceptableOrCanceled' | 'creditNotProcessed' | 'unknown', required - `networkCode` string, required — Network reason code, interpreted with the network. - `description` string, nullable, required — Readable reason description, or null when unavailable. - `responseDueAt` string, date-time, required — Enforced deadline for accepting or responding to this chargeback. - `internalDueAt` string, date-time, required — Earlier merchant-facing deadline. Respond before this time so Natural can deliver the response before the enforced deadline. - `paymentCreatedAt` string, date-time, nullable, required — When the disputed payment was made, or null when unavailable. - `submittedAt` string, date-time, nullable, required — When Natural accepted and froze the response. This does not establish provider acknowledgment. - `allowedActions` string[], required — Actions still available to the merchant, computed server-side. - `counterUnavailableReason` 'deadlinePassed', nullable, required — Why countering is unavailable, or null when it is available or not applicable. - `evidence` object, required - `responseReason` 'cardholderWithdrew' | 'authorizedPurchase' | 'alreadyRefunded' | 'receivedProduct' | 'other', nullable, required — Why you are contesting the chargeback. - `product` union, required — Product type and fulfillment details. A supplied object replaces the whole product. - object - `type` 'physical', required - `shipTo` object, nullable, required - … - `carrier` string, nullable, required - `trackingNumber` string, nullable, required - `shippedOn` string, date, nullable, required - object - `type` 'digital', required - `accessActivityLog` string, nullable, required - object - `type` 'inPersonService', required - `serviceOn` string, date, nullable, required - object - `type` 'other', required - `productDescription` string, nullable, required — Description of the goods or services sold. - `explanation` string, nullable, required — Explanation of why the chargeback should be reversed. - `deliveryDetails` string, nullable, required — How the goods or services were delivered. - `usageDetails` string, nullable, required — How the cardholder received or used the purchase. - `cardholderName` string, nullable, required — Cardholder name supplied by the customer. - `cardholderEmail` string, nullable, required — Cardholder email supplied by the customer. - `cardholderPhone` string, nullable, required — Cardholder phone supplied by the customer. - `billingAddress` string, nullable, required — Billing address supplied by the customer. - `billingPostalCode` string, nullable, required — Billing postal code supplied by the customer. - `refundPolicyDisclosure` string, nullable, required — How and when the refund policy was disclosed. - `refundDetails` string, nullable, required — Additional explanation of a relevant refund. - `attachments` object[], required - `fileId` string, required — ID of a validated file uploaded for this chargeback. - `purposes` string[], required - `note` string, nullable, required - `file` object, required - `filename` string, nullable, required — Sanitized filename. Null for files uploaded before filename capture was available. - `contentType` 'application/pdf' | 'image/jpeg' | 'image/png', required - `sizeBytes` integer, nullable, required — Original uploaded bytes. Null for historical files whose original size was not recorded. - `pageCount` integer, required — Number of pages this file contributes to the evidence packet. - `createdAt` string, date-time, required — When the file was uploaded and validated. - `evidenceGuidance` object, required - `responseReasons` object[], required - `value` 'cardholderWithdrew' | 'authorizedPurchase' | 'alreadyRefunded' | 'receivedProduct' | 'other', required - `description` string, required - `warning` string, nullable, required - `information` object[], required - `field` 'cardholderName' | 'cardholderEmail' | 'cardholderPhone' | 'billingAddress' | 'billingPostalCode', required - `value` string, nullable, required - `source` 'recorded' | 'provided' | 'missing', required - `missingFields` object[], required - `field` 'responseReason' | 'product' | 'productDescription' | 'explanation', required - `description` string, required - `recommendedDocuments` object[], required - `purpose` 'cardholderCommunications' | 'receipt' | 'authorizationProof' | 'duplicatePaymentReceipt' | 'fulfillmentProof' | 'trackingDocumentation' | 'accessConfirmation' | 'serviceCompletion' | 'productDescription' | 'cancellationPolicy' | 'refundProof' | 'refundPolicy' | 'disputeWithdrawal' | 'supportingDocuments' | 'otherEvidence', required - `description` string, required - `recordedEvidence` object[], required - `code` string, required - `description` string, required - `available` boolean, required - `timeline` object[], required — Provider-visible case events, oldest first. - `eventType` string, required — Public chargeback event name. - `effectiveAt` string, date-time, required — When the event took effect. - `version` integer, required — Version of the case and saved evidence. Use this version when saving, previewing, submitting, or accepting. - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `relationships` object, required - `cardPayment` object, required - `data` object, required — Related resource identifier. - `type` 'cardPayment', required — Resource type. Always `cardPayment`. - `id` string, required - `paymentIntent` object, required - `data` object, required — Related resource identifier. - `type` 'paymentIntent', required — Resource type. Always `paymentIntent`. - `id` string, required - `customerParty` object, required - `data` object, required — Related resource identifier. - `type` 'party', required — Resource type. Always `party`. - `id` string, required ## Other responses - `400` — Validation Error - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found. Returned when the resource does not exist, or when it exists but is not accessible to your account. The two cases are intentionally indistinguishable, so that resource IDs cannot be enumerated by probing. - `409` — Conflict - `422` — Validation Error. The response contains one error object for each invalid request value. - `428` — Precondition Required - `429` — Too Many Requests - `500` — Internal Server Error - `501` — Not Implemented - `502` — Bad Gateway - `503` — Service Unavailable ## Changes - **2026-09-19** `6e52d1bd0054` — 1 info - endpoint added [Change history](https://skmtc.dev/natural/apis/natural-api/changes/chargebacks/:chargebackId/accept/post.md) --- [API](https://skmtc.dev/natural/apis/natural-api.md) · [All operations](https://skmtc.dev/natural/apis/natural-api/llms.txt) · [OpenAPI document](https://skmtc.dev/natural/apis/natural-api/revisions/6e52d1bd0054?raw)