---
title: "Changes to Create a credit card refund"
method: POST
path: "/quickbooks-desktop/credit-card-refunds"
---

# Changes to Create a credit card refund

`POST /quickbooks-desktop/credit-card-refunds`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 60 revisions.

- **2026-10-19** `1396ed78f0e1`: 14 warning
- **2026-08-21** `8ee3502091a4`: 1 warning
- **2026-07-02** `daabb801a173`: 1 warning
- **2026-05-02** `1de07095c4b7`: 5 warning
- **2026-05-02** `0adc2851bb7f`: 1 warning
- **2026-04-20** `10d4e9ebd1df`: 24 breaking, 8 info
- **2026-04-20** `8e0b7df2044d`: 22 breaking, 29 info
- **2026-04-20** `5f832f695675`: 26 breaking, 9 info

## Changes

- **2026-10-19** `1396ed78f0e1`: 14 warning
  - the `address/country` request property's maxLength was set to `31`
  - the `address/note` request property's maxLength was set to `41`
  - the `creditCardTransaction/request/address` request property's maxLength was set to `41`
  - the `creditCardTransaction/request/commercialCardCode` request property's maxLength was set to `24`
  - the `creditCardTransaction/request/name` request property's maxLength was set to `41`
  - the `creditCardTransaction/request/number` request property's maxLength was set to `25`
  - the `creditCardTransaction/request/postalCode` request property's maxLength was set to `18`
  - the `creditCardTransaction/response/authorizationCode` request property's maxLength was set to `12`
  - the `creditCardTransaction/response/clientTransactionId` request property's maxLength was set to `16`
  - the `creditCardTransaction/response/creditCardTransactionId` request property's maxLength was set to `24`
  - the `creditCardTransaction/response/merchantAccountNumber` request property's maxLength was set to `32`
  - the `creditCardTransaction/response/reconBatchId` request property's maxLength was set to `84`
  - the `creditCardTransaction/response/statusMessage` request property's maxLength was set to `60`
  - the `memo` request property's maxLength was set to `4095`
- **2026-08-21** `8ee3502091a4`: 1 warning
  - added the new `transfer_inventory` enum value to the `refundAppliedToTransactions/items/transactionType` response property for the response status `200`
- **2026-07-02** `daabb801a173`: 1 warning
  - added the new `unknown` enum value to the `refundAppliedToTransactions/items/transactionType` response property for the response status `200`
- **2026-05-02** `1de07095c4b7`: 5 warning
  - the `customerId` request property's maxLength was set to `36`
  - the `paymentMethodId` request property's maxLength was set to `36`
  - the `receivablesAccountId` request property's maxLength was set to `36`
  - the `refundAppliedToTransactions/items/transactionId` request property's maxLength was set to `36`
  - the `refundFromAccountId` request property's maxLength was set to `36`
- **2026-05-02** `0adc2851bb7f`: 1 warning
  - the `refNumber` request property's maxLength was set to `11`
- **2026-04-20** `10d4e9ebd1df`: 24 breaking, 8 info
  - response property `customer/fullName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `customer/id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `exchangeRate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `externalId` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `memo` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/creditRemaining` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/creditRemainingInHomeCurrency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/refNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/refundAmountInHomeCurrency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/transactionDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `totalAmountInHomeCurrency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `currency` response's property type changed from `object, null` to no type for status `200`
  - the `paymentMethod` response's property type changed from `object, null` to no type for status `200`
  - the `receivablesAccount` response's property type changed from `object, null` to no type for status `200`
  - the `refundFromAccount` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `currency/fullName` from the response with the `200` status
  - removed the required property `currency/id` from the response with the `200` status
  - removed the required property `paymentMethod/fullName` from the response with the `200` status
  - removed the required property `paymentMethod/id` from the response with the `200` status
  - removed the required property `receivablesAccount/fullName` from the response with the `200` status
  - removed the required property `receivablesAccount/id` from the response with the `200` status
  - removed the required property `refundFromAccount/fullName` from the response with the `200` status
  - removed the required property `refundFromAccount/id` from the response with the `200` status
  - added `#/components/schemas/qbd_address, subschema #2` to the `address` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/qbd_credit_card_transaction, subschema #2` to the `creditCardTransaction` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `currency` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `paymentMethod` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `receivablesAccount` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `refundFromAccount` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/qbd_address, subschema #2` from the `address` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/qbd_credit_card_transaction, subschema #2` from the `creditCardTransaction` response property `oneOf` list for the response status `200`
- **2026-04-20** `8e0b7df2044d`: 22 breaking, 29 info
  - the response property `currency` became nullable for the status `200`
  - the response property `customer/fullName` became nullable for the status `200`
  - the response property `customer/id` became nullable for the status `200`
  - the response property `exchangeRate` became nullable for the status `200`
  - the response property `externalId` became nullable for the status `200`
  - the response property `memo` became nullable for the status `200`
  - the response property `paymentMethod` became nullable for the status `200`
  - the response property `receivablesAccount` became nullable for the status `200`
  - the response property `refNumber` became nullable for the status `200`
  - the response property `refundAppliedToTransactions/items/creditRemaining` became nullable for the status `200`
  - the response property `refundAppliedToTransactions/items/creditRemainingInHomeCurrency` became nullable for the status `200`
  - the response property `refundAppliedToTransactions/items/refNumber` became nullable for the status `200`
  - the response property `refundAppliedToTransactions/items/refundAmountInHomeCurrency` became nullable for the status `200`
  - the response property `refundAppliedToTransactions/items/transactionDate` became nullable for the status `200`
  - the response property `refundFromAccount` became nullable for the status `200`
  - the response property `totalAmountInHomeCurrency` became nullable for the status `200`
  - added `#/components/schemas/qbd_address, subschema #2` to the `address` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/qbd_credit_card_transaction, subschema #2` to the `creditCardTransaction` response property `oneOf` list for the response status `200`
  - the `currency` response's property type changed from no type to `object, null` for status `200`
  - the `paymentMethod` response's property type changed from no type to `object, null` for status `200`
  - the `receivablesAccount` response's property type changed from no type to `object, null` for status `200`
  - the `refundFromAccount` response's property type changed from no type to `object, null` for status `200`
  - removed the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` from the request property `transactionDate`
  - removed the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` from the request property `externalId`
  - removed `#/components/schemas/qbd_address, subschema #2` from the `address` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/qbd_credit_card_transaction, subschema #2` from the `creditCardTransaction` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `currency` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `paymentMethod` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `receivablesAccount` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `refundFromAccount` response property `anyOf` list for the response status `200`
  - response property `customer/fullName` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `customer/id` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `exchangeRate` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `externalId` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `memo` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `refNumber` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/creditRemaining` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/creditRemainingInHomeCurrency` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/refNumber` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/refundAmountInHomeCurrency` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - …11 more
- **2026-04-20** `5f832f695675`: 26 breaking, 9 info
  - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `transactionDate`
  - added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `externalId`
  - response property `customer/fullName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `customer/id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `exchangeRate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `externalId` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `memo` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/creditRemaining` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/creditRemainingInHomeCurrency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/refNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/refundAmountInHomeCurrency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `refundAppliedToTransactions/items/transactionDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `totalAmountInHomeCurrency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `currency` response's property type changed from `object, null` to no type for status `200`
  - the `paymentMethod` response's property type changed from `object, null` to no type for status `200`
  - the `receivablesAccount` response's property type changed from `object, null` to no type for status `200`
  - the `refundFromAccount` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `currency/fullName` from the response with the `200` status
  - removed the required property `currency/id` from the response with the `200` status
  - removed the required property `paymentMethod/fullName` from the response with the `200` status
  - removed the required property `paymentMethod/id` from the response with the `200` status
  - removed the required property `receivablesAccount/fullName` from the response with the `200` status
  - removed the required property `receivablesAccount/id` from the response with the `200` status
  - removed the required property `refundFromAccount/fullName` from the response with the `200` status
  - removed the required property `refundFromAccount/id` from the response with the `200` status
  - added `#/components/schemas/qbd_address, subschema #2` to the `address` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/qbd_credit_card_transaction, subschema #2` to the `creditCardTransaction` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `currency` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `paymentMethod` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `receivablesAccount` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `refundFromAccount` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/qbd_address, subschema #2` from the `address` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/qbd_credit_card_transaction, subschema #2` from the `creditCardTransaction` response property `oneOf` list for the response status `200`
  - the `transactionDate` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` was added for the status `200`

---

[Operation](https://skmtc.dev/conductor-is/apis/conductor-api/docs/quickbooks-desktop/credit-card-refunds/post.md) - [API](https://skmtc.dev/conductor-is/apis/conductor-api.md) - [Page](https://skmtc.dev/conductor-is/apis/conductor-api/changes/quickbooks-desktop/credit-card-refunds/post)
