PayPal · Schema
Customer Data
The customer's referral data that partners share with PayPal.
PayPalBillingCommerceDisputesInvoicesOrderPaymentsPayoutsSubscriptionTokensWebhookAgentic CommercePayment Processing
Properties
| Name | Type | Description |
|---|---|---|
| object | Email address of the customer used to create the account. | |
| preferred_language_code | object | The preferred [locale code](/docs/api/reference/locale-codes/) to use in the onboarding flow for the customer. |
| tracking_id | string | The partner's unique identifier for this customer in their system which can be used to track user in PayPal. |
| partner_config_override | object | The configuration property that the partner intends to override for this onboarding request. |
| financial_instruments | object | Array of financial instruments attached to the customer's account. |
| operations | array | An array of operations to perform for the customer while they share their data. |
| products | array | An array of PayPal products to which the partner wants to onboard the customer. |
| capabilities | array | An array of capabilities which the partner wants to enable for the selected products. Supported only when products are specified. |
| outside_process_dependencies | array | An array of dependent processes. |
| legal_consents | array | An array of all consents that the partner has received from this seller. If `SHARE_DATA_CONSENT` is not granted, PayPal does not store customer data. |
| payout_attributes | object | Payout specific attributes. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/referral_data",
"title": "Customer Data",
"type": "object",
"description": "The customer's referral data that partners share with PayPal.",
"allOf": [
{
"description": "The common account model representing the basic account structure.",
"$ref": "#/components/schemas/account"
},
{
"properties": {
"email": {
"description": "Email address of the customer used to create the account.",
"$ref": "#/components/schemas/email_address"
},
"preferred_language_code": {
"description": "The preferred [locale code](/docs/api/reference/locale-codes/) to use in the onboarding flow for the customer.",
"$ref": "#/components/schemas/language"
},
"tracking_id": {
"type": "string",
"description": "The partner's unique identifier for this customer in their system which can be used to track user in PayPal.",
"minLength": 1,
"maxLength": 127
},
"partner_config_override": {
"description": "The configuration property that the partner intends to override for this onboarding request.",
"$ref": "#/components/schemas/partner_config_override"
},
"financial_instruments": {
"description": "Array of financial instruments attached to the customer's account.",
"$ref": "#/components/schemas/financial_instruments"
},
"operations": {
"type": "array",
"description": "An array of operations to perform for the customer while they share their data.",
"items": {
"$ref": "#/components/schemas/operation"
},
"minItems": 1,
"maxItems": 5
},
"products": {
"type": "array",
"description": "An array of PayPal products to which the partner wants to onboard the customer.",
"items": {
"$ref": "#/components/schemas/product"
},
"minItems": 1,
"maxItems": 5
},
"capabilities": {
"type": "array",
"description": "An array of capabilities which the partner wants to enable for the selected products. Supported only when products are specified.",
"items": {
"$ref": "#/components/schemas/capabilities"
},
"minItems": 1,
"maxItems": 5
},
"outside_process_dependencies": {
"type": "array",
"description": "An array of dependent processes.",
"items": {
"$ref": "#/components/schemas/dependent_process"
},
"minItems": 1,
"maxItems": 5
},
"legal_consents": {
"type": "array",
"description": "An array of all consents that the partner has received from this seller. If `SHARE_DATA_CONSENT` is not granted, PayPal does not store customer data.",
"items": {
"$ref": "#/components/schemas/legal_consent"
},
"minItems": 1,
"maxItems": 5
},
"payout_attributes": {
"description": "Payout specific attributes.",
"$ref": "#/components/schemas/payout_attributes"
}
}
}
],
"additionalProperties": true,
"required": [
"operations",
"legal_consents"
]
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/paypal-referral-data"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.