{"method":"POST","path":"https://api.revcent.com/v2/chargebacks","summary":"Create A Chargeback","description":"Create a chargeback. A chargeback must be associated with a previous credit card transaction. To associate a previous transaction use the transaction_id or gateway_transaction_id property within the request body for the transaction associated. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/CreateChargeback.md for an in-depth overview of this operation.","operationId":"CreateChargeback","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"transaction_id":{"type":"string","description":"The RevCent transaction ID for the chargeback related transaction. If not present, you must provide the gateway_transaction_id property.","minLength":20,"maxLength":20},"gateway_transaction_id":{"type":"string","description":"The gateway transaction ID for the chargeback related transaction. Only provide if the transaction_id property is not present."},"amount":{"description":"The chargeback amount.","type":"number","format":"float"},"arn":{"type":"string","description":"The acquirer reference number, if applicable."},"case_number":{"type":"string","description":"The case number, if applicable."},"reason_code":{"type":"string","description":"The reason code, if applicable."},"third_party_integration_id":{"type":"string","description":"A 20 character third party integration ID.","minLength":20,"maxLength":20},"third_party_chargeback_id":{"type":"string","description":"The third party integration chargeback ID, if being created by a third party chargeback management company."},"third_party_order_id":{"type":"string","description":"The third party integration order ID, if being created by a third party chargeback management company."},"chargeback_date":{"description":"The date when the chargeback was created by the issuer and or customer in ISO8601 format.","type":"string","format":"date-time"},"received_date":{"description":"The date when the chargeback was received by the merchant in ISO8601 format.","type":"string","format":"date-time"},"void_transaction":{"type":"boolean","description":"You can choose to void the transaction, which will automatically issue a full refund. Default is false. Note: This cannot be undone."},"representment":{"additionalProperties":false,"description":"The representment object contains details regarding any attempt to fight the chargeback.","properties":{"initiated":{"type":"boolean","description":"Whether a representment has been initiated. Read-only once set."},"initiated_date":{"description":"The date the representment was initiated. Read-only once set.","type":"string","format":"date-time"},"completed":{"type":"boolean","description":"Whether the representment has completed, with an outcome. The initiated property must be set, or have been previously set, to true. Read-only once set."},"completed_date":{"type":"string","description":"The date the representment was completed, with an outcome. Read-only once set.","format":"date-time"},"outcome":{"type":"string","description":"The final outcome of the chargeback representment. The initiated and completed properties must be set, or have been previously set, to true.","enum":["pending","won","lost"]}},"type":"object"},"metadata":{"items":{"additionalProperties":false,"properties":{"name":{"type":"string","description":"A name paired to the value for the metadata object. Limited to 100 characters in length.","minLength":1,"maxLength":100},"value":{"type":"string","description":"A value paired to the name for the metadata object. Limited to 255 characters in length.","minLength":1,"maxLength":255}},"type":"object","required":["name","value"]},"type":"array","description":"An array of metadata objects, each metadata object being a name and value pair."}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"API call response code.","type":"integer","format":"int32","enum":[1]},"chargeback_id":{"type":"string","description":"A 20 character chargeback ID.","minLength":20,"maxLength":20},"result":{"type":"string"}},"type":"object","additionalProperties":false}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}