Sign in

v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-202547455.8 KB
Transaction process

Get transaction details

Returns data about a specific transaction made in your store.

⚠️ Do not use the interactions.href route which is part of this endpoint's response. This is an internal-only route not meant to be used by external developers.

Permissions

Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 403 error. These are the applicable resources for this endpoint:

ProductCategoryResource
PCI GatewayPayment-Make PaymentsView Payment Data

There are no applicable predefined roles for this resource list. You must create a custom role and add at least one of the resources above in order to use this endpoint. To learn more about machine authentication at VTEX, see Authentication overview.

❗ To prevent integrations from having excessive permissions, consider the best practices for managing API keys when assigning License Manager roles to integrations.

get/api/pvt/transactions/{transactionId}

Path parameters

transactionIdstring required
Example:A3BDE325F76B4B758B398D900DF06150

Transaction identification.

Headers

Content-Typestring required
Example:application/json

Type of the content being sent.

Acceptstring required
Example:application/json

HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.

Response

OK

idstring required

Transaction identification.

transactionIdstring required

Transaction identification (same value of the id field).

referenceKeystring required

Field used for anti-fraud to identify the transaction.

timeoutStatus0 | 1 | 2 | 3 | 4 required

Field that represents the possible transaction timeout statuses. Possible statuses and meanings: 0 = NotStarted, 1 = CancellingOrFinishing, 2 = CancellingOrFinishingByTimeout, 3 = CancelledOrFinished and 4 = TriesExceeded.

totalRefundsnumber required

Total refunded transaction amount.

statusstring required

Transaction status.

valuenumber required

Transaction value.

receiverUristring nullable required

Receiver URI information.

startDatestring required

Transaction start date.

authorizationTokenstring nullable required

Transaction authorization token.

authorizationDatestring nullable required

Transaction authorization date.

commitmentTokenstring nullable required

Transaction completion token.

commitmentDatestring nullable required

Transaction completion date.

refundingTokenstring nullable required

Transaction refund token.

refundingDatestring nullable required

Transaction refund date.

cancelationTokenstring nullable required

Transaction cancellation token.

cancelationDatestring nullable required

Transaction cancellation date.

shopperInteractionstring required

Transaction origin.

ipAddressstring nullable required

Ip address information.

sessionIdstring nullable required

Session identification.

macIdstring required

Random UUID V4 generated when the Request Capture receives a session that does not contain the macID already set. This value is set to the cookie VtexRCMacIdv7. The cookie has 1 year of expiration.

vtexFingerprintstring nullable required

VTEX fingerprint information.

chargebackstring nullable required

Chargeback information.

whiteSignaturestring nullable required

White signature (anti-fraud list) information.

ownerstring required

Responsible for transaction request.

orderIdstring nullable required

Order identitication.

userAgentstring required

HTTP client used in the transaction.

acceptHeaderstring required

Type of content accepted in the transaction request header.

antifraudTidstring nullable required

Anti-fraud transaction identification.

antifraudResponsestring nullable required

Anti-fraud response information.

antifraudReferencestring nullable required

Anti-fraud reference information.

antifraudAffiliationIdstring nullable required

Anti-fraud affiliation identification.

channelstring required

Store where the transaction was initiated.

salesChannelstring required

Sales channel information.

urnstring nullable required

URN information.

softDescriptorstring nullable required

Custom field for a transaction that can be displayed on the customer's invoice.

markedForRecurrenceboolean required

Indicates whether the payment transaction should be recurring.