PayPal

Submit data for a PayPal PayIn

Changed on

Provide transaction data to PayPal prior to initiating a pay-in (read guide).

<Note icon="fa-regular fa-circle-info"> **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 <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>. </Note>

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
  • POST Create a Recurring PayPal PayIn with the CIT payload
  • POST Create a 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.

post/v2.01/{ClientId}/payins/payment-methods/paypal/data-collection

Request

  • Base URL
    https://api.sandbox.mangopay.com
  • URL
    https://api.sandbox.mangopay.com/v2.01/{ClientId}/payins/payment-methods/paypal/data-collection
  • Auth
    HTTP bearer

Path parameters

ClientIdstring required

Platform's API account identifier, associated with the API key.

Request body

sender_account_idstring

Format: Alphanumeric; example: A12345N343

Unique identifier of the sender/buyer account on the marketplace platform.

sender_first_namestring

Format: Alphanumeric; example: Jane

First name registered with the sender/buyer's marketplace account.

sender_last_namestring

Format: Alphanumeric; example: Doe

Last name registered with the sender/buyer's marketplace account.

sender_emailstring

Format: E.123 – Email Address; example: john@example.com

Email address registered with the sender/buyer's marketplace account.

sender_phonestring

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_codestring

Format: ISO Alpha-2 Country Code; example: FR

Country code registered with the sender/buyer's marketplace account.

sender_create_datestring

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_ipstring

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_scorestring

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_idstring

Format: Alphanumeric; example: A12345N343

Unique identifier of the seller/recipient's account on the marketplace platform.

receiver_create_datestring

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_emailstring

Format: E.123 – Email Address; example: john@example.com

Seller/recipient's registered email on the marketplace platform.

receiver_address_country_codestring

Format: ISO Alpha-2 Country Code; example: FR

Seller/recipient's country code registered on the marketplace platform.

business_namestring

Format: Alphanumeric; example: Acme Corp.

Business name used by the seller/recipient to register on the marketplace platform.

recipient_popularity_scorestring

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_datestring

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_totalstring

Format: Integer; example: 34

Total number of transactions the sender/buyer has had to date on the marketplace platform (through PayPal or otherwise).

verticalstring

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_tangiblestring

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

Success

DataCollectionIdstring

The unique identifier of the Data Collection object.

A new DataCollectionId is needed for each call to:

  • POST Create a PayPal PayIn
  • POST Create a Recurring PayPal PayIn, with both the CIT and MIT payloads
  • POST Create a PayPal Extended Preauthorization

Changes

  • f44a59c76515Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e731ec4a85bRevision changes
    • info

      api operation id submit_data_paypal_payin removed and replaced with paypal_submit_data_paypal_payin