As of October 18, 2025, Visa updated its requirements for marketplace transactions involving sellers based in a different country than the marketplace.
We’re updating the Payments API to support these new rules. You can update your integration as follows.
What’s changing?
When you process a payment for a transaction that includes goods or services from a seller based in a different country than your business, you can now include the following information in the Request a payment or payout and Capture a payment requests:
-
processing.purchase_country– The seller's country as an ISO 3166 alpha-2 code -
processing.foreign_retailer_amount– The part of the total transaction amount that belongs to the foreign seller(s)
This ensures that Visa charges the correct fees for the transaction. If you do not provide the foreign-retailer amount and provide only the foreign retail indicator, Visa assumes that the entire transaction amount is from the foreign retailer and charges fees accordingly.
Example 1: Full capture
A customer buys two items – one from a domestic seller for £60 and one from a US seller for £40. The total authorized and captured amount is £100.
{
"amount": 100.00,
"currency": "GBP",
"processing": {
"purchase_country": "US",
"foreign_retailer_amount": 40.00
}
}
In this example, you can set processing.purchase_country to "US" to indicate a foreign component, and processing.foreign_retailer_amount to 40.00 to specify the exact foreign amount in the transaction.
Visa then charges foreign retailer fees on £40 only, not the full £100.
Example 2: Partial capture
For a £100 authorization, you perform two separate captures since the items ship at separate times.
Capture 1: Domestic item
{
"amount": 60.00
// No foreign retailer information needed
}
Capture 2: Foreign item
{
"amount": 4000,
"processing": {
"purchase_country": "US",
"foreign_retailer_amount": 40.00
}
}
In this example, you provide the processing.purchase_country and processing.foreign_retailer_amount only for the partial capture for the foreign retailer’s shipment.