PayPal Developer Logo
  • Docs
    OnlineIn-PersonMultiparty3rd-PartyPayoutsDisputesReportsIdentityTrackingDocs Archive
  • APIs & SDKs
    REST APIsJavaScript SDKNVP/SOAP APIsDonate SDKBraintree GraphQL API
  • Tools
    Integration BuilderSandbox Testing GuideAPI ExecutorDemo PortalNegative TestingCodespacesNewVS Code ExtensionNewCredit Card GeneratorWebhooksAPI StatusSecure File Transfer
  • Video Library
  • Support
Log in to Dashboard
    Log in to Dashboard
    REST APIs
    Get Started with PayPal REST APIs
    Authentication
    Postman Guide
    API requests
    API responses
    Core Resources
    Overview
    Add Tracking
    Catalog Products
    Disputes
    Identity
    Invoicing
    Orders
    Partner Referrals
      Partner Referrals
      post
      Create partner referral
      get
      Show referral data
      Definitions
    Payment Experience
    Payment Method Tokens
    Payments
    Payouts
    Referenced Payouts
    Subscriptions
    Transaction Search
    Webhooks Management
    Webhooks
    Overview
    Webhook event names
    Webhooks Events dashboard
    Webhooks simulator
    Integration
    Sandbox
    Overview
    Accounts
    Bulk Accounts
    Card testing
    Codespaces
    PayPal for Visual Studio Code
    Negative Testing
    Go Live
    Production Environment
    PayPal Application Guidelines
    PayPal Security Guidelines
    Rate Limiting Guidelines
    Idempotency
    Reference
    Currency Codes
    Country Codes
    State & Province Codes
    Locale codes
    Deprecated Resources
    Deprecated resources
    Billing Agreements
    Billing Plans
    Invoicing v1
    Orders v1
    Partner Referrals v1
    Payments v1

Partner Referrals (2)

API Version v2

Use the Partner Referrals API to add PayPal seller accounts to PayPal Commerce Platform for Marketplaces and Platforms.

Important: This endpoint is available to approved partners only. Fill out this form to get approved and a PayPal representative will reach out to you shortly.
For more information about partner integrations and onboarding sellers, see PayPal Commerce Platform for Marketplaces and Platforms.

Create partner referral

post/v2/customer/partner-referrals

Creates a partner referral that is shared by the partner or API caller. The partner referral is used to onboard the seller, and contains the seller's personal, business, financial and operations.

SecurityOauth2
Request
Request Body schema: application/json
Array of objects (Individual_owner) [ 0 .. 2 ] items

List of owners in the account. There should be only one primary account owner which is mentioned in their role_type.

object (Business_entity)

Business entity of the account.

tracking_id
string [ 1 .. 127 ] characters

The partner's unique identifier for this customer in their system which can be used to track user in PayPal.

required
Array of objects (operation) [ 1 .. 5 ] items

An array of operations to perform for the customer while they share their data.

products
Array of strings (product_name) [ 1 .. 5 ] items

An array of PayPal products to which the partner wants to onboard the customer.

Items Enum: Description
EXPRESS_CHECKOUT

Express checkout product

PPPLUS

PayPal PLUS product.

WEBSITE_PAYMENT_PRO

PayPal Professional product

PAYMENT_METHODS

PayPal Alternative Payment Methods product

PPCP

PayPal Complete Payments product, which includes advanced debit and credit card payments, Apple Pay, and Google Pay.

ADVANCED_VAULTING

PayPal Advanced Vaulting product. Must be requested along with either EXPRESS_CHECKOUT or PPCP

IZETTLE

Zettle Product

capabilities
Array of strings (capability_name) [ 1 .. 5 ] items

An array of capabilities which the partner wants to enable for the selected products. Supported only when products are specified.

Items Enum: Description
PAYPAL_WALLET_VAULTING_ADVANCED

Enables capability to save payment methods. Supported only when ADVANCED_VAULTING is requested and EXPRESS_CHECKOUT or PPCP is also requested.

PAY_UPON_INVOICE

Enables Pay Upon Invoice (PUI) which is a deferred payment method that allows a buyer to buy now and pay later. Supported only when PAYMENT_METHODS is requested.

APPLE_PAY

Enables Apple Pay capability. Supported only when PAYMENT_METHODS is requested.

outside_process_dependencies
Array of any [ 1 .. 5 ] items

An array of dependent processes.

required
Array of objects (legal_consent) [ 1 .. 5 ] items

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.

email
string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^.+@[^"\-].+$

Email address of the customer used to create the account.

preferred_language_code
string <ppaas_common_language_v3> (language) [ 2 .. 10 ] characters ^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}))...

The preferred locale code to use in the onboarding flow for the customer.

object (partner_configuration_override)

The configuration property that the partner intends to override for this onboarding request.

object (Financial instrument.)

Array of financial instruments attached to the customer's account.

object (Payout Attributes)

Payout specific attributes.

property name*
additional property
any
Responses
201

A successful request returns the HTTP 201 Created status code and a JSON response body that contains a HATEOAS link to show the referral data and an action_url to which you redirect the customer in a browser to complete the signup process. The partner_referral_id token is appended to the URL.

Request samples
  • Payload
  • cURL
  • Node.js
  • Java
  • Python
