> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # Resource: Transactions # Type: Transaction Object # Link: https://dev.wix.com/docs/api-reference/business-management/payments/wix-payments-provider/transactions/transaction-object.md ## Schema: ```json Type: Transaction Object | type: Transaction - name: id | type: string | description: Wix Payments transaction ID. - name: currency | type: string | description: Payment currency according to ISO 4217. For example: USD, EUR, GBP. - name: capturableAmount | type: number | description: Amount that can be captured or voided in minor units. Usually matches authorization amount when the transaction has been authorized but not captured. - name: refundableAmount | type: number | description: Amount that can be refunded in minor units. Usually matches capture amount when the transaction has been captured but not refunded or charged back. - name: externalInvoiceId | type: string | description: Invoice ID provided by the external entity that initiated the transaction. - name: value | type: string | description: - name: externalOrderId | type: string | description: Order ID provided by the external entity that initiated the transaction. - name: externalTransactionId | type: string | description: Transaction ID provided by external entity. - name: providerTransactionId | type: string | description: Transaction ID provided by the payment provider. - name: metadata | type: object | description: Metadata stored when the transaction is created. - name: authorization | type: Authorization | description: Transaction authorization information. - name: amount | type: number | description: Authorization amount in minor units, for example, cents. - name: status | type: string | description: Authorization status. enum: UNDEFINED, PROCESSING, DECLINED, SUCCEEDED, CANCELED, NEEDS_ACTION, PENDING - name: statusReason | type: StatusReason | description: Detailed reason for current authorization status when available. Value is empty for approved transactions. - name: code | type: string | description: Reason code. - name: message | type: string | description: Free-text description. - name: providerResponse | type: string | description: Original response code from the issuer or card scheme. - name: networkReference | type: NetworkReference | description: Transaction reference provided by a payment network. - name: networkTransactionId | type: string | description: Transaction ID assigned by a card scheme (Trace ID for Mastercard or Transaction ID for Visa). - name: dsTransactionId | type: string | description: Transaction ID assigned by 3D Secure 2 directory server. - name: transactionLinkId | type: string | description: Transaction Link Identifier assigned by Mastercard. - name: authCode | type: string | description: Authorization code sent by a card issuer. - name: captures | type: Array | description: Captures issued for the transaction. - name: id | type: string | description: Capture ID. - name: amount | type: number | description: Capture amount in minor units, for example, cents. - name: status | type: string | description: Capture status. enum: UNDEFINED, PENDING, FAILED, SUCCEEDED, REVERSED - name: statusReason | type: StatusReason | description: Detailed reason for current capture status. Value is empty for approved transactions. - name: externalCaptureId | type: string | description: Capture ID provided by the external entity that initiated the capture. - name: providerCaptureId | type: string | description: Capture ID provided by the payment provider that initiated the capture. - name: metadata | type: object | description: Metadata stored when the capture was created. - name: refunds | type: Array | description: Refunds issued for the transaction. - name: id | type: string | description: Refund ID. - name: amount | type: number | description: Refund amount in minor units, e.g. cents. - name: reason | type: string | description: Reason for refund. enum: OTHER, FRAUD, COMPLIANCE, DUPLICATE_PAYMENT, ABANDONED_PAYMENT, MERCHANT_REQUEST, BUYER_REQUEST - name: status | type: string | description: Refund status. enum: UNDEFINED, PENDING, FAILED, SUCCEEDED, REVERSED, CANCELED - name: statusReason | type: StatusReason | description: Detailed reason for current refund status. Value is empty for approved transactions. - name: externalRefundId | type: string | description: Refund ID provided by the external entity that initiated the refund. - name: providerRefundId | type: string | description: Refund ID provided by the payment provider that initiated the refund. - name: metadata | type: object | description: Metadata stored when the refund was created. - name: disputes | type: Array | description: Disputes initiated for the transaction. - name: id | type: string | description: Dispute ID. - name: amount | type: string | description: Dispute amount in minor units, for example, cents. - name: reason | type: string | description: Reason for dispute. enum: OTHER, FRAUD_CARD_PRESENT, FRAUD_CARD_ABSENT, DUPLICATE_PROCESSING, SERVICES_NOT_PROVIDED, CANCELED_RECURRING, NOT_AS_DESCRIBED, COUNTERFEIT, MISREPRESENTATION, CANCELED - name: networkReasonCode | type: string | description: Reason code for dispute from card network if present - name: status | type: string | description: Dispute status. enum: UNDEFINED, RFI_OPEN, RFI_UNDER_REVIEW, RFI_CLOSED, CHARGEBACK_OPEN, CHARGEBACK_UNDER_REVIEW, WON, LOST, PRE_ARBITRATION_UNDER_REVIEW, PRE_ARBITRATION_WON, PRE_ARBITRATION_LOST - name: statusReason | type: StatusReason | description: Detailed reason for current refund status. - name: providerDisputeId | type: string | description: Dispute ID provided by the payment provider that initiated the dispute. - name: rfi | type: RfiTiming | description: Date/time frames for RFI (request for information) flow. - name: openingDate | type: string | description: RFI (request for information) received date. - name: evidenceSubmissionDeadlineDate | type: string | description: Evidence submission deadline. - name: daysToResolution | type: number | description: Number of days between evidence submission and final decision for a dispute. - name: evidenceSubmissionDate | type: string | description: Date for evidence submission. - name: resolutionDate | type: string | description: Date that RFI resolution occurred (final dispute status). - name: chargeback | type: ChargebackTiming | description: Date/time frames for chargeback flow. - name: openingDate | type: string | description: Chargeback received date. - name: evidenceSubmissionDeadlineDate | type: string | description: Evidence submission deadline. - name: daysToResolution | type: number | description: Number of days between evidence submission and final decision for a dispute. - name: evidenceSubmissionDate | type: string | description: Date for evidence submission. - name: resolutionDate | type: string | description: Date a dispute was lost (accepted, expired, etc.) or date of dispute final resolution. - name: preArbitration | type: PreArbitrationTiming | description: Date/time frames for pre-arbitration flow. - name: openingDate | type: string | description: Pre arbitration (request for information) received date. - name: resolutionDate | type: string | description: Date that Pre arbitration resolution occurred (final dispute status). - name: voids | type: Array | description: Voids issued for the transaction. - name: id | type: string | description: Void ID. - name: reason | type: string | description: Void reason. - name: status | type: string | description: Void status. enum: UNDEFINED, PENDING, FAILED, SUCCEEDED - name: statusReason | type: StatusReason | description: Detailed reason for current void status. - name: externalVoidId | type: string | description: Void ID provided by the external entity. - name: providerVoidId | type: string | description: Void ID provided by the payment provider. - name: metadata | type: object | description: Metadata stored when the void was initiated. - name: accountId | type: string | description: Wix Payments account ID. - name: accountProfileId | type: string | description: Wix Payments account profile ID. - name: paymentMethod | type: PaymentMethod | description: Payment method used for payment. - name: type | type: string | description: Do not use this field. - name: typeId | type: string | description: Type ID of payment method used. Supported values are `creditCard`, `cardReader`, `ach`, `applePay`, `boleto`, `giropay`, `iDeal`, `payPal`, `pix`, `sepa`, `sofort`, 'tapToPay', `razorpay`. - name: displayName | type: string | description: Payment method display name. Can be masked card number or IBAN, wallet owner email address, etc. - name: notificationOfFraud | type: NotificationOfFraud | description: Visa TC40 and Mastercard SAFE notifications. - name: reason | type: string | description: Fraud notification reason. enum: CARD_NEVER_RECEIVED, FRAUDULENT_CARD_APPLICATION, MADE_WITH_COUNTERFEIT_CARD, MADE_WITH_LOST_CARD, MADE_WITH_STOLEN_CARD, MISCELLANEOUS, UNAUTHORIZED_USE_OF_CARD, FRAUD, ACCOUNT_TAKEOVER_FRAUD, CARD_NOT_PRESENT_FRAUD, MULTIPLE_IMPRINT_FRAUD, BUST_OUT_COLLUSIVE_MERCHANT, FRAUDULENT_USE_OF_ACCOUNT_NUMBER, INCORRECT_PROCESSING, MERCHANT_MISREPRESENTATION, ACQUIRER_REPORTED_COUNTERFEIT - name: receiveDate | type: string | description: Notification issue date. - name: seconds | type: string | description: - name: nanos | type: number | description: - name: billingAddress | type: AddressDetails | description: Billing address. - name: address | type: Address | description: Physical address. - name: country | type: string | description: Country code. - name: subdivision | type: string | description: Subdivision shorthand. Usually, a short code (2 or 3 letters) that represents a state, region, prefecture, or province. e.g. NY - name: city | type: string | description: City name. - name: postalCode | type: string | description: Zip/postal code. - name: addressLine2 | type: string | description: Free text providing more detailed address info. Usually contains Apt, Suite, and Floor. - name: contactDetails | type: FullAddressContactDetails | description: Contact details. - name: firstName | type: string | description: Contact's first name. - name: lastName | type: string | description: Contact's last name. - name: phone | type: string | description: Contact's phone number. - name: company | type: string | description: Contact's company name. - name: email | type: string | description: Email associated with the address. - name: vatId | type: VatId | description: Tax info. Currently usable only in Brazil. - name: shippingAddress | type: AddressDetails | description: Shipping address. ```