If an error occurs with integrating PayPal in your website or when you submit a PayPal payment, try troubleshooting the problem using the information provided here. For some common errors, we explain what they mean and how to fix them.<\/p>\n
This troubleshooting information applies to Web Drop-in and Web Components integrations using the \/payments<\/a> endpoint.<\/p>\n<\/div><\/div>\n When the shopper selects the PayPal<\/strong><\/span> button, the PayPal window loads with a spinning wheel but nothing updates. When this happens, the browser console doesn't always show a warning or error that indicates the PayPal SDK is not properly initialized.<\/p>\n The PayPal window is initialized as soon as the shopper selects the PayPal<\/strong><\/span> button, in the After the customer has completed the necessary steps in the PayPal window and selects the Pay<\/strong><\/span> button, the window closes. A message appears indicating that the payment is being processed, but the payment is not actually completed.<\/p>\n This behavior indicates that you haven't made the \/payments\/details<\/a> request. Because the PayPal This issue occurs when you try implement a single payment button for all payment methods including PayPal. You are trying to hide the PayPal button by setting The Pay<\/strong><\/span> button for PayPal is the \"PayPal smart button\". This makes a direct call to the PayPal library, to retrieve information about your PayPal account before processing the payment. This means that PayPal requires their button to be somewhere on the page to handle the payment, because there is no alternative method for you to retrieve your shopper's PayPal account information.<\/p>\n We recommend testing PayPal transactions with the browser console open, and check for any errors reported in the console. The next sections discuss some of those errors. Note that if an error appears in the console, the transaction remains an open offer.<\/p>\n This error occurs when you are using the \/payments<\/a> endpoint and are not passing the currency code in the initialization of the Web Drop-in or Component. The Check if the This error indicates there is a mismatch between the For Web Drop-in v3.13.0 or earlier<\/a>, the This error occurs when the wrong PayPal Merchant ID is configured in the payment method settings.<\/p>\n Check your PayPal Merchant ID as configured in the payment method settings and contact our Support Team<\/a> to verify if the same PayPal Merchant ID is set up on your account.<\/p>\nPayPal overlay keeps loading<\/h2>\n
What it means<\/h4>\n
How to troubleshoot<\/h4>\n
onSubmit<\/code> event handler. However, the window is not updated until the action<\/code> object from the \/payments<\/a> response is passed to the Drop-in or Component. If the PayPal overlay is stuck loading, check that you pass the full response.action<\/code> object from your server to the Drop-in or Component.<\/p>\nStuck on \"Processing Payment\"<\/h2>\n
What it means<\/h4>\n
How to troubleshoot<\/h4>\n
action.type<\/code> is sdk<\/strong><\/span>, you need to configure onAdditionalDetails<\/code> for the PayPal Drop-in or Component. The onAdditionalDetails<\/code> event handler must trigger a \/payments\/details<\/a> request, passing the state.data<\/code> from onAdditionalDetails<\/code>.<\/p>\nCustom payment button doesn't work<\/h2>\n
What it means<\/h4>\n
showPayButton<\/code> to false<\/strong><\/span>. However, using a custom button to submit PayPal transactions is not possible.<\/p>\nHow to troubleshoot<\/h4>\n
Console errors<\/h2>\n
Expected currency from order api call to be USD, got EUR. Please ensure you are passing currency=EUR to the sdk url.<\/h3>\n
What it means<\/h4>\n
amount<\/code> object must include a currency<\/code>. For example:<\/p>\n{\n ...\n amount: {\n currency: \"EUR\",\n value: 1000\n }\n ...\n}<\/code><\/pre>\nHow to troubleshoot<\/h4>\n
paymentMethodsConfiguration<\/code> object of the Web Drop-in or Component has the same amount.currency<\/code> as the actual \/payments<\/code> request.<\/p>\nError: Expected intent from order api call to be capture, got authorize. Please ensure you are passing intent=authorize to the sdk url.<\/h3>\n
What it means<\/h4>\n
intent<\/code> set in the payment method configuration and the intent<\/code> passed to PayPal's SDK.<\/p>\nHow to troubleshoot<\/h4>\n
intent<\/code> must be passed dynamically from the payment method configuration. Make sure that you are not overwriting this setting by passing the wrong intent<\/code> value in the paypalConfiguration<\/code> object. Also ensure that the paymentMethodsResponse<\/code> contains the paypalConfiguration<\/code> with the intent<\/code> that corresponds with the authorisation type that is configured for your merchant account.<\/p>\nPayee(s) passed in transaction does not match expected merchant id. Please ensure you are passing merchant-id=XXXXXXXXXXXXX or merchant-id=XXXXXXXXXXXX@XXXX.com to the sdk url.<\/h3>\n
What it means<\/h4>\n
How to troubleshoot<\/h4>\n
See also<\/h2>\n