application/json
{
  • "individual_owners": [
    • {
      • "names": [
        • {
          • "prefix": "Mr.",
          • "given_name": "John",
          • "surname": "Doe",
          • "middle_name": "Middle",
          • "suffix": "Jr.",
          • "full_name": "John Middle Doe Jr.",
          • "type": "LEGAL"
          }
        ],
      • "citizenship": "US",
      • "addresses": [
        • {
          • "address_line_1": "One Washington Square",
          • "address_line_2": "Apt 123",
          • "admin_area_2": "San Jose",
          • "admin_area_1": "CA",
          • "postal_code": "95112",
          • "country_code": "US",
          • "type": "HOME"
          }
        ],
      • "phones": [
        • {
          • "country_code": "1",
          • "national_number": "6692468839",
          • "extension_number": "1234",
          • "type": "MOBILE"
          }
        ],
      • "birth_details": {
        • "date_of_birth": "1955-12-29"
        },
      • "type": "PRIMARY"
      }
    ],
  • "business_entity": {
    • "business_type": {
      • "type": "INDIVIDUAL",
      • "subtype": "ASSO_TYPE_INCORPORATED"
      },
    • "business_industry": {
      • "category": "1004",
      • "mcc_code": "8931",
      • "subcategory": "2025"
      },
    • "business_incorporation": {
      • "incorporation_country_code": "US",
      • "incorporation_date": "1986-12-29"
      },
    • "names": [
      • {
        • "business_name": "Test Enterprise",
        • "type": "LEGAL_NAME"
        }
      ],
    • "emails": [
      • {
        • "type": "CUSTOMER_SERVICE",
        • "email": "customerservice@example.com"
        }
      ],
    • "website": "https://mystore.testenterprises.com",
    • "addresses": [
      • {
        • "address_line_1": "One Washington Square",
        • "address_line_2": "Apt 123",
        • "admin_area_2": "San Jose",
        • "admin_area_1": "CA",
        • "postal_code": "95112",
        • "country_code": "US",
        • "type": "WORK"
        }
      ],
    • "phones": [
      • {
        • "country_code": "1",
        • "national_number": "6692478833",
        • "extension_number": "1234",
        • "type": "CUSTOMER_SERVICE"
        }
      ],
    • "beneficial_owners": {
      • "individual_beneficial_owners": [
        • {
          • "names": [
            • {
              • "prefix": "Mr.",
              • "given_name": "John",
              • "surname": "Doe",
              • "middle_name": "Middle",
              • "suffix": "Jr.",
              • "full_name": "John Middle Doe Jr.",
              • "type": "LEGAL"
              }
            ],
          • "citizenship": "US",
          • "addresses": [
            • {
              • "address_line_1": "One Washington Square",
              • "address_line_2": "Apt 123",
              • "admin_area_2": "San Jose",
              • "admin_area_1": "CA",
              • "postal_code": "95112",
              • "country_code": "US",
              • "type": "HOME"
              }
            ],
          • "phones": [
            • {
              • "country_code": "1",
              • "national_number": "6692468839",
              • "extension_number": "1234",
              • "type": "MOBILE"
              }
            ],
          • "birth_details": {
            • "date_of_birth": "1955-12-29"
            },
          • "percentage_of_ownership": "50"
          }
        ],
      • "business_beneficial_owners": [
        • {
          • "business_type": {
            • "type": "INDIVIDUAL",
            • "subtype": "ASSO_TYPE_INCORPORATED"
            },
          • "business_industry": {
            • "category": "1004",
            • "mcc_code": "8931",
            • "subcategory": "2025"
            },
          • "business_incorporation": {
            • "incorporation_country_code": "US",
            • "incorporation_date": "1986-12-29"
            },
          • "names": [
            • {
              • "business_name": "Test Enterprise",
              • "type": "LEGAL_NAME"
              }
            ],
          • "emails": [
            • {
              • "type": "CUSTOMER_SERVICE",
              • "email": "customerservice@example.com"
              }
            ],
          • "website": "https://mystore.testenterprises.com",
          • "addresses": [
            • {
              • "address_line_1": "One Washington Square",
              • "address_line_2": "Apt 123",
              • "admin_area_2": "San Jose",
              • "admin_area_1": "CA",
              • "postal_code": "95112",
              • "country_code": "US",
              • "type": "WORK"
              }
            ],
          • "phones": [
            • {
              • "country_code": "1",
              • "national_number": "6692478833",
              • "extension_number": "1234",
              • "type": "CUSTOMER_SERVICE"
              }
            ],
          • "percentage_of_ownership": "50"
          }
        ]
      },
    • "office_bearers": [
      • {
        • "names": [
          • {
            • "prefix": "Mr.",
            • "given_name": "John",
            • "surname": "Doe",
            • "middle_name": "Middle",
            • "suffix": "Jr.",
            • "full_name": "John Middle Doe Jr.",
            • "type": "LEGAL"
            }
          ],
        • "citizenship": "US",
        • "addresses": [
          • {
            • "address_line_1": "One Washington Square",
            • "address_line_2": "Apt 123",
            • "admin_area_2": "San Jose",
            • "admin_area_1": "CA",
            • "postal_code": "95112",
            • "country_code": "US",
            • "type": "HOME"
            }
          ],
        • "phones": [
          • {
            • "country_code": "1",
            • "national_number": "6692468839",
            • "extension_number": "1234",
            • "type": "MOBILE"
            }
          ],
        • "birth_details": {
          • "date_of_birth": "1955-12-29"
          },
        • "role": "DIRECTOR"
        }
      ],
    • "annual_sales_volume_range": {
      • "minimum_amount": {
        • "currency_code": "USD",
        • "value": "10000"
        },
      • "maximum_amount": {
        • "currency_code": "USD",
        • "value": "50000"
        }
      },
    • "average_monthly_volume_range": {
      • "minimum_amount": {
        • "currency_code": "USD",
        • "value": "1000"
        },
      • "maximum_amount": {
        • "currency_code": "USD",
        • "value": "50000"
        }
      },
    • "purpose_code": "P0104"
    },
  • "email": "accountemail@example.com",
  • "preferred_language_code": "en-US",
  • "tracking_id": "testenterprices123122",
  • "partner_config_override": {
    • "partner_logo_url": "https://www.paypalobjects.com/webstatic/mktg/logo/pp_cc_mark_111x69.jpg",
    • "return_url": "https://testenterprises.com/merchantonboarded",
    • "return_url_description": "the url to return the merchant after the paypal onboarding process.",
    • "action_renewal_url": "https://testenterprises.com/renew-exprired-url",
    • "show_add_credit_card": true
    },
  • "operations": [
    • {
      • "operation": "BANK_ADDITION"
      }
    ],
  • "financial_instruments": {
    • "banks": [
      • {
        • "nick_name": "Bank of America",
        • "account_number": "123405668293",
        • "account_type": "CHECKING",
        • "currency_code": "USD",
        • "identifiers": [
          • {
            • "type": "ROUTING_NUMBER_1",
            • "value": "123456789"
            }
          ]
        }
      ]
    },
  • "legal_consents": [
    • {
      • "type": "SHARE_DATA_CONSENT",
      • "granted": true
      }
    ],
  • "products": [
    • "EXPRESS_CHECKOUT"
    ]
}
Response samples
  • 201
application/json
{
  • "links": [
    • {
      • "href": "https://uri.paypal.com/v2/customer/partner-referrals/ZjcyODU4ZWYtYTA1OC00ODIwLTk2M2EtOTZkZWQ4NmQwYzI3RU12cE5xa0xMRmk1NWxFSVJIT1JlTFdSbElCbFU1Q3lhdGhESzVQcU9iRT0=",
      • "rel": "self",
      • "method": "GET"
      },
    • {
      • "href": "https://www.paypal.com/merchantsignup/partner/onboardingentry?token=ZjcyODU4ZWYtYTA1OC00ODIwLTk2M2EtOTZkZWQ4NmQwYzI3RU12cE5xa0xMRmk1NWxFSVJIT1JlTFdSbElCbFU1Q3lhdGhESzVQcU9iRT0=",
      • "rel": "action_url",
      • "method": "GET"
      }
    ]
}

Show referral data

get/v2/customer/partner-referrals/{partner_referral_id}

Shows details by ID for referral data that was shared by the partner or API caller.

SecurityOauth2
Request
path Parameters
partner_referral_id
required
string

The ID of the partner-referrals data for which to show details.

Responses
200

A successful request returns the HTTP 200 OK status code and a JSON response body that shows referral data.

Request samples
  • cURL
  • Node.js
  • Java
  • Python
curl -v -X GET https://api-m.sandbox.paypal.com/v2/customer/partner-referrals/ZjcyODU4ZWYtYTA1OC00ODIwLTk2M2EtOTZkZWQ4NmQwYzI3RU12cE5xa0xMRmk1NWxFSVJIT1JlTFdSbElCbFU1Q3lhdGhESzVQcU9iRT0= \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer access_token6V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g'  
Response samples
  • 200
