[tut] Setup API for Paypal Escrow

Updated on Aug 25, 2016 in FreelanceEngine
3 on Jun 25, 2016

I) Setup

Step 1: How to get PayPal App ID.

  1. Go to
  2. Log in with PayPal Account email and password
  3. Click the ‘Dashboard’ tab up top
  4. Click ‘My APPs & Credentials’
  5. Click ‘Create & Manage NVP/SOAP API apps link
  6. On the redirect to the classic developer portal, Login to PayPal account you want to apply for the APP ID with (don’t use a personal account)
  7. For Live APP IDs it takes between 24-48 hours; you should get notified when approved. If you don’t, contact business support. The number is in your paypal account / contact us section (pending status)
  8. For SandBox you’ll get the APP ID right away, regardless of how you applied; live or sandbox
  9. You should see the APP ID in the classic developer portal in the ‘manage your apps’ section.

Step 2: How to get “Paypal API”

Go to profile-> My selling tools, click the button “update” of the API Access like this image

In the next screen, Click in to the button “View API Signature” (if you have not created any api, just create new API signature)



1) The X-PAYPAL-APPLICATION-ID header contains an invalid value

Some reasons: You are using a sandbox APP ID or not set correctly the App ID of this email. Kindly follows step 1 to get the exact APP ID

2)  Authentication failed. API credentials are incorrect

Kindly follow step 2 to set correctly the API of the Escrow.

3)  User is not allowed to perform this action

+ The error is because your Adaptive Payment application is not approved for Chain Payments and you are trying to execute Chain Payments API.  Also It might be caused by the status of your APP is not approved(is pending or Approve conditionally). 

+ It is also possible when your business/premier account is not Verified.  in order to verify your account you must add a credit card or a bank account into your PayPal account.

+ For more detail, you can use the link at the end of this post to check your PayPal account status, upon getting the status of your paypal account, you can solve yourself or contact to PayPal to solve the problem. 

4)   Account Account not found. Unilateral receiver not allowed in chained payment is restricted

For Adaptive Chained Payments, all receivers must have an active and verified Personal, Premier or Business PayPal account.


Note: The application owner must have a PayPal Business account


  • Liked by
0 on Jul 29, 2016
  • Liked by
0 on Aug 5, 2016

5) Account account not found. unilateral receiver not allowed in chained payment is restricted


Note: Please make sure the paypal email of freelancer is not empty


 5.1) That is usually caused by receiver’s email address that is unconfirmed. Please make sure the freelancer’s email is verified.( For chained payments receivers do NOT need Premier or Business PayPal accounts. They just need an active/verified PayPal account.). Also, please make sure the freelancer account is using a live paypal account(not sandbox).

6) Internal Error : You did not set APP ID in API section.


  • Liked by
0 on Aug 25, 2016

If you are using sandbox mode. Kindly use this APP ID


To get API for sandbox testing mode. Kindly log into 

then go to profile->My Selling tool ->API like this image 

Hope this helps!

  • Liked by
Loading more replies
Posting & Replying function will be deactivated from 3pm GMT+7 12th Sep.
Read More