Supported Formats, URLs and HTTP Request Headers

Important: Adaptive Accounts is now a limited release product. It is restricted to select partners for approved use cases and should not be used for new integrations without guidance from PayPal.

Adaptive Accounts Methods

Adaptive Accounts provides the following methods:

API Operation Description
CreateAccount Creates PayPal accounts.
AddBankAccount Link bank accounts to PayPal accounts as funding sources.
AddPaymentCard Link payment cards to PayPal accounts as funding sources
SetFundingSourceConfirmed Set the funding source to confirmed; they may set the account to PayPal Verified status.
GetVerifiedStatus Verify PayPal accounts by matching account holder criteria such as the account holder's email address.

Adaptive Accounts URLs

The endpoint is determined by the method and the environment in which you want to execute the API operation. For example, if you want to send a CreateAccount request to the sandbox, specify the following URL:

You can specify the following URLs:

Environment Endpoint

Supported Formats

Adaptive Accounts supports both SOAP-based web services and web APIs in JSON, XML, and Name-value (NV) pair formats.

HTTP Request Headers

Table 1. Required HTTP Request Headers
Header Description
X-PAYPAL-SECURITY-SIGNATURE Your API signature. This header is only required if you use 3-token authorization. Do not pass this header if you use a certificate. To manage API certificates, see Creating and Managing NVP/SOAP API Credentials.
X-PAYPAL-APPLICATION-ID Your application's identification.
X-PAYPAL-DEVICE-IPADDRESS The IP address of the caller. This header is required for CreateAccount requests.
X-PAYPAL-REQUEST-DATA-FORMAT The payload format for the request.
Allowable values are:
  • NV — Name-value pairs
  • XML — Extensible markup language
  • JSON — JavaScript object notation
X-PAYPAL-RESPONSE-DATA-FORMAT The payload format for the response.
Allowable values are:
  • NV — Name-value pairs
  • XML — Extensible markup language
  • JSON — JavaScript object notation

Table 2. Optional HTTP Request Headers
Header Description
X-PAYPAL-SANDBOX-EMAIL-ADDRESS The email address that the API caller uses to log into the Sandbox (this is not required outside of the Sandbox).
X-PAYPAL-DEVICE-ID Client's device ID, such as a mobile device's IMEI number. This field is required for mobile application and is not used for web application.
X-PAYPAL-MERCHANT-REFERRAL-BONUS-ID When creating a Business or Premier account, this header enables the Merchant Referral Bonus invitation.
X-PAYPAL-SERVICE-VERSION The version of an API operation to use. By default, PayPal executes a request with the current version of an API operation.
Note: PayPal recommends not specifying a version unless it is absolutely required.