application/json
{
  • "partner_referral_id": "ZjcyODU4ZWYtYTA1OC00ODIwLTk2M2EtOTZkZWQ4NmQwYzI3RU12cE5xa0xMRmk1NWxFSVJIT1JlTFdSbElCbFU1Q3lhdGhESzVQcU9iRT0=",
  • "submitter_payer_id": "RFYUH2QQDGUQU",
  • "referral_data": {
    • "individual_owners": [
      • {
        • "names": [
          • {
            • "prefix": "Mr.",
            • "given_name": "John",
            • "surname": "Doe",
            • "middle_name": "Middle",
            • "suffix": "Jr.",
            • "full_name": "John Middle Doe Jr.",
            • "type": "LEGAL"
            }
          ],
        • "citizenship": "US",
        • "addresses": [
          • {
            • "address_line_1": "One Washington Square",
            • "address_line_2": "Apt 123",
            • "admin_area_2": "San Jose",
            • "admin_area_1": "CA",
            • "postal_code": "95112",
            • "country_code": "US",
            • "type": "HOME"
            }
          ],
        • "phones": [
          • {
            • "country_code": "1",
            • "national_number": "6692468839",
            • "extension_number": "1234",
            • "type": "MOBILE"
            }
          ],
        • "birth_details": {
          • "date_of_birth": "1955-12-29"
          },
        • "type": "PRIMARY"
        }
      ],
    • "business_entity": {
      • "business_type": {
        • "type": "INDIVIDUAL",
        • "subtype": "ASSO_TYPE_INCORPORATED"
        },
      • "business_industry": {
        • "category": "1004",
        • "mcc_code": "8931",
        • "subcategory": "2025"
        },
      • "business_incorporation": {
        • "incorporation_country_code": "US",
        • "incorporation_date": "1986-12-29"
        },
      • "names": [
        • {
          • "business_name": "Test Enterprise",
          • "type": "LEGAL_NAME"
          }
        ],
      • "emails": [
        • {
          • "type": "CUSTOMER_SERVICE",
          • "email": "customerservice@example.com"
          }
        ],
      • "website": "https://mystore.testenterprises.com",
      • "addresses": [
        • {
          • "address_line_1": "One Washington Square",
          • "address_line_2": "Apt 123",
          • "admin_area_2": "San Jose",
          • "admin_area_1": "CA",
          • "postal_code": "95112",
          • "country_code": "US",
          • "type": "WORK"
          }
        ],
      • "phones": [
        • {
          • "country_code": "1",
          • "national_number": "6692478833",
          • "extension_number": "1234",
          • "type": "CUSTOMER_SERVICE"
          }
        ],
      • "beneficial_owners": {
        • "individual_beneficial_owners": [
          • {
            • "names": [
              • {
                • "prefix": "Mr.",
                • "given_name": "John",
                • "surname": "Doe",
                • "middle_name": "Middle",
                • "suffix": "Jr.",
                • "full_name": "John Middle Doe Jr.",
                • "type": "LEGAL"
                }
              ],
            • "citizenship": "US",
            • "addresses": [
              • {
                • "address_line_1": "One Washington Square",
                • "address_line_2": "Apt 123",
                • "admin_area_2": "San Jose",
                • "admin_area_1": "CA",
                • "postal_code": "95112",
                • "country_code": "US",
                • "type": "HOME"
                }
              ],
            • "phones": [
              • {
                • "country_code": "1",
                • "national_number": "6692468839",
                • "extension_number": "1234",
                • "type": "MOBILE"
                }
              ],
            • "birth_details": {
              • "date_of_birth": "1955-12-29"
              },
            • "percentage_of_ownership": "50"
            }
          ],
        • "business_beneficial_owners": [
          • {
            • "business_type": {
              • "type": "INDIVIDUAL",
              • "subtype": "ASSO_TYPE_INCORPORATED"
              },
            • "business_industry": {
              • "category": "1004",
              • "mcc_code": "8931",
              • "subcategory": "2025"
              },
            • "business_incorporation": {
              • "incorporation_country_code": "US",
              • "incorporation_date": "1986-12-29"
              },
            • "names": [
              • {
                • "business_name": "Test Enterprise",
                • "type": "LEGAL_NAME"
                }
              ],
            • "emails": [
              • {
                • "type": "CUSTOMER_SERVICE",
                • "email": "customerservice@example.com"
                }
              ],
            • "website": "https://mystore.testenterprises.com",
            • "addresses": [
              • {
                • "address_line_1": "One Washington Square",
                • "address_line_2": "Apt 123",
                • "admin_area_2": "San Jose",
                • "admin_area_1": "CA",
                • "postal_code": "95112",
                • "country_code": "US",
                • "type": "WORK"
                }
              ],
            • "phones": [
              • {
                • "country_code": "1",
                • "national_number": "6692478833",
                • "extension_number": "1234",
                • "type": "CUSTOMER_SERVICE"
                }
              ],
            • "percentage_of_ownership": "50"
            }
          ]
        },
      • "office_bearers": [
        • {
          • "names": [
            • {
              • "prefix": "Mr.",
              • "given_name": "John",
              • "surname": "Doe",
              • "middle_name": "Middle",
              • "suffix": "Jr.",
              • "full_name": "John Middle Doe Jr.",
              • "type": "LEGAL"
              }
            ],
          • "citizenship": "US",
          • "addresses": [
            • {
              • "address_line_1": "One Washington Square",
              • "address_line_2": "Apt 123",
              • "admin_area_2": "San Jose",
              • "admin_area_1": "CA",
              • "postal_code": "95112",
              • "country_code": "US",
              • "type": "HOME"
              }
            ],
          • "phones": [
            • {
              • "country_code": "1",
              • "national_number": "6692468839",
              • "extension_number": "1234",
              • "type": "MOBILE"
              }
            ],
          • "birth_details": {
            • "date_of_birth": "1955-12-29"
            },
          • "role": "DIRECTOR"
          }
        ],
      • "annual_sales_volume_range": {
        • "minimum_amount": {
          • "currency_code": "USD",
          • "value": "10000"
          },
        • "maximum_amount": {
          • "currency_code": "USD",
          • "value": "50000"
          }
        },
      • "average_monthly_volume_range": {
        • "minimum_amount": {
          • "currency_code": "USD",
          • "value": "1000"
          },
        • "maximum_amount": {
          • "currency_code": "USD",
          • "value": "50000"
          }
        },
      • "purpose_code": "P0104"
      },
    • "email": "accountemail@example.com",
    • "preferred_language_code": "en-US",
    • "tracking_id": "testenterprices123122",
    • "partner_config_override": {
      • "partner_logo_url": "https://www.paypalobjects.com/webstatic/mktg/logo/pp_cc_mark_111x69.jpg",
      • "return_url": "https://testenterprises.com/merchantonboarded",
      • "return_url_description": "the url to return the merchant after the paypal onboarding process.",
      • "action_renewal_url": "https://testenterprises.com/renew-exprired-url",
      • "show_add_credit_card": true
      },
    • "operations": [
      • {
        • "operation": "API_INTEGRATION",
        • "api_integration_preference": {
          • "classic_api_integration": {
            • "integration_type": "THIRD_PARTY",
            • "third_party_details": {
              • "permissions": [
                • "EXPRESS_CHECKOUT",
                • "REFUND",
                • "DIRECT_PAYMENT",
                • "AUTH_CAPTURE",
                • "BUTTON_MANAGER",
                • "ACCOUNT_BALANCE",
                • "TRANSACTION_DETAILS"
                ]
              },
            • "first_party_details": "CERTIFICATE"
            },
          • "rest_api_integration": {
            • "integration_method": "PAYPAL",
            • "integration_type": "THIRD_PARTY",
            • "third_party_details": {
              • "features": [
                • "PAYMENT",
                • "REFUND",
                • "PARTNER_FEE"
                ]
              }
            }
          },
        • "billing_agreement": {
          • "description": "Billing Agreement Description Field",
          • "billing_experience_preference": {
            • "experience_id": "string",
            • "billing_context_set": true
            },
          • "merchant_custom_data": "PatnerMERCHANT23124",
          • "approval_url": "wttps://www.paypal.com/agreements/approve?ba_token=BA-67944913LE886121E",
          • "ec_token": "EC-1S970363DB536864M"
          }
        }
      ],
    • "products": [
      • "EXPRESS_CHECKOUT"
      ],
    • "legal_consents": [
      • {
        • "type": "SHARE_DATA_CONSENT",
        • "granted": true
        }
      ],
    • "payout_attributes": {
      • "marketplace": true,
      • "kyc_required": true,
      • "country_transfer_method_currency_selection": [
        • {
          • "country": "US",
          • "transfer_methods": [
            • {
              • "transfer_method_type": "BANK_ACCOUNT",
              • "currencies": [
                • "USD, CAD"
                ]
              },
            • {
              • "transfer_method_type": "PAYPAL"
              }
            ]
          },
        • {
          • "country": "CA",
          • "transfer_methods": [
            • {
              • "transfer_method_type": "WIRE",
              • "currencies": [
                • "USD, CAD"
                ]
              },
            • {
              • "transfer_method_type": "VENMO"
              }
            ]
          }
        ]
      }
    },
  • "links": [
    • {
      • "href": "https://uri.paypal.com/v2/customer/partner-referrals/ZjcyODU4ZWYtYTA1OC00ODIwLTk2M2EtOTZkZWQ4NmQwYzI3RU12cE5xa0xMRmk1NWxFSVJIT1JlTFdSbElCbFU1Q3lhdGhESzVQcU9iRT0=",
      • "rel": "self",
      • "method": "GET"
      },
    • {
      • "href": "https://www.paypal.com/merchantsignup/partner/onboardingentry?token=ZjcyODU4ZWYtYTA1OC00ODIwLTk2M2EtOTZkZWQ4NmQwYzI3RU12cE5xa0xMRmk1NWxFSVJIT1JlTFdSbElCbFU1Q3lhdGhESzVQcU9iRT0=",
      • "rel": "action_url",
      • "method": "GET"
      }
    ]
}

