{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","admonition","tabs","tab","required","optional"]},"type":"markdown"},"seo":{"title":"How it works","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":"how-it-works","__idx":0},"children":["How it works"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn about PXP's PayPal payout components for iOS."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal payouts enable you to easily send money to your users' PayPal accounts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With the PayPal payout components, you can benefit from:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Flexible payout execution:"]}," Choose between SDK-managed payouts for simplicity or backend-managed payouts for custom workflows."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secure credential management:"]}," PayPal account credentials are securely stored on your backend and provided to the SDK at initialisation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customisable approval flows:"]}," Implement custom merchant approval logic before payout execution."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Native iOS integration:"]}," Built with SwiftUI for modern iOS app development with proper lifecycle management."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Real-time status updates:"]}," Receive immediate confirmation when payouts complete successfully."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read-only display components:"]}," Show users their payout amount and destination email with optional masking for privacy."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal payouts require a verified PayPal Business account. Recipients must have a PayPal account to receive funds, though PayPal will send an invitation if they don't have one."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-cases","__idx":2},"children":["Use cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The PayPal payout components enable various business scenarios where you need to send money to users:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Gig economy and marketplaces:"]}," Pay freelancers, drivers, delivery personnel, or sellers for completed work or sales."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rewards and loyalty programmes:"]}," Distribute cashback, loyalty points converted to cash, or promotional rewards."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refunds:"]}," Return money to customers for returned items, cancelled services, or dispute resolutions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Affiliate commissions:"]}," Pay partners, influencers, or affiliates for referrals and sales."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contests and sweepstakes:"]}," Distribute prize money to winners of contests, tournaments, or raffles."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Revenue sharing:"]}," Split payments among multiple parties in revenue-sharing arrangements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expense reimbursements:"]}," Reimburse employees or contractors for business expenses."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-credentials-are-provided","__idx":3},"children":["How credentials are provided"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal payout credentials (email and payer ID) must be collected and stored by your backend system. The iOS SDK receives these credentials at initialisation time and uses them to display payout information and execute transactions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your backend is responsible for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Collecting PayPal account information from users through your own UI or processes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Securely storing the email address and payer ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Providing these credentials to the iOS app when initialising the SDK."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both the email and the payer ID are required to create the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutSubmissionComponent"]},". If either is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nil"]},", the SDK throws ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaypalPayoutReceiverRequiredException"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0803"]},"). If the payer ID is empty, it throws ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutPayerIdRequiredException"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0809"]},"). The submission component reads the amount and currency from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]}," and the wallet from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypalConfig"]},". It doesn't take values from the amount or receiver components."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payer ID is a unique identifier for a PayPal account. You can get this through your backend integration with PayPal's APIs or by having users provide their PayPal account details through your own account management system."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payout-flows","__idx":4},"children":["Payout flows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The PayPal payout components support two execution modes, allowing you to choose the approach that fits your business requirements:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SDK-managed payouts:"]}," A streamlined flow where the SDK handles payout execution after merchant approval. Best for simple implementations with minimal backend logic."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Backend-managed payouts:"]}," A flexible flow where your backend controls payout execution. Use this when you need custom business logic, compliance checks, or complex workflows."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"SDK-managed payouts","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK-managed flow works as follows."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your backend provides PayPal credentials (email and payer ID) to the iOS app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The user initiates a payout request in your app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SDK triggers ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPrePayoutSubmit"]}," callback for merchant approval."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Merchant shows approval dialog and returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PrePayoutSubmitResult(isApproved: true)"]}," to proceed, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nil"]}," to cancel."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SDK executes payout transaction via Unity API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SDK triggers ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostPayout"]}," callback with transaction details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The funds are transferred to the user's PayPal account."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example configures the SDK to manage the payout."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"let paypalConfig = PayPalConfig(\n    payout: PayPalPayoutConfig(\n        paypalWallet: PayPalWallet(\n            email: \"user@example.com\",     // From your backend\n            payerId: \"PAYERID123ABC\",      // From your backend\n            proceedPayoutWithSdk: true     // SDK manages payout\n        )\n    )\n)\n","lang":"swift"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Backend-managed payouts","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The backend-managed flow works as follows."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your backend provides PayPal credentials (email and payer ID) to the iOS app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User initiates payout request in your app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The SDK calls ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onClick"]},", and your app notifies the backend to execute the payout."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Backend applies business logic and compliance checks."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Backend executes payout via Unity API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Backend notifies iOS app of payout status."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example configures your backend to manage the payout."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"let paypalConfig = PayPalConfig(\n    payout: PayPalPayoutConfig(\n        paypalWallet: PayPalWallet(\n            email: \"user@example.com\",      // From your backend\n            payerId: \"PAYERID123ABC\",       // From your backend\n            proceedPayoutWithSdk: false     // Backend manages payout\n        )\n    )\n)\n","lang":"swift"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With backend-managed payouts, only the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onClick"]}," callback runs. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPrePayoutSubmit"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPostPayout"]}," callbacks aren't triggered because the SDK doesn't execute the payout. Notify your backend from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onClick"]},". Your backend handles the entire payout execution flow."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transaction-data","__idx":5},"children":["Transaction data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you initiate a payout transaction, you must provide key information in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]}," object:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["amount"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["currency"]}," of the payout."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["entry type"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EntryType"]},"), which describes the origin of the transaction. For payouts, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".ecom"]}," for e-commerce transactions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["intent"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayPalIntentType"]},"), which must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".payout"]}," for payout transactions. This indicates that money flows from you to the user."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant transaction identifier"]}," of your choosing, which uniquely identifies this specific payout."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant transaction date"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example sets each of these values for a payout."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"let transactionData = TransactionData(\n    amount: Decimal(100.00),\n    currency: \"USD\",\n    entryType: .ecom,\n    intent: TransactionIntentData(\n        card: nil,\n        paypal: .payout  // Set the payout intent for payout integrations\n    ),\n    merchantTransactionId: \"payout-\\(UUID().uuidString)\",\n    merchantTransactionDate: { Date() }\n)\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal payouts use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayPalIntentType.payout"]}," intent. It transfers funds from your PayPal Business account to the recipient's PayPal account. For payout integrations, set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypal: .payout"]}," in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TransactionIntentData"]}," of your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CheckoutConfig"]},". The other intents (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".authorisation"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".purchase"]},") are for receiving payments, not sending payouts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-components","__idx":6},"children":["Available components"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal payouts for iOS provides display and submission components for users with stored PayPal credentials:"]},{"$$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":"Component"},"children":["Component"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$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":["PayoutAmountComponent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".payoutAmount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Displays the payout amount (read-only)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayPalPayoutReceiverComponent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".paypalPayoutReceiver"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Displays the recipient email with optional masking. Configure with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayPalPayoutReceiverComponentConfig"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applyMask"]}," (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},") to mask email as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["j***@****.com"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["showMaskToggle"]}," (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},") to show or hide the toggle button, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receiverType"]}," (must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".email"]},"). The toggle is visible only when both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applyMask"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["showMaskToggle"]}," are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutSubmissionComponent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".payoutSubmission"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit button to execute the payout."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For detailed configuration of payout components, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/components/ios/paypal/withdrawal-flow"},"children":["Withdrawal flow"]}," guide."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"implementation-example","__idx":7},"children":["Implementation example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's a complete example showing how to implement PayPal payouts with stored credentials:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"// Configure with stored credentials from your backend\nlet paypalConfig = PayPalConfig(\n    payout: PayPalPayoutConfig(\n        paypalWallet: PayPalWallet(\n            email: \"user@example.com\",      // From your backend\n            payerId: \"PAYERID123ABC\",       // From your backend\n            proceedPayoutWithSdk: true\n        )\n    )\n)\n\nlet pxpCheckout = try PxpCheckout.initialize(config: checkoutConfig)\n\n// Create amount display component\nlet amountConfig = PayoutAmountComponentConfig(\n    label: \"Payout Amount\"\n)\nlet amountComponent = try pxpCheckout.create(.payoutAmount, componentConfig: amountConfig)\n\n// Create receiver display component\nlet receiverConfig = PayPalPayoutReceiverComponentConfig(\n    label: \"PayPal Account\",\n    applyMask: true,\n    showMaskToggle: true\n)\nlet receiverComponent = try pxpCheckout.create(.paypalPayoutReceiver, componentConfig: receiverConfig)\n\n// Create submission component\nlet submissionConfig = PayoutSubmissionComponentConfig(\n    submitText: \"Withdraw to PayPal\",\n    \n    onClick: {\n        print(\"Withdraw button clicked\")\n    },\n    \n    onPrePayoutSubmit: {\n        let approved = await showApprovalDialog()\n        guard approved else { return nil }\n        return PrePayoutSubmitResult(isApproved: true)\n    },\n    \n    onPostPayout: { result in\n        print(\"Payout completed: \\(result.merchantTransactionId)\")\n    },\n    \n    onError: { error in\n        guard let error = error as? BaseSdkException else { return }\n        print(\"Error: \\(error.errorMessage)\")\n    }\n)\nlet submissionComponent = try pxpCheckout.create(.payoutSubmission, componentConfig: submissionConfig)\n\n// Render in SwiftUI\nVStack(spacing: 16) {\n    amountComponent.buildContent()\n    receiverComponent.buildContent()\n    submissionComponent.buildContent()\n}\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transaction-limits-and-fees","__idx":8},"children":["Transaction limits and fees"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"limits","__idx":9},"children":["Limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal has the following limits on payout transactions:"]},{"$$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":"Limit type"},"children":["Limit type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Minimum amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["$1.00 USD (varies by currency)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Maximum single payout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["$60,000 USD (varies by account status)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Daily limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Varies based on account verification level."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer ID length"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum 13 characters."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Receiver email length"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum 127 characters."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact your PayPal account manager to increase limits for high-volume payout operations."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"processing-time","__idx":10},"children":["Processing time"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Processing times depend on the type of payout and the recipient:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standard payouts:"]}," Typically within minutes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["International payouts:"]}," May take 1-3 business days."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New recipients:"]}," First payout may take longer due to fraud checks."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fees","__idx":11},"children":["Fees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal charges fees for payouts. Check your PayPal Business account for current rates:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Domestic payouts: ~2% (varies by country)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["International payouts: Higher fees apply."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Volume discounts may be available."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"security-considerations","__idx":12},"children":["Security considerations"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"credential-management","__idx":13},"children":["Credential management"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow these practices when you handle PayPal credentials:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Backend storage only:"]}," PayPal email addresses and payer IDs must be securely stored on your backend."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use HTTPS:"]}," All backend API calls must use HTTPS with valid SSL certificates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secure transmission:"]}," When providing credentials to the iOS app, use secure API calls over HTTPS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validate credentials:"]}," Verify email and payer ID formats before storing and transmitting."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payout-validation","__idx":14},"children":["Payout validation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Apply these checks before you process a payout:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validate payer ID:"]}," Always validate the payer ID format (max 13 characters, alphanumeric)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify amounts:"]}," Ensure payout amounts are positive, valid numbers before processing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Implement rate limiting:"]}," Protect against abuse by limiting payout frequency per user."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Audit logging:"]}," Log all payout attempts, successes, and failures for compliance and debugging."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-codes","__idx":15},"children":["Error codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK performs extensive validation and provides specific error codes to help you handle different failure scenarios. All validation exceptions extend ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BaseSdkException"]},". They're thrown by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pxpCheckout.create"]},", so catch them with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["try-catch"]},". They aren't delivered to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," callback, which is for failures during payout execution."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"amount-validation-errors","__idx":16},"children":["Amount validation errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table lists the errors thrown for an invalid payout amount."]},{"$$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"},"children":["Error"]},{"$$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":["PayoutAmountInvalidException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount is NaN (Not a Number) or infinite."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutAmountNotPositiveException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount is zero or negative. Payouts must be positive values."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"currency-validation-errors","__idx":17},"children":["Currency validation errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table lists the errors thrown for an invalid currency code."]},{"$$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"},"children":["Error"]},{"$$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":["PayoutCurrencyRequiredException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency code is empty or missing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutCurrencyLengthInvalidException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency code is not exactly 3 characters (ISO 4217 format)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutCurrencyCodeInvalidException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency code is not a valid ISO 4217 code."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"receiver-validation-errors","__idx":18},"children":["Receiver validation errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table lists the errors thrown for an invalid receiver."]},{"$$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"},"children":["Error"]},{"$$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":["PaypalPayoutReceiverRequiredException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver email is empty or missing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaypalPayoutEmailInvalidException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email address format is invalid."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutEmailMaxLengthException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email address exceeds 127 characters."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaypalPayoutReceiverTypeEmailOnlyException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver type is not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".email"]}," (only email is currently supported)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payer-id-validation-errors","__idx":19},"children":["Payer ID validation errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table lists the errors thrown for an invalid payer ID."]},{"$$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"},"children":["Error"]},{"$$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":["PayoutPayerIdMaxLengthException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payer ID exceeds 13 characters."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutPayerIdInvalidException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payer ID contains non-alphanumeric characters. Only letters and numbers are allowed."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"error-handling-example","__idx":20},"children":["Error handling example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example catches the validation errors that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pxpCheckout.create"]}," throws and shows a message for each error type."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"swift","header":{"controls":{"copy":{}}},"source":"do {\n    let amountComponent = try pxpCheckout.create(\n        .payoutAmount,\n        componentConfig: PayoutAmountComponentConfig(label: \"Payout Amount\")\n    )\n    let submissionComponent = try pxpCheckout.create(\n        .payoutSubmission,\n        componentConfig: PayoutSubmissionComponentConfig(submitText: \"Withdraw to PayPal\")\n    )\n} catch {\n    // Handle specific error types\n    switch error {\n    case is PayoutAmountNotPositiveException:\n        showError(\"Payout amount must be greater than zero\")\n    case is PayoutEmailMaxLengthException:\n        showError(\"Email address is too long (max 127 characters)\")\n    case is PayoutPayerIdMaxLengthException:\n        showError(\"Payer ID is too long (max 13 characters)\")\n    case is PaypalPayoutEmailInvalidException:\n        showError(\"Please enter a valid email address\")\n    default:\n        showError(\"An error occurred: \\(error.localizedDescription)\")\n    }\n}\n","lang":"swift"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a payout fails during execution, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," callback receives a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutFailedException"]},". Its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorMessage"]}," contain the code and reason returned by the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"compliance","__idx":21},"children":["Compliance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you offer PayPal payouts, you must meet PayPal branding and behaviour requirements, and you remain responsible for financial, privacy, and security obligations in your markets."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"branding-and-appearance","__idx":22},"children":["Branding and appearance"]},{"$$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":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requirement"},"children":["Requirement"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Logos"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal logos and acceptance marks are displayed in parity with other payout options anywhere the payout method is presented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Logos"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal logos are taken from ",{"$$mdtype":"Tag","name":"a","attributes":{"target":"_blank","href":"https://www.paypal.com/uk/webapps/mpp/logo-center"},"children":["official sources"]}," and aren't modified."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Branding"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The correct capitalisation and spelling of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayPal"]}," is always used in both text and images (instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Paypal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Pay Pal"]},", and similar variants)."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accessibility"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The app supports Dynamic Type for text scaling to accommodate users with visual impairments."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Optional","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accessibility"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VoiceOver is fully supported with appropriate accessibility labels on all interactive elements."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Optional","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buttons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal payout buttons are presented with equal prominence and close proximity to other withdrawal methods."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buttons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal payout buttons are placed above other payout options."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buttons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The PayPal button is sized in parity with other payout buttons or otherwise in keeping with other elements in the app. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"target":"_blank","href":"https://developer.paypal.com/docs/business/checkout/reference/style-guide/"},"children":["PayPal style guide"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"behaviour","__idx":23},"children":["Behaviour"]},{"$$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":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requirement"},"children":["Requirement"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fees"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You don't add any additional surcharge or fee for PayPal payout transactions beyond what PayPal charges."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer journey"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Selecting the PayPal payout method allows the user to provide their PayPal account details and proceed with the payout without deviations or intermediate steps."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payout methods"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If payout methods can be stored or set as a preference, PayPal can also be stored or set as the preferred payout method."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payout methods"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For the customer's first payout, no payout method should be preselected by default. For subsequent payouts, the customer's previously used payout method may be preselected."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Optional","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payout methods"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When a payout method is selected, any fields specific to other payout methods are hidden. For example, bank details hidden when PayPal is selected."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Optional","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal account data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal account information (email or phone) collected from users is transmitted securely to the backend and handled according to data protection regulations."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer isn't required to create or log into a store or application account to receive a payout."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Optional","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirmation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After the payout initiation, the user sees a confirmation screen indicating the payout status; PayPal details or logos are presented in parity with other payout methods."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Credential management"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API credentials are managed securely on the backend and never exposed to the iOS client."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiver validation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal email is validated before submission where possible; PayPal error responses are surfaced to the user with guidance to correct details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"your-regulatory-responsibilities","__idx":24},"children":["Your regulatory responsibilities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You own KYC, AML, transaction limits, data protection, consent, and record-keeping for your integration. Before you go live, confirm at least the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer identity verification where your market requires it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AML monitoring and payout limits appropriate to your risk policy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Secure handling of personal and financial data, including encryption in transit (TLS 1.2 or higher) and at rest for any stored wallet identifiers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inbound API credentials (token ID and token value) kept on your backend only — never embed them in the iOS app."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clear customer consent for payout terms and privacy where required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Audit logging for payout initiation, approval, success, and failure."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Country-specific regulatory requirements for the markets you serve."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Legal and security review of your payout flows."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Store only the wallet identifiers you need for returning customers, such as the PayPal payer ID. Don't keep unnecessary sensitive personal data on the device."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"whats-next","__idx":25},"children":["What's next?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ready to implement PayPal payouts? Follow these guides in order:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/components/ios/installation"},"children":["Installation"]},":"]}," Set up the iOS SDK in your project."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/components/ios/paypal/onboarding"},"children":["PayPal onboarding"]},":"]}," Configure your PayPal Developer account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/components/ios/paypal/withdrawal-flow"},"children":["Withdrawal flow"]},":"]}," Implement payout components with stored credentials."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/components/ios/paypal/testing"},"children":["Testing"]},":"]}," Test your payout integration in sandbox mode."]}]}]},"headings":[{"value":"How it works","id":"how-it-works","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Use cases","id":"use-cases","depth":2},{"value":"How credentials are provided","id":"how-credentials-are-provided","depth":2},{"value":"Payout flows","id":"payout-flows","depth":2},{"value":"Transaction data","id":"transaction-data","depth":2},{"value":"Available components","id":"available-components","depth":2},{"value":"Implementation example","id":"implementation-example","depth":2},{"value":"Transaction limits and fees","id":"transaction-limits-and-fees","depth":2},{"value":"Limits","id":"limits","depth":3},{"value":"Processing time","id":"processing-time","depth":3},{"value":"Fees","id":"fees","depth":3},{"value":"Security considerations","id":"security-considerations","depth":2},{"value":"Credential management","id":"credential-management","depth":3},{"value":"Payout validation","id":"payout-validation","depth":3},{"value":"Error codes","id":"error-codes","depth":2},{"value":"Amount validation errors","id":"amount-validation-errors","depth":3},{"value":"Currency validation errors","id":"currency-validation-errors","depth":3},{"value":"Receiver validation errors","id":"receiver-validation-errors","depth":3},{"value":"Payer ID validation errors","id":"payer-id-validation-errors","depth":3},{"value":"Error handling example","id":"error-handling-example","depth":3},{"value":"Compliance","id":"compliance","depth":2},{"value":"Branding and appearance","id":"branding-and-appearance","depth":3},{"value":"Behaviour","id":"behaviour","depth":3},{"value":"Your regulatory responsibilities","id":"your-regulatory-responsibilities","depth":3},{"value":"What's next?","id":"whats-next","depth":2}],"frontmatter":{"seo":{"title":"How it works"}},"lastModified":"2026-11-11T13:23:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/components/ios/paypal/how-it-works","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}