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

# Submit data for a PayPal PayIn

POST https://api.sandbox.mangopay.com/v2.01/{ClientId}/payins/payment-methods/paypal/data-collection
Content-Type: application/json

Provide transaction data to PayPal prior to initiating a pay-in ([read guide](/guides/payment-methods/paypal#submit-pre-transaction-risk-data)).

**Note – Data to submit depends on industry**

The request body parameters described below are required for all marketplace businesses.

Additional data points are required for platforms operating in the following industries:

* Events and ticketing
* Online travel agents:
  * Car rentals
  * Hotels
  * Transportation
  * Travel packages
* Retail and groceries
* Cruise lines
* Buy online, pick up in store (BOPIS)
* Crypto

Before integrating this endpoint, platforms operating in the verticals above need to contact Mangopay via the Dashboard.

The `DataCollectionId` returned in the response must be sent on the associated pay-in call for both one-time and recurring payments:

* [POST Create a PayPal PayIn](/api-reference/paypal/create-paypal-payin)
* [POST Create a Recurring PayPal PayIn](/api-reference/paypal/create-recurring-paypal-payin) with the CIT payload
* [POST Create a Recurring PayPal PayIn](/api-reference/paypal/create-recurring-paypal-payin) with the MIT payload

Each PayPal pay-in or preauth requires a new `DataCollectionId`. The property is not returned on the pay-in endpoints.

Reference: https://docs.mangopay.com/api-reference/paypal/submit-data-paypal-payin

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token. If your platform is using a [proxy](/guides/sca/proxy-management) to take SCA-triggering action on behalf of users, you also need to integrate [mTLS authentication](/guides/sca/platform) and use the `api-mtls` base URL.

## Servers

- `https://api.sandbox.mangopay.com` (Sandbox, default)
- `https://api.mangopay.com` (Production)
- `https://api-mtls.sandbox.mangopay.com` (mTLS Sandbox)
- `https://api-mtls.mangopay.com` (mTLS Production)

## Request

### Path parameters

- `ClientId` (string, required) — Platform's API account identifier, associated with the API key.

### Body (application/json)

This endpoint expects a SubmitDataForAPayPalPayInRequest.

- `sender_account_id` (string, optional) — Format: Alphanumeric; example: `A12345N343` Unique identifier of the sender/buyer account on the marketplace platform.
- `sender_first_name` (string, optional) — Format: Alphanumeric; example: `Jane` First name registered with the sender/buyer's marketplace account.
- `sender_last_name` (string, optional) — Format: Alphanumeric; example: `Doe` Last name registered with the sender/buyer's marketplace account.
- `sender_email` (string, optional) — Format: E.123 – Email Address; example: `john@example.com` Email address registered with the sender/buyer's marketplace account.
- `sender_phone` (string, optional) — Format: E.123 - Telephone Number (national notation); example `(042) 1123 4567` Phone number (national notation) registered with the sender/buyer's marketplace account.
- `sender_country_code` (string, optional) — Format: ISO Alpha-2 Country Code; example: `FR` Country code registered with the sender/buyer's marketplace account.
- `sender_create_date` (string, optional) — Format: ISO 8601 date format; example: `2012-12-09T19:14:55.277-0:00` Date of creation of the sender/buyer's account on the marketplace platform.
- `sender_signup_ip` (string, optional) — Format: IP (IPv4 / IPv6); example: `10.220.90.20` IP address that the sender/buyer used to sign up on the marketplace platform.
- `sender_popularity_score` (string, optional) — Possible values: `high`, `medium`, `low`; example: `high` Risk-based scoring on the sender/buyer by the marketplace platform (e.g., social score, identity score, risk score). This score is likely unique for each platform based on marketplace platform's risk platform capabilities.
- `receiver_account_id` (string, optional) — Format: Alphanumeric; example: `A12345N343` Unique identifier of the seller/recipient's account on the marketplace platform.
- `receiver_create_date` (string, optional) — Format: ISO 8601 date format; example: `2012-12-09T19:14:55.277-0:00` Date of creation of the seller/recipient's account on the marketplace platform.
- `receiver_email` (string, optional) — Format: E.123 – Email Address; example: `john@example.com` Seller/recipient's registered email on the marketplace platform.
- `receiver_address_country_code` (string, optional) — Format: ISO Alpha-2 Country Code; example: `FR` Seller/recipient's country code registered on the marketplace platform.
- `business_name` (string, optional) — Format: Alphanumeric; example: `Acme Corp.` Business name used by the seller/recipient to register on the marketplace platform.
- `recipient_popularity_score` (string, optional) — Possible values: `high`, `medium`, `low`; example: `high` Risk-based scoring on the seller/recipient by the marketplace platform (e.g., social score, identity score, risk score). This score is likely unique for each platform based on marketplace platform's risk platform capabilities.
- `first_interaction_date` (string, optional) — Format: ISO 8601 date format; example: `2012-12-09T 19:14:55.277-0:00` Date of the first interaction between the sender and receiver on the marketplace platform. Definition of 'interaction' is to be defined by the marketplace platform. Examples are: first transaction attempt between sender and receiver, add friend date between sender and receiver, etc.
- `txn_count_total` (string, optional) — Format: Integer; example: `34` Total number of transactions the sender/buyer has had to date on the marketplace platform (through PayPal or otherwise).
- `vertical` (string, optional) — Format: Alphanumeric; examples: `household goods`, `shoes`, `clothing`, `tickets`, etc. Transaction level vertical flag for the seller/receiver's transactions that are in several verticals.
- `transaction_is_tangible` (string, optional) — Possible values: `0`, `1`; example: `0` The seller/receiver's transaction is for tangible rather than digital goods. If tangible, value = 1. If intangible, value = 0.

## Response

### 200

Success

- `DataCollectionId` (string, optional) — The unique identifier of the Data Collection object. A new `DataCollectionId` is needed for each call to: - [POST Create a PayPal PayIn](/api-reference/paypal/create-paypal-payin) - [POST Create a Recurring PayPal PayIn](/api-reference/paypal/create-recurring-paypal-payin), with both the CIT and MIT payloads - [POST Create a PayPal Extended Preauthorization](/api-reference/extended-preauthorizations/create-paypal-extended-preauthorization)

## Errors

### 400 Bad Request Error

Bad Request

- `Message` (string, optional) — Description of the error.
- `Type` (string, optional) — The category of the error.
- `Id` (string, optional) — Unique identifier of the error instance, useful when contacting Mangopay for support.
- `Date` (double, optional) — Unix timestamp (UTC) of the date and time the error was triggered.
- `errors` (map from string to string, optional, nullable) — Object containing one or more field-level errors.

## Examples

**Request**

```json
{
  "body": {
    "business_name": "Jane Ltd,",
    "first_interaction_date": "2012-12-09T19:14:55.277-0:00,",
    "receiver_account_id": "A12345N344,",
    "receiver_address_country_code": "FR,",
    "receiver_create_date": "2012-12-09T19:14:55.277-0:00,",
    "receiver_email": "jane@sample.com,",
    "recipient_popularity_score": "high,",
    "sender_account_id": "A12345N343,",
    "sender_country_code": "FR,",
    "sender_create_date": "2012-12-09T19:14:55.277-0:00,",
    "sender_email": "jane.doe@sample.com,",
    "sender_first_name": "Jane,",
    "sender_last_name": "Doe,",
    "sender_phone": "(0033) 678123456,",
    "sender_popularity_score": "high,",
    "sender_signup_ip": "10.220.90.20,",
    "transaction_is_tangible": 0,
    "txn_count_total": "34,",
    "vertical": "Household goods,"
  }
}
```

**Response**

```json
{
  "DataCollectionId": "77b23645-dba3-4948-a5ba-32a134a3148d"
}
```