Definitions

Account

Common account object to hold the account related details of the customer.

Array of objects (Individual_owner) [ 0 .. 2 ] items

List of owners in the account. There should be only one primary account owner which is mentioned in their role_type.

object (Business_entity)

Business entity of the account.

{
  • "individual_owners": [
    • {
      • "names": [
        • {
          • "prefix": "string",
          • "given_name": "string",
          • "surname": "string",
          • "middle_name": "string",
          • "suffix": "string",
          • "full_name": "string",
          • "type": "LEGAL"
          }
        ],
      • "addresses": [
        • {
          • "address_line_1": "string",
          • "address_line_2": "string",
          • "admin_area_2": "string",
          • "admin_area_1": "string",
          • "postal_code": "string",
          • "country_code": "st",
          • "type": "HOME"
          }
        ],
      • "phones": [
        • {
          • "country_code": "str",
          • "national_number": "string",
          • "extension_number": "string",
          • "type": "FAX"
          }
        ],
      • "documents": [
        • {
          • "identification_number": "string",
          • "issuing_country_code": "string",
          • "type": "SOCIAL_SECURITY_NUMBER"
          }
        ],
      • "citizenship": "st",
      • "birth_details": {
        • "date_of_birth": "stringstri"
        },
      • "type": "PRIMARY"
      }
    ],
  • "business_entity": {
    • "names": [
      • {
        • "business_name": "string",
        • "type": "DOING_BUSINESS_AS"
        }
      ],
    • "emails": [
      • {
        • "type": "CUSTOMER_SERVICE",
        • "email": "string"
        }
      ],
    • "website": "http://example.com",
    • "addresses": [
      • {
        • "address_line_1": "string",
        • "address_line_2": "string",
        • "admin_area_2": "string",
        • "admin_area_1": "string",
        • "postal_code": "string",
        • "country_code": "st",
        • "type": "WORK"
        }
      ],
    • "phones": [
      • {
        • "country_code": "str",
        • "national_number": "string",
        • "extension_number": "string",
        • "type": "CUSTOMER_SERVICE"
        }
      ],
    • "documents": [
      • {
        • "identification_number": "string",
        • "issuing_country_code": "string",
        • "type": "SOCIAL_SECURITY_NUMBER"
        }
      ],
    • "business_type": {
      • "type": "ANY_OTHER_BUSINESS_ENTITY",
      • "subtype": "ASSO_TYPE_INCORPORATED"
      },
    • "business_industry": {
      • "category": "string",
      • "mcc_code": "string",
      • "subcategory": "string"
      },
    • "business_incorporation": {
      • "incorporation_country_code": "st",
      • "incorporation_date": "stringstri"
      },
    • "office_bearers": [
      • {
        • "names": [
          • {
            • "prefix": "string",
            • "given_name": "string",
            • "surname": "string",
            • "middle_name": "string",
            • "suffix": "string",
            • "full_name": "string",
            • "type": "LEGAL"
            }
          ],
        • "addresses": [
          • {
            • "address_line_1": "string",
            • "address_line_2": "string",
            • "admin_area_2": "string",
            • "admin_area_1": "string",
            • "postal_code": "string",
            • "country_code": "st",
            • "type": "HOME"
            }
          ],
        • "phones": [
          • {
            • "country_code": "str",
            • "national_number": "string",
            • "extension_number": "string",
            • "type": "FAX"
            }
          ],
        • "documents": [
          • {
            • "identification_number": "string",
            • "issuing_country_code": "string",
            • "type": "SOCIAL_SECURITY_NUMBER"
            }
          ],
        • "citizenship": "st",
        • "birth_details": {
          • "date_of_birth": "stringstri"
          },
        • "role": "CEO"
        }
      ],
    • "purpose_code": [
      • "P0104"
      ],
    • "business_description": "string",
    • "beneficial_owners": {
      • "individual_beneficial_owners": [
        • {
          • "names": [
            • {
              • "prefix": "string",
              • "given_name": "string",
              • "surname": "string",
              • "middle_name": "string",
              • "suffix": "string",
              • "full_name": "string",
              • "type": "LEGAL"
              }
            ],
          • "addresses": [
            • {
              • "address_line_1": "string",
              • "address_line_2": "string",
              • "admin_area_2": "string",
              • "admin_area_1": "string",
              • "postal_code": "string",
              • "country_code": "st",
              • "type": "HOME"
              }
            ],
          • "phones": [
            • {
              • "country_code": "str",
              • "national_number": "string",
              • "extension_number": "string",
              • "type": "FAX"
              }
            ],
          • "citizenship": "st",
          • "birth_details": {
            • "date_of_birth": "stringstri"
            },
          • "percentage_of_ownership": "string"
          }
        ],
      • "business_beneficial_owners": [
        • {
          • "names": [
            • {
              • "business_name": "string",
              • "type": "DOING_BUSINESS_AS"
              }
            ],
          • "emails": [
            • {
              • "type": "CUSTOMER_SERVICE",
              • "email": "string"
              }
            ],
          • "website": "http://example.com",
          • "addresses": [
            • {
              • "address_line_1": "string",
              • "address_line_2": "string",
              • "admin_area_2": "string",
              • "admin_area_1": "string",
              • "postal_code": "string",
              • "country_code": "st",
              • "type": "WORK"
              }
            ],
          • "phones": [
            • {
              • "country_code": "str",
              • "national_number": "string",
              • "extension_number": "string",
              • "type": "CUSTOMER_SERVICE"
              }
            ],
          • "business_type": {
            • "type": "ANY_OTHER_BUSINESS_ENTITY",
            • "subtype": "ASSO_TYPE_INCORPORATED"
            },
          • "business_industry": {
            • "category": "string",
            • "mcc_code": "string",
            • "subcategory": "string"
            },
          • "business_incorporation": {
            • "incorporation_country_code": "st",
            • "incorporation_date": "stringstri"
            },
          • "percentage_of_ownership": "string"
          }
        ]
      },
    • "annual_sales_volume_range": {
      • "minimum_amount": {
        • "currency_code": "str",
        • "value": "string"
        },
      • "maximum_amount": {
        • "currency_code": "str",
        • "value": "string"
        }
      },
    • "average_monthly_volume_range": {
      • "minimum_amount": {
        • "currency_code": "str",
        • "value": "string"
        },
      • "maximum_amount": {
        • "currency_code": "str",
        • "value": "string"
        }
      }
    }
}

Bank Account

The bank account information.

nick_name
string [ 1 .. 50 ] characters ^[0-9A-Za-z_-]+$

The user-provided short name for the user's bank account.

account_number
required
string [ 1 .. 50 ] characters \d+

The bank account number.

account_type
required
string [ 1 .. 50 ] characters ^[0-9A-Z_]+$

The type of bank account.

Enum: Description
CHECKING

Checking account.

SAVINGS

Savings account.

Array of objects (Bank Account Identifier) [ 0 .. 20 ] items

An array of instrument institute attributes. Used with the account number to uniquely identify the instrument. Value is:

  • For banks with IBAN information, the IBAN number.
  • For banks with BBAN information, the BBAN number.
  • For banks with both IBAN and BBAN information, the IBAN number.

currency_code
string <ppaas_common_currency_code_v2> (currency_code) = 3 characters

The primary currency code of the bank account.

object (Portable Postal Address (Medium-Grained))

The branch location, if applicable.

object (Mandate)

Mandate for this bank account.

