Documentation
Feedback
Guides

Release Notes
Release Notes
Improved
Marketplace payment data can now be shared with sellers
Today

VTEX marketplaces now forward native paymentData to seller orders, for both VTEX and external sellers. This replaces the previous approach, which relied on custom fields in customApps to propagate payment information, as described in the Orders API: support for NT 2025.001 fields release note.

The new approach uses native VTEX payment fields, ensuring that data such as tid, authId, and nsu is consistently available and reducing custom logic in seller integrations.

What has changed?

Previously, seller orders created from marketplace sales contained placeholder payment information. Now, VTEX sellers receive native paymentData, which includes the actual payment details from the marketplace transaction. The paymentData field is returned by the Get order endpoint.

External sellers integrated through the Fulfillment flow now receive payment information in the Authorize fulfillment endpoint payload.

This feature is also backward compatible. Therefore, integrations that relied on the previous paymentSystemName = "Assumed value by affiliate 00" behavior can now detect marketplace-assumed payments with transactionId = "PAYMENT-FROM-AFFILIATE". This allows gradual migration without breaking existing flows.

What needs to be done?

For early access, contact VTEX Support and request this feature for your account.

Was this helpful?
Yes
No
On this page