Refund Object


The refund object. A refund object is the record of an attempt to return charged funds.

Properties
idstringRead-onlyimmutableformat GUID

Refund ID.


revisionstringRead-onlyformat int64

Revision number, which increments by 1 each time the refund is updated.

Ignored when creating a refund.


createdDatestringRead-onlyimmutableformat date-time

Date and time the refund was created in ISO-8601 format. For example, "2024-01-30T13:30:00".


updatedDatestringRead-onlyformat date-time

Date and time the refund was last updated in ISO-8601 format. For example, "2024-01-30T13:30:00".


extendedFieldsExtendedFields

Custom field data for the refund object.

Extended fields must be configured in the app dashboard before they can be accessed with API calls.


chargeIdstringimmutableformat GUID

ID of the charge to refund.


currencyCodestringimmutableformat CURRENCY

Refund currency. Should be the same as the charge currency.


amountstringimmutabledecimalValue {"gt":"0","maxScale":8}

Amount being returned to the buyer in the refund currency's main units (such as dollars or euros). For example, "12.95".


returnedApplicationFeestringRead-onlyimmutabledecimalValue {"gt":"0","maxScale":8}

Application fee returned to the merchant from Wix in the refund currency's main units (such as dollars or euros). For example, "12.95".

Only included if an application fee was returned.


returnedProcessingFeestringRead-onlyimmutabledecimalValue {"gt":"0","maxScale":8}

Processing fee returned to the merchant from the payment service provider in the refund currency's main units (such as dollars or euros). For example, "12.95".

This field is empty when the processing fee is unknown.


fullbooleanRead-onlyimmutable

Whether the refund is for the entire amount of the charge.


statusstringRead-only

Status of the refund.

Learn more about the refund lifecycle.


providerRefundIdstringRead-onlyimmutableminLength 1maxLength 100

Payment service provider's ID for the refund.


reasonstringminLength 1maxLength 1000

Reason this refund was issued.


statusInfoStatusInfoRead-only

Details about the refund status. Used to provide additional information about why a refund was given its status.


acquirerReferenceNumberstringRead-onlyimmutableminLength 1maxLength 30

Unique number assigned to a refund. This number is shared across all parties involved in processing the refund. It allows the merchant to track the refund with their bank.


notestringimmutableminLength 1maxLength 200

Note providing additional information about this refund.

Did this help?