{
  • "nick_name": "string",
  • "account_number": "string",
  • "account_type": "CHECKING",
  • "identifiers": [
    • {
      • "type": "BANK_CODE",
      • "value": "string"
      }
    ],
  • "currency_code": "str",
  • "branch_location": {
    • "address_line_1": "string",
    • "address_line_2": "string",
    • "address_line_3": "string",
    • "admin_area_4": "string",
    • "admin_area_3": "string",
    • "admin_area_2": "string",
    • "admin_area_1": "string",
    • "postal_code": "string",
    • "country_code": "st",
    • "address_details": {
      • "street_number": "string",
      • "street_name": "string",
      • "street_type": "string",
      • "delivery_service": "string",
      • "building_name": "string",
      • "sub_building": "string"
      }
    },
  • "mandate": {
    • "accepted": true
    }
}

Bank Account Identifier

The bank account ID. An ID with ROUTING_NUMBER_1 is required.

type
string [ 1 .. 125 ] characters ^[0-9A-Z_-]+$

The bank account ID type.

Enum: Description
BANK_CODE

The bank code.

BI_CODE

The BI code.

BRANCH_CODE

Branch code.

ROUTING_NUMBER_1

The bank routing number.

ROUTING_NUMBER_2

The bank routing number.

ROUTING_NUMBER_3

The bank routing number.

SWIFT_CODE

The bank swift code.

INTERMEDIARY_SWIFT_CODE

Swift code.

BBAN

BBAN.

BBAN_ENCRYPTED

BBAN enrypted.

BBAN_HMAC

BBAN HMAC.

AGGREGATOR_YODLEE

Aggregator Yodlee.

value
string [ 1 .. 125 ] characters ^[A-Za-z0-9-_.+/ =]+

The value of account identifier.

{
  • "type": "BANK_CODE",
  • "value": "string"
}

Beneficial_owners

Beneficial owners of the entity.

Array of objects (Individual_beneficial_owner) [ 0 .. 5 ] items

Individual beneficial owners.

Array of objects (Business_beneficial_owner) [ 0 .. 5 ] items

Business beneficial owners.

{
  • "individual_beneficial_owners": [
    • {
      • "names": [
        • {
          • "prefix": "string",
          • "given_name": "string",
          • "surname": "string",
          • "middle_name": "string",
          • "suffix": "string",
          • "full_name": "string",
          • "type": "LEGAL"
          }
        ],
      • "addresses": [
        • {
          • "address_line_1": "string",
          • "address_line_2": "string",
          • "admin_area_2": "string",
          • "admin_area_1": "string",
          • "postal_code": "string",
          • "country_code": "st",
          • "type": "HOME"
          }
        ],
      • "phones": [
        • {
          • "country_code": "str",
          • "national_number": "string",
          • "extension_number": "string",
          • "type": "FAX"
          }
        ],
      • "citizenship": "st",
      • "birth_details": {
        • "date_of_birth": "stringstri"
        },
      • "percentage_of_ownership": "string"
      }
    ],
  • "business_beneficial_owners": [
    • {
      • "names": [
        • {
          • "business_name": "string",
          • "type": "DOING_BUSINESS_AS"
          }
        ],
      • "emails": [
        • {
          • "type": "CUSTOMER_SERVICE",
          • "email": "string"
          }
        ],
      • "website": "http://example.com",
      • "addresses": [
        • {
          • "address_line_1": "string",
          • "address_line_2": "string",
          • "admin_area_2": "string",
          • "admin_area_1": "string",
          • "postal_code": "string",
          • "country_code": "st",
          • "type": "WORK"
          }
        ],
      • "phones": [
        • {
          • "country_code": "str",
          • "national_number": "string",
          • "extension_number": "string",
          • "type": "CUSTOMER_SERVICE"
          }
        ],
      • "business_type": {
        • "type": "ANY_OTHER_BUSINESS_ENTITY",
        • "subtype": "ASSO_TYPE_INCORPORATED"
        },
      • "business_industry": {
        • "category": "string",
        • "mcc_code": "string",
        • "subcategory": "string"
        },
      • "business_incorporation": {
        • "incorporation_country_code": "st",
        • "incorporation_date": "stringstri"
        },
      • "percentage_of_ownership": "string"
      }
    ]
}

billing_agreement

The details of the billing agreement between the partner and a seller.

description
string [ 1 .. 125 ] characters ^.+$

The billing agreement description.

object (billing_experience_preference)

The preference that customizes the billing experience of the customer.

merchant_custom_data
string [ 1 .. 125 ] characters ^[a-zA-Z0-9-]+$

The custom data for the billing agreement.

approval_url
string <uri> [ 1 .. 125 ] characters

The URL to which to redirect seller to accept the billing agreement.

ec_token
string [ 1 .. 50 ] characters ^[0-9A-Z_-]+$

The billing agreement token for the agreement.

{
  • "description": "string",
  • "billing_experience_preference": {
    • "experience_id": "string",
    • "billing_context_set": true
    },
  • "merchant_custom_data": "string",
  • "approval_url": "http://example.com",
  • "ec_token": "string"
}

billing_experience_preference

The preference that customizes the billing experience of the customer.

experience_id
string [ 1 .. 20 ] characters ^[a-zA-Z0-9-]+$

The ID of the payment web experience profile.

billing_context_set
boolean

Indicates whether the partner has already displayed the billing context to the seller.

{
  • "experience_id": "string",
  • "billing_context_set": true
}

Birth details

Date of birth data provided by the user

date_of_birth
required
string <ppaas_date_notime_v2> (date_no_time) = 10 characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|...

date of birth, fomrat Internet date and time format.

{
  • "date_of_birth": "stringstri"
}

business

Array of objects (Business name) [ 0 .. 5 ] items

Name of the business.

Array of objects (Email of a person orbusiness) [ 0 .. 5 ] items

Email addresses of the business.

website
string <uri> [ 1 .. 50 ] characters

Website of the business.

Array of objects (Business_address_detail) [ 0 .. 5 ] items

List of addresses associated with the business entity.

Array of objects (Phone details) [ 0 .. 5 ] items

List of phone number associated with the business.

Array of objects (Business document) [ 0 .. 20 ] items

Business Party related Document data collected from the customer.. For example SSN, ITIN, Business registration number that were collected from the user.

object (Business type information)

Information related to the business like the nature of business, started date etc.

object (Business industry)

Information related to the business like the nature of business, started date etc.

object (Business_incorporation)

Information related to the business like the nature of business, started date etc.

{
  • "names": [
    • {
      • "business_name": "string",
      • "type": "DOING_BUSINESS_AS"
      }
    ],
  • "emails": [
    • {
      • "type": "CUSTOMER_SERVICE",
      • "email": "string"
      }
    ],
  • "website": "http://example.com",
  • "addresses": [
    • {
      • "address_line_1": "string",
      • "address_line_2": "string",
      • "admin_area_2": "string",
      • "admin_area_1": "string",
      • "postal_code": "string",
      • "country_code": "st",
      • "type": "WORK"
      }
    ],
  • "phones": [
    • {
      • "country_code": "str",
      • "national_number": "string",
      • "extension_number": "string",
      • "type": "CUSTOMER_SERVICE"
      }
    ],
  • "documents": [
    • {
      • "identification_number": "string",
      • "issuing_country_code": "string",
      • "type": "SOCIAL_SECURITY_NUMBER"
      }
    ],
  • "business_type": {
    • "type": "ANY_OTHER_BUSINESS_ENTITY",
    • "subtype": "ASSO_TYPE_INCORPORATED"
    },
  • "business_industry": {
    • "category": "string",
    • "mcc_code": "string",
    • "subcategory": "string"
    },
  • "business_incorporation": {
    • "incorporation_country_code": "st",
    • "incorporation_date": "stringstri"
    }
}

Business address type

Address type under which the provided address is tagged

