{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","admonition"]},"type":"markdown"},"seo":{"title":"Error handling","description":"Transform your commerce with PXP's unified platform—seamless payments, real-time insights, and global growth in one powerful integration.","lang":"en-UK","siteUrl":"https://developer.pxp.io"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"error-handling","__idx":0},"children":["Error handling"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Handle payout component errors in the Web SDK."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payout components on Web report errors as an error code (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDKXXXX"]},") and a descriptive message. Configuration and wallet validation failures are thrown when you create a component. Runtime failures during SDK-initiated payout execution are delivered through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Catch create-time errors around ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]},". Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," on the submission component for failures after the customer submits a payout. For field-level rules and examples, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/components/web/paypal/data-validation"},"children":["Data validation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-errors-are-raised","__idx":2},"children":["When errors are raised"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table summarises where payout errors appear."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Stage"},"children":["Stage"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"How you receive the error"},"children":["How you receive the error"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Component creation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Thrown from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]},". For example, missing wallet fields, invalid amount, or invalid currency."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SDK-initiated payout execution"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivered to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," on the payout submission component."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-codes","__idx":3},"children":["Error codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following tables list payout-related codes from the Web SDK."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"common-and-sdk-configuration","__idx":4},"children":["Common and SDK configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error code"},"children":["Error code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unexpected error."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0001"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not implemented."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0100"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing SDK config."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0101"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing SDK config: environment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0102"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing SDK config: session data."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0103"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing SDK config: session ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0104"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing SDK config: session HMAC key."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0106"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Intent type does not support the requested component."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0108"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal is missing from allowed funding types."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0112"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal intent type is required for the component but was not provided."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0200"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Component name must not be empty."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0201"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Container element with the given ID was not found."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0500"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Network error."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0501"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validation error."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"paypal-payout-validation","__idx":5},"children":["PayPal payout validation"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error code"},"children":["Error code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0803"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver value is required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0804"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid receiver type. Valid values are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaypalId"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UserHandle"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0805"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver type must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0806"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid wallet value. Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Paypal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0807"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver type must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]}," when the wallet is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Paypal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0808"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid email format for the receiver."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0809"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal payer ID is required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0810"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount must be a valid number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0811"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount must be a positive number greater than 0."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0812"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount is required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0813"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency code must be a non-empty string."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0814"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency code must be a 3-letter ISO 4217 currency code."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0815"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid currency code."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0816"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver type is required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0818"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A PayPal payout field exceeds its maximum length."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"venmo-payout-validation","__idx":6},"children":["Venmo payout validation"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error code"},"children":["Error code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0900"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Venmo wallet is required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0901"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver value is required for Venmo."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0902"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Venmo recipient type is required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0903"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid Venmo recipient type. Valid values are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UserHandle"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0904"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid phone format for the Venmo receiver. Use numeric characters only."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0905"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Venmo only supports USD currency."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payout-submission-configuration","__idx":7},"children":["Payout submission configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error code"},"children":["Error code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal configuration is required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1001"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient wallet is required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1002"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver and recipient type are required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1003"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unsupported recipient wallet. Valid values are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Paypal"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Venmo"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Notes longer than 4000 characters are truncated with a console warning. The submission path does not throw ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1004"]}," for an over-long note. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note"]}," field is included with Venmo payouts only."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example","__idx":8},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example catches create-time errors and handles runtime failures in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"try {\n  const submitComponent = pxpCheckoutSdk.create(\"payout-submission\", {\n    recipientWallet: \"Paypal\",\n    onError: (error) => {\n      console.error(\"Payout error:\", error.ErrorCode, error.message);\n      showErrorMessage(error.message);\n    },\n  });\n} catch (error) {\n  console.error(\"Create failed:\", error.ErrorCode, error.message);\n  showErrorMessage(error.message);\n}\n","lang":"typescript"},"children":[]}]},"headings":[{"value":"Error handling","id":"error-handling","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"When errors are raised","id":"when-errors-are-raised","depth":2},{"value":"Error codes","id":"error-codes","depth":2},{"value":"Common and SDK configuration","id":"common-and-sdk-configuration","depth":3},{"value":"PayPal payout validation","id":"paypal-payout-validation","depth":3},{"value":"Venmo payout validation","id":"venmo-payout-validation","depth":3},{"value":"Payout submission configuration","id":"payout-submission-configuration","depth":3},{"value":"Example","id":"example","depth":2}],"frontmatter":{"seo":{"title":"Error handling"}},"lastModified":"2026-11-11T13:23:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/components/web/paypal/error-handling","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}