To enhance payment data security, all payment information will now be received exclusively through a new dedicated route on VTEX.
What has changed?
Previously, merchants could use routes containing the myvtex.com, vtexcommercestable.com.br, vtexpayments.com.br domains or personalized client hosts (example: {accountname}.com) to forward payment information to VTEX.
Example:
https://{accountName}.vtexpayments.com.br/api/pvt/transactions/{transactionId}/payments
After January 31, 2026, it will be mandatory to send all payment information to VTEX using the vtexvault.com domain, where the account name is sent as a query parameter:
https://api.vtexvault.com/api/payments/transactions/{transactionId}/payments?an={accountName}
If you send payment data to any route other than
https://api.vtexvault.com/api/payments/transactions/{transactionId}/payments?an={accountName}, the system will block the request, return a404 - Not Foundstatus code, and interrupt the purchase order flow.
We renamed the endpoint 2.1 Send payments information public to "Send payments information" and updated its path route. We will also deprecate the 2.2 Send payments with saved credit card endpoint.
What needs to be done?
Check if any of the payment integrations in your account are using the deprecated routes and make the following adjustment before January 31, 2026, if necessary:
| Method | From |
|---|---|
| POST |
|
| POST |
|
| POST |
|
| POST |
|
| Method | To |
|---|---|
| POST | https://api.vtexvault.com/api/payments/transactions/{transactionId}/payments?an={accountName} |
When the new route successfully sends payment information, it returns an empty body with the status code 201 - Created. Unlike the two routes below, it doesn’t return payment details. If your current implementation relies on the returned information, you must call the Get payment details route after migration to retrieve it:
- GET:
https://{accountName}.vtexcommercestable.com.br/api/pvt/transactions/{transactionId}/payments - GET:
https://{accountName}.vtexcommercestable.com.br/api/payments/pvt/transactions/{transactionId}/payments