string (Business address type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

Address type under which the provided address is tagged

Value: Description
WORK

The address of the business.

"WORK"

Business document

The documents associated with the business.

identification_number
string [ 1 .. 100 ] characters ^[a-zA-Z0-9-]+$

The number for the document. It is the ID number if the document is ID CARD, the passport number if the document is PASSPORT, etc.

issuing_country_code
string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$

The two-character ISO 3166-1 code that identifies the country or region.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

type
string (Document type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

The actual type of the document.

Enum: Description
SOCIAL_SECURITY_NUMBER

A social security number.

EMPLOYMENT_IDENTIFICATION_NUMBER

The employee identification number.

TAX_IDENTIFICATION_NUMBER

The tax identification number.

PASSPORT_NUMBER

A passport number.

PENSION_FUND_ID

A pension fund ID.

MEDICAL_INSURANCE_ID

A medical insurance ID.

CNPJ

The identification number issued to Brazilian companies by the Department of Federal Revenue of Brazil.

CPF

A Brazilian individual's taxpayer registry identification number.

PAN

The Permanent account number issued by the Indian Income Tax Department.

{
  • "identification_number": "string",
  • "issuing_country_code": "string",
  • "type": "SOCIAL_SECURITY_NUMBER"
}

Business industry

The category, subcategory and MCC code of the business.

category
required
string [ 1 .. 20 ] characters ^\d+$

The customer's business category code. PayPal uses industry standard seller category codes.

mcc_code
required
string [ 1 .. 20 ] characters ^\d+$

The customer's business seller category code. PayPal uses industry standard seller category codes.

subcategory
required
string [ 1 .. 20 ] characters ^\d+$

The customer's business subcategory code. PayPal uses industry standard seller subcategory codes.

{
  • "category": "string",
  • "mcc_code": "string",
  • "subcategory": "string"
}

Business name

Name of the business provided.

business_name
string <= 300 characters

Required. The business name of the party.

type
required
string (The business name type.) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

The type of business name. For example, trading name.

Enum: Description
DOING_BUSINESS_AS

The trading name of the business.

LEGAL_NAME

The legal name of the business.

{
  • "business_name": "string",
  • "type": "DOING_BUSINESS_AS"
}

Business Name

The business name of the party.

business_name
string <= 300 characters

Required. The business name of the party.

{
  • "business_name": "string"
}

Business type

The business types classified

string (Business type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

The business types classified

Enum: Description
ANY_OTHER_BUSINESS_ENTITY

The any other business entity.

ASSOCIATION

The association.

CORPORATION

The corporation.

GENERAL_PARTNERSHIP

The general partnership.

GOVERNMENT

The government.

INDIVIDUAL

The individual.

LIMITED_LIABILITY_PARTNERSHIP

The limited liability partnership.

LIMITED_LIABILITY_PROPRIETORS

The limited liability proprietors.

LIMITED_LIABILITY_PRIVATE_CORPORATION

The limited liability private corporation.

LIMITED_PARTNERSHIP

The limited partnership.

LIMITED_PARTNERSHIP_PRIVATE_CORPORATION

The limited partnership private corporation.

NONPROFIT

The nonprofit.

ONLY_BUY_OR_SEND_MONEY

The only buy and send money.

OTHER_CORPORATE_BODY

The other corporate body.

PARTNERSHIP

The partnership.

PRIVATE_PARTNERSHIP

The private partnership.

PROPRIETORSHIP

The proprietorship.

PROPRIETORSHIP_CRAFTSMAN

The proprietorship craftsman.

PROPRIETORY_COMPANY

The proprietory company.

PRIVATE_CORPORATION

The private corporation.

PUBLIC_COMPANY

The public company.

PUBLIC_CORPORATION

The public corporation.

PUBLIC_PARTNERSHIP

The public partnership.

REGISTERED_COOPERATIVE

Registered Co-operative.

"ANY_OTHER_BUSINESS_ENTITY"

Business type information

The type and subtype of the business.

type
string (Business type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

Type of business entity like corporation, sole prop, governmental.

Enum: Description
ANY_OTHER_BUSINESS_ENTITY

The any other business entity.

ASSOCIATION

The association.

CORPORATION

The corporation.

GENERAL_PARTNERSHIP

The general partnership.

GOVERNMENT

The government.

INDIVIDUAL

The individual.

LIMITED_LIABILITY_PARTNERSHIP

The limited liability partnership.

LIMITED_LIABILITY_PROPRIETORS

The limited liability proprietors.

LIMITED_LIABILITY_PRIVATE_CORPORATION

The limited liability private corporation.

LIMITED_PARTNERSHIP

The limited partnership.

LIMITED_PARTNERSHIP_PRIVATE_CORPORATION

The limited partnership private corporation.

NONPROFIT

The nonprofit.

ONLY_BUY_OR_SEND_MONEY

The only buy and send money.

OTHER_CORPORATE_BODY

The other corporate body.

PARTNERSHIP

The partnership.

PRIVATE_PARTNERSHIP

The private partnership.

PROPRIETORSHIP

The proprietorship.

PROPRIETORSHIP_CRAFTSMAN

The proprietorship craftsman.

PROPRIETORY_COMPANY

The proprietory company.

PRIVATE_CORPORATION

The private corporation.

PUBLIC_COMPANY

The public company.

PUBLIC_CORPORATION

The public corporation.

PUBLIC_PARTNERSHIP

The public partnership.

REGISTERED_COOPERATIVE

Registered Co-operative.

subtype
string (The business sub type.) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

The sub classification of the business type.

Enum: Description
ASSO_TYPE_INCORPORATED

The asso type incorporated.

ASSO_TYPE_NON_INCORPORATED

The asso type non incorporated.

GOVT_TYPE_ENTITY

The govt type entity.

GOVT_TYPE_EMANATION

The govt type emanation.

GOVT_TYPE_ESTD_COMM

The govt type estd comm.

GOVT_TYPE_ESTD_FC

The govt type estd fc.

GOVT_TYPE_ESTD_ST_TR

The govt type estd st tr.

{
  • "type": "ANY_OTHER_BUSINESS_ENTITY",
  • "subtype": "ASSO_TYPE_INCORPORATED"
}

Business_address_detail

A simple postal address with coarse-grained fields.

address_line_1
string <= 300 characters

The first line of the address. For example, number or street. For example, 173 Drury Lane. Required for data entry and compliance and risk checks. Must contain the full address.

address_line_2
string <= 300 characters

The second line of the address. For example, suite or apartment number.

admin_area_2
string <= 120 characters

A city, town, or village. Smaller than admin_area_level_1.

admin_area_1
string <= 300 characters

The highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. Format for postal delivery. For example, CA and not California. Value, by country, is:

  • UK. A county.
  • US. A state.
  • Canada. A province.
  • Japan. A prefecture.
  • Switzerland. A kanton.

postal_code
string <= 60 characters

The postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent. See postal code.

country_code
required
string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$

The two-character ISO 3166-1 code that identifies the country or region.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

type
required
string (Business address type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

The address type under which this is classified. For example, shipping or dropoff.

Value: Description
WORK

The address of the business.

{
  • "address_line_1": "string",
  • "address_line_2": "string",
  • "admin_area_2": "string",
  • "admin_area_1": "string",
  • "postal_code": "string",
  • "country_code": "st",
  • "type": "WORK"
}

Business_beneficial_owner

The business beneficial owner of the account.

Array of objects (Business name) [ 0 .. 5 ] items

Name of the business.

Array of objects (Email of a person orbusiness) [ 0 .. 5 ] items

Email addresses of the business.

website
string <uri> [ 1 .. 50 ] characters

Website of the business.

Array of objects (Business_address_detail) [ 0 .. 5 ] items

List of addresses associated with the business entity.

Array of objects (Phone details) [ 0 .. 5 ] items

List of phone number associated with the business.

object (Business type information)

Information related to the business like the nature of business, started date etc.

object (Business industry)

Information related to the business like the nature of business, started date etc.

object (Business_incorporation)

Information related to the business like the nature of business, started date etc.

percentage_of_ownership
string <ppaas_common_percentage_v2> (percentage) ^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$

The percentage of shares this person owns in the company.

{
  • "names": [
    • {
      • "business_name": "string",
      • "type": "DOING_BUSINESS_AS"
      }
    ],
  • "emails": [
    • {
      • "type": "CUSTOMER_SERVICE",
      • "email": "string"
      }
    ],
  • "website": "http://example.com",
  • "addresses": [
    • {
      • "address_line_1": "string",
      • "address_line_2": "string",
      • "admin_area_2": "string",
      • "admin_area_1": "string",
      • "postal_code": "string",
      • "country_code": "st",
      • "type": "WORK"
      }
    ],
  • "phones": [
    • {
      • "country_code": "str",
      • "national_number": "string",
      • "extension_number": "string",
      • "type": "CUSTOMER_SERVICE"
      }
    ],
  • "business_type": {
    • "type": "ANY_OTHER_BUSINESS_ENTITY",
    • "subtype": "ASSO_TYPE_INCORPORATED"
    },
  • "business_industry": {
    • "category": "string",
    • "mcc_code": "string",
    • "subcategory": "string"
    },
  • "business_incorporation": {
    • "incorporation_country_code": "st",
    • "incorporation_date": "stringstri"
    },
  • "percentage_of_ownership": "string"
}

Business_entity

The business entity of the account.

Array of objects (Business name) [ 0 .. 5 ] items

Name of the business.

Array of objects (Email of a person orbusiness) [ 0 .. 5 ] items

Email addresses of the business.

website
string <uri> [ 1 .. 50 ] characters

Website of the business.

Array of objects (Business_address_detail) [ 0 .. 5 ] items

List of addresses associated with the business entity.

Array of objects (Phone details) [ 0 .. 5 ] items

List of phone number associated with the business.

Array of objects (Business document) [ 0 .. 20 ] items

Business Party related Document data collected from the customer.. For example SSN, ITIN, Business registration number that were collected from the user.

object (Business type information)

Information related to the business like the nature of business, started date etc.

object (Business industry)

Information related to the business like the nature of business, started date etc.

object (Business_incorporation)

Information related to the business like the nature of business, started date etc.

Array of objects (Office Bearers) [ 0 .. 5 ] items

List of Directors present as part of the business entity.

purpose_code
Array of strings (purpose_code)

The account's purpose code.

Items Enum: Description
P0104

Cross border delivery of goods and services.

P0301

Business related travel purchase.

P0801

Hardware consulting.

P0802

Software consulting.

P0803

Data processing consulting.

P0805

Freelance journalism.

P0806

Other information services.

P0902

Licensing revenues.

P1004

Legal.

P1005

Accounting and tax.

P1006

Business and management consultancy.

P1007

Advertising and market research.

P1008

Research and development.

P1009

Architectural services.

business_description
string [ 1 .. 256 ] characters

The business goals description. For example, a mission statement.

object (Beneficial_owners)

List of beneficial owners part of the entity. They can be either a Person or a business entity.

object (currency_range)

The range for the total annual sales volume of the business.

object (currency_range)

The range for the average monthly volume of the business.

{
  • "names": [
    • {
      • "business_name": "string",
      • "type": "DOING_BUSINESS_AS"
      }
    ],
  • "emails": [
    • {
      • "type": "CUSTOMER_SERVICE",
      • "email": "string"
      }
    ],
  • "website": "http://example.com",
  • "addresses": [
    • {
      • "address_line_1": "string",
      • "address_line_2": "string",
      • "admin_area_2": "string",
      • "admin_area_1": "string",
      • "postal_code": "string",
      • "country_code": "st",
      • "type": "WORK"
      }
    ],
  • "phones": [
    • {
      • "country_code": "str",
      • "national_number": "string",
      • "extension_number": "string",
      • "type": "CUSTOMER_SERVICE"
      }
    ],
  • "documents": [
    • {
      • "identification_number": "string",
      • "issuing_country_code": "string",
      • "type": "SOCIAL_SECURITY_NUMBER"
      }
    ],
  • "business_type": {
    • "type": "ANY_OTHER_BUSINESS_ENTITY",
    • "subtype": "ASSO_TYPE_INCORPORATED"
    },
  • "business_industry": {
    • "category": "string",
    • "mcc_code": "string",
    • "subcategory": "string"
    },
  • "business_incorporation": {
    • "incorporation_country_code": "st",
    • "incorporation_date": "stringstri"
    },
  • "office_bearers": [
    • {
      • "names": [
        • {
          • "prefix": "string",
          • "given_name": "string",
          • "surname": "string",
          • "middle_name": "string",
          • "suffix": "string",
          • "full_name": "string",
          • "type": "LEGAL"
          }
        ],
      • "addresses": [
        • {
          • "address_line_1": "string",
          • "address_line_2": "string",
          • "admin_area_2": "string",
          • "admin_area_1": "string",
          • "postal_code": "string",
          • "country_code": "st",
          • "type": "HOME"
          }
        ],
      • "phones": [
        • {
          • "country_code": "str",
          • "national_number": "string",
          • "extension_number": "string",
          • "type": "FAX"
          }
        ],
      • "documents": [
        • {
          • "identification_number": "string",
          • "issuing_country_code": "string",
          • "type": "SOCIAL_SECURITY_NUMBER"
          }
        ],
      • "citizenship": "st",
      • "birth_details": {
        • "date_of_birth": "stringstri"
        },
      • "role": "CEO"
      }
    ],
  • "purpose_code": [
    • "P0104"
    ],
  • "business_description": "string",
  • "beneficial_owners": {
    • "individual_beneficial_owners": [
      • {
        • "names": [
          • {
            • "prefix": "string",
            • "given_name": "string",
            • "surname": "string",
            • "middle_name": "string",
            • "suffix": "string",
            • "full_name": "string",
            • "type": "LEGAL"
            }
          ],
        • "addresses": [
          • {
            • "address_line_1": "string",
            • "address_line_2": "string",
            • "admin_area_2": "string",
            • "admin_area_1": "string",
            • "postal_code": "string",
            • "country_code": "st",
            • "type": "HOME"
            }
          ],
        • "phones": [
          • {
            • "country_code": "str",
            • "national_number": "string",
            • "extension_number": "string",
            • "type": "FAX"
            }
          ],
        • "citizenship": "st",
        • "birth_details": {
          • "date_of_birth": "stringstri"
          },
        • "percentage_of_ownership": "string"
        }
      ],
    • "business_beneficial_owners": [
      • {
        • "names": [
          • {
            • "business_name": "string",
            • "type": "DOING_BUSINESS_AS"
            }
          ],
        • "emails": [
          • {
            • "type": "CUSTOMER_SERVICE",
            • "email": "string"
            }
          ],
        • "website": "http://example.com",
        • "addresses": [
          • {
            • "address_line_1": "string",
            • "address_line_2": "string",
            • "admin_area_2": "string",
            • "admin_area_1": "string",
            • "postal_code": "string",
            • "country_code": "st",
            • "type": "WORK"
            }
          ],
        • "phones": [
          • {
            • "country_code": "str",
            • "national_number": "string",
            • "extension_number": "string",
            • "type": "CUSTOMER_SERVICE"
            }
          ],
        • "business_type": {
          • "type": "ANY_OTHER_BUSINESS_ENTITY",
          • "subtype": "ASSO_TYPE_INCORPORATED"
          },
        • "business_industry": {
          • "category": "string",
          • "mcc_code": "string",
          • "subcategory": "string"
          },
        • "business_incorporation": {
          • "incorporation_country_code": "st",
          • "incorporation_date": "stringstri"
          },
        • "percentage_of_ownership": "string"
        }
      ]
    },
  • "annual_sales_volume_range": {
    • "minimum_amount": {
      • "currency_code": "str",
      • "value": "string"
      },
    • "maximum_amount": {
      • "currency_code": "str",
      • "value": "string"
      }
    },
  • "average_monthly_volume_range": {
    • "minimum_amount": {
      • "currency_code": "str",
      • "value": "string"
      },
    • "maximum_amount": {
      • "currency_code": "str",
      • "value": "string"
      }
    }
}

Business_incorporation

Business incorporation information.

incorporation_country_code
string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$

The incorporation country code.

incorporation_date
string <ppaas_date_notime_v2> (date_no_time) = 10 characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|...

date of incorporation

{
  • "incorporation_country_code": "st",
  • "incorporation_date": "stringstri"
}

capability_name

Optional capabilities of the selected PayPal product for which the customer is being onboarded.

string (capability_name) [ 1 .. 127 ] characters ^[A-Z0-9_]+$

Optional capabilities of the selected PayPal product for which the customer is being onboarded.

Enum: Description
PAYPAL_WALLET_VAULTING_ADVANCED

Enables capability to save payment methods. Supported only when ADVANCED_VAULTING is requested and EXPRESS_CHECKOUT or PPCP is also requested.

PAY_UPON_INVOICE

Enables Pay Upon Invoice (PUI) which is a deferred payment method that allows a buyer to buy now and pay later. Supported only when PAYMENT_METHODS is requested.

APPLE_PAY

Enables Apple Pay capability. Supported only when PAYMENT_METHODS is requested.

"PAYPAL_WALLET_VAULTING_ADVANCED"

CLASSIC API integration

The integration details for PayPal CLASSIC endpoints.

object (CLASSIC API integration)

The integration details for PayPal CLASSIC endpoints.

{ }

country_code

The two-character ISO 3166-1 code that identifies the country or region.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$

The two-character ISO 3166-1 code that identifies the country or region.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

"st"

country_code_v4

The two-character ISO 3166-1 code that identifies the country or region.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

string <ppaas_common_country_code_v2> (country_code_v4) = 2 characters ^([A-Z]{2}|C2)$

The two-character ISO 3166-1 code that identifies the country or region.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

"st"

create_referral_data_response

The shared referral data.

Array of objects (Links) [ 2 .. 10 ] items

An array of request-related HATEOAS links.

{
  • "links": [
    • {
      • "href": "string",
      • "rel": "string",
      • "method": "GET"
      },
    • {
      • "href": "string",
      • "rel": "string",
      • "method": "GET"
      }
    ]
}

currency_code

The three-character ISO-4217 currency code that identifies the currency.

string <ppaas_common_currency_code_v2> (currency_code) = 3 characters

The three-character ISO-4217 currency code that identifies the currency.

"str"

currency_code_v4

The three-character ISO-4217 currency code that identifies the currency.

string <ppaas_common_currency_code_v2> (currency_code_v4) = 3 characters

The three-character ISO-4217 currency code that identifies the currency.

"str"

currency_range

The currency range, from the minimum inclusive amount to the maximum inclusive amount.

object (Money)

The minimum inclusive amount for the range.

object (Money)

The maximum inclusive amount for the range.

{
  • "minimum_amount": {
    • "currency_code": "str",
    • "value": "string"
    },
  • "maximum_amount": {
    • "currency_code": "str",
    • "value": "string"
    }
}

date_no_time

The stand-alone date, in Internet date and time format. To represent special legal values, such as a date of birth, you should use dates with no associated time or time-zone data. Whenever possible, use the standard date_time type. This regular expression does not validate all dates. For example, February 31 is valid and nothing is known about leap years.

string <ppaas_date_notime_v2> (date_no_time) = 10 characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|...

The stand-alone date, in Internet date and time format. To represent special legal values, such as a date of birth, you should use dates with no associated time or time-zone data. Whenever possible, use the standard date_time type. This regular expression does not validate all dates. For example, February 31 is valid and nothing is known about leap years.

"stringstri"

date_time

The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional.

Note: The regular expression provides guidance but does not reject all invalid dates.

string <ppaas_date_time_v3> (date_time) [ 20 .. 64 ] characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|...

The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional.

Note: The regular expression provides guidance but does not reject all invalid dates.

"stringstringstringst"

Document

The document object.

id
string [ 1 .. 20 ] characters ^[0-9A-Z]+$

The encrypted identifier for the document.

labels
Array of strings [ 1 .. 50 ] items

The document labels. A document could be classfied to multiple categories. For example, a bill document can be classfified as BILL DOCUMENT and UTILITY DOCUMENT.

name
string [ 1 .. 100 ] characters ^[0-9A-Za-z_-]+$

The file name.

identification_number
string [ 1 .. 100 ] characters ^[a-zA-Z0-9-]+$

The number for the document. It is the ID number if the document is ID CARD, the passport number if the document is PASSPORT, etc.

Array of objects (File Reference) [ 1 .. 50 ] items

The files contained in the document. For example, a document could be represented by a front page file and a back page file, etc.

Array of objects (Link Description) [ 1 .. 10 ] items

The HATEOAS links.

issue_date
string <ppaas_date_notime_v2> (date_no_time) = 10 characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|...

The stand-alone date, in Internet date and time format. To represent special legal values, such as a date of birth, you should use dates with no associated time or time-zone data. Whenever possible, use the standard date_time type. This regular expression does not validate all dates. For example, February 31 is valid and nothing is known about leap years.

expiry_date
string <ppaas_date_notime_v2> (date_no_time) = 10 characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|...

The stand-alone date, in Internet date and time format. To represent special legal values, such as a date of birth, you should use dates with no associated time or time-zone data. Whenever possible, use the standard date_time type. This regular expression does not validate all dates. For example, February 31 is valid and nothing is known about leap years.

issuing_country_code
string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$

The two-character ISO 3166-1 code that identifies the country or region.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the C2 country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

{
  • "id": "string",
  • "labels": [
    • "string"
    ],
  • "name": "string",
  • "identification_number": "string",
  • "files": [
    • {
      • "id": "string",
      • "reference_url": "http://example.com",
      • "content_type": "string",
      • "size": "string",
      • "create_time": "string"
      }
    ],
  • "links": [
    • {
      • "href": "string",
      • "rel": "string",
      • "method": "GET"
      }
    ],
  • "issue_date": "string",
  • "expiry_date": "string",
  • "issuing_country_code": "string"
}

Document type

The type of documents.

string (Document type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

The type of documents.

Enum: Description
SOCIAL_SECURITY_NUMBER

A social security number.

EMPLOYMENT_IDENTIFICATION_NUMBER

The employee identification number.

TAX_IDENTIFICATION_NUMBER

A tax identification number.

PASSPORT_NUMBER

The passport number.

PENSION_FUND_ID

A pension fund ID.

MEDICAL_INSURANCE_ID

The medical insurance ID.

CNPJ

The identification number issued to Brazilian companies by the Department of Federal Revenue of Brazil.

CPF

A Brazilian individual's taxpayer registry identification number.

PAN

The permanent account number issued by the Indian Income Tax Department.

"SOCIAL_SECURITY_NUMBER"

Document type

The type of documents.

string (Document type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$

The type of documents.

Enum: Description
SOCIAL_SECURITY_NUMBER

A social security number.

EMPLOYMENT_IDENTIFICATION_NUMBER

The employee identification number.

TAX_IDENTIFICATION_NUMBER

The tax identification number.

PASSPORT_NUMBER

A passport number.

PENSION_FUND_ID

A pension fund ID.

MEDICAL_INSURANCE_ID

A medical insurance ID.

CNPJ

The identification number issued to Brazilian companies by the Department of Federal Revenue of Brazil.

CPF

A Brazilian individual's taxpayer registry identification number.

PAN

The Permanent account number issued by the Indian Income Tax Department.

"SOCIAL_SECURITY_NUMBER"

Email of a person orbusiness

An email address at which the person or business can be contacted.

type
required
string [ 1 .. 50 ] characters ^[0-9A-Z_]+$

The role of the email address.

Value: Description
CUSTOMER_SERVICE

The email ID to be used to contact the customer service of the business.

email
required
string <ppaas_common_email_address_v2> (email_address_v4) [ 3 .. 254 ] characters ^.+@[^"\-].+$

The internationalized email address.

Note: Up to 64 characters are allowed before and 255 characters are allowed after the @ sign. However, the generally accepted maximum length for an email address is 254 characters. The pattern verifies that an unquoted @ sign exists.

{
  • "type": "CUSTOMER_SERVICE",
  • "email": "string"
}

email_address

The internationalized email address.