> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# API - November 3, 2026

## Added

### `MarketplaceData` object for Visa Marketplace reporting

Card, Apple Pay, and Google Pay payment flows now accept an optional `MarketplaceData` parameter in the request body.

This object parameter carries declarative information used for Visa Marketplace reporting:

* `ForeignRetailerIndicator` – A boolean indicating that the Seller to which the pay-in is transferred is foreign, meaning the Seller is resident in a different country or region from the platform.

  For example:

  * EU-domiciled platform, EU-domiciled Seller: `false`
  * EU-domiciled platform, US-domiciled Seller: `true`
  * EU-domiciled platform, UK-domiciled Seller: `true`
  * UK-domiciled platform, UK-domiciled Seller: `false`
  * UK-domiciled platform, EU-domiciled Seller: `true`
  * UK-domiciled platform, US-domiciled Seller: `true`
* `ForeignRetailerAmount` – If `ForeignRetailerIndicator` is `true`, then this property contains the transaction `Amount` related to a foreign Seller.

This object is not returned in the API response.

> **Note**
>
> **Note – Mangopay will advise if Visa Marketplace integration is required**
>
> The `MarketplaceData` is technically optional and your platform should not take any action unless and until requested to do so by Mangopay.
>
> Mangopay will be in contact with platforms that need to integrate this additional declaration on a case-by-case basis.

#### See list of impacted endpoints

* [POST Create a Direct Card PayIn](/api-reference/direct-card-payins/create-direct-card-payin)
* [POST Create a Web Card PayIn](/api-reference/web-card-payins/create-web-card-payin)
* [POST Create a Recurring Card PayIn](/api-reference/recurring-card-payins/create-recurring-card-payin)
* [POST Create a Preauthorization](/api-reference/preauthorizations/create-preauthorization)
* [POST Create a Card Deposit Preauthorization](/api-reference/deposit-preauthorizations/create-card-deposit-preauthorization)
* [POST Create a Card Extended Preauthorization](/api-reference/extended-preauthorizations/create-card-extended-preauthorization)
* [POST Create an Apple Pay PayIn](/api-reference/apple-pay/create-apple-pay-payin)
* [POST Create a Recurring Apple Pay PayIn](/api-reference/apple-pay/create-recurring-apple-pay-payin)
* [POST Create a Google Pay PayIn](/api-reference/google-pay/create-google-pay-payin)
* [POST Create a Recurring Google Pay PayIn](/api-reference/google-pay/create-recurring-google-pay-payin)