PayPal Payment Gateway Integration in Nepal

A pashmina exporter in Kathmandu with fifteen years of wholesale experience and a catalogue of 240 shawl variants had built a beautiful e-commerce website - professional photography, clear product descriptions, accurate shipping costs by destination country. The site attracted European and North American buyers through Google search. Buyers added products to the cart. And then, at the payment step, they left. The checkout offered only a bank wire transfer to a Nepal account. The instructions on the payment page ran to three paragraphs explaining SWIFT codes, correspondent banks, and the Nepal Rastra Bank fee schedule for incoming international transfers. Buyers who had spent twenty minutes selecting pashmina shawls worth USD 300 were being asked to execute an international bank wire to a country and an institution they had never transacted with before. The conversion rate was 2.1 percent. The exporter knew this was a payment trust problem more than a product problem. After integrating PayPal as the primary international checkout method, the conversion rate on the same traffic reached 11.4 percent within sixty days. The product had not changed. The trust barrier at checkout had been replaced by a payment method buyers trusted completely.

PayPal is the most widely recognised and trusted online payment platform among international buyers in Europe, North America, Australia, Japan, and the Gulf countries - the primary markets from which Nepal's tourism, handicraft, diaspora remittance, and export businesses receive international revenue. PayPal accounts are held by more than 400 million users globally. A buyer from Germany, the United States, or the United Kingdom who encounters a PayPal checkout button on a Nepal business website is completing a transaction with a platform they have used hundreds of times before, with purchase protection they understand, in a currency they control. The unfamiliarity of Nepal as a transaction destination is neutralised by the complete familiarity of PayPal as the transaction mechanism. This trust transfer is the commercial value of PayPal integration for Nepal businesses - and it is why, for businesses targeting international buyers, PayPal integration is not optional cosmetic functionality but a direct revenue driver.

WebApp Nepal integrates PayPal payment gateway for Nepal businesses operating WordPress, WooCommerce, custom PHP, Node.js, and Next.js applications - from a Kathmandu trekking agency adding a trek booking deposit option for international clients to a Pokhara hotel accepting advance payment for international bookings to a Nepal handicraft exporter replacing bank wire instructions with a one-click PayPal checkout. The integration covers PayPal's current API standard (PayPal Orders API v2), webhook configuration for payment event notifications, multi-currency display for Nepal businesses accepting payment in USD, EUR, GBP, and AUD alongside NPR, and the Nepal business account setup process that determines PayPal accessibility from Nepal's current regulatory position.

PayPal Availability and Account Setup for Nepal Businesses

Nepal's Current PayPal Status

Nepal is not on PayPal's full list of supported countries - Nepali individuals cannot create a standard consumer PayPal account. However, Nepal businesses that have registered entities in jurisdictions where PayPal is fully supported - a private limited company registered in the United States, the United Kingdom, Australia, Singapore, or India - can operate PayPal Business accounts from those jurisdictions and integrate PayPal checkout on their Nepal-based websites. This is the approach used by Nepal's established international-facing exporters, trekking companies, and hospitality businesses: the PayPal account is held by the foreign-registered entity, payments received in PayPal are withdrawn to the foreign bank account, and remittance to Nepal follows standard international wire transfer channels. For Nepal businesses that do not have a foreign-registered entity, PayPal integration through a registered Nepal partner or through a payment aggregator that holds a PayPal account and provides API access to Nepal merchants is an alternative approach. WebApp Nepal advises Nepal clients on the account structure that fits their business registration and banking situation before any technical integration begins - because a PayPal integration built on an account structure that violates PayPal's terms of service is a liability, not an asset.

PayPal Business Account Configuration

The PayPal Business account is the merchant account that receives payments made through the checkout integration. Business account configuration relevant to the integration includes: business identity verification (business registration documents, primary account holder identity, bank account linkage for withdrawal), PayPal account currency settings (the currency in which PayPal holds the received funds - USD is the most common choice for Nepal exporters receiving international payments), automatic withdrawal schedule or manual withdrawal management to the linked bank account, PayPal's seller protection eligibility for transaction categories (physical goods with tracking qualify; services and digital goods have different protection terms), and IPN (Instant Payment Notification) or webhook subscription configuration that allows the Nepal business's server to receive real-time notification of payment events. WebApp Nepal assists Nepal clients through the Business account setup process and configures the account settings required for secure and correct API integration.

PayPal Integration for Nepal Websites and Applications

WooCommerce PayPal Integration

For Nepal businesses running WooCommerce - the WordPress e-commerce platform used by the majority of Nepal's online retailers - PayPal integration uses the PayPal Payments plugin maintained by PayPal's official development team, which implements the PayPal Orders API v2 and supports PayPal Standard checkout, PayPal Pay Later, and Venmo (for US buyers). WebApp Nepal configures the WooCommerce PayPal plugin for Nepal clients with: PayPal API credentials (Client ID and Secret from the PayPal Developer Dashboard) entered securely in the plugin settings, sandbox mode testing to verify the complete checkout flow - item selection, cart review, PayPal redirect, payment authorisation, and WooCommerce order status update - before switching to live mode, webhook endpoint registration in PayPal's Developer Dashboard pointing to the WooCommerce payment notification URL, currency configuration to ensure that the WooCommerce order currency matches the PayPal account's accepted currencies, and IPN verification to confirm that payment completion notifications are genuinely from PayPal before order status is updated. The critical implementation detail - running the payment capture API call server-side after the buyer approves the payment in the PayPal interface, rather than relying solely on the buyer's browser redirect - is verified during testing to prevent order completion on payment authorisation without capture.

Custom PayPal Integration for Nepal Applications

For Nepal applications not built on WooCommerce - trekking booking systems, hotel reservation platforms, event registration portals, training and certification payment systems, cooperative fee collection platforms - PayPal integration is implemented directly using PayPal's Orders API v2 through the PayPal server-side SDK for the application's language (PHP, Node.js, Python). The integration flow WebApp Nepal implements: the buyer selects their items or service and proceeds to checkout on the Nepal application; the application server creates a PayPal order using the Orders API v2 with the item details and amount; the buyer is redirected to PayPal's hosted payment interface where they log in to their PayPal account or pay by card; on approval, PayPal returns the buyer to the application's return URL with the order ID; the application server calls the Orders API v2 capture endpoint to complete the payment capture, receiving PayPal's transaction ID and payment status in the response; the application records the confirmed payment and updates the order or booking status. The capture call on the server - not the browser redirect - is the payment confirmation. An application that updates order status on redirect without running the capture API call is vulnerable to a manipulated return URL that falsely signals payment completion.

PayPal Smart Payment Buttons

PayPal's Smart Payment Buttons are the JavaScript SDK-rendered checkout buttons that display the full range of PayPal payment options available to the buyer based on their location and account type: PayPal, Pay Later (PayPal's buy-now-pay-later option for US buyers), Venmo (for US buyers), and card payment through PayPal's hosted card fields. Smart Buttons are rendered by PayPal's JavaScript SDK loaded from PayPal's CDN - the button appearance, currency, and available payment methods are controlled by the SDK parameters rather than by the merchant's design. WebApp Nepal implements PayPal Smart Buttons for Nepal client applications with: SDK script loading with the correct client-id parameter and currency configuration, createOrder callback that calls the Nepal application server's order creation endpoint (which calls the PayPal Orders API v2 to create the server-side order), and onApprove callback that calls the Nepal application server's capture endpoint (which calls the PayPal Orders API v2 capture to complete the payment) - ensuring that both order creation and payment capture are performed server-side with the PayPal secret key, never exposed to the browser.

PayPal Webhook Configuration and Event Handling

PayPal webhooks notify the Nepal application's server of payment events asynchronously - payment completed, payment refunded, dispute opened, payment reversed - through HTTP POST requests to a registered webhook URL. Webhook handling is a critical component of a robust PayPal integration because it is the mechanism through which the application learns about payment events that occur outside the normal checkout flow: a buyer completing payment through PayPal's mobile app after the browser session timed out, a payment refund initiated from the PayPal dashboard, or a dispute raised by the buyer through PayPal's resolution centre. WebApp Nepal configures PayPal webhook subscriptions in the PayPal Developer Dashboard and implements webhook handler endpoints in the Nepal application that: verify the webhook signature using the PayPal-Transmission-Sig header and the PayPal Webhook ID (preventing forged webhook notifications from updating application state fraudulently), parse the event type and extract the relevant data (transaction ID, amount, buyer email, order status), and update the application database state in response to the event. Webhook verification - the step that confirms a notification is genuinely from PayPal and not a crafted request from a third party - is implemented in every PayPal integration WebApp Nepal delivers.

Multi-Currency Configuration for Nepal Exporters

Nepal businesses receiving international payments through PayPal deal with currency in three distinct places: the price displayed to the buyer, the currency in which PayPal holds the received funds, and the currency in which the funds are remitted to Nepal. A pashmina exporter showing product prices in NPR on a website targeting European buyers is creating a currency evaluation problem - the buyer must calculate the EUR equivalent to evaluate the price. Displaying prices in EUR or USD eliminates this friction and increases conversion. WebApp Nepal configures multi-currency display for Nepal e-commerce sites with WooCommerce Currency Switcher or a custom currency detection implementation that shows the correct currency for the buyer's location: USD for North American visitors, EUR for European visitors, GBP for UK visitors, AUD for Australian visitors. The WooCommerce PayPal integration is configured to charge the buyer in the display currency - a buyer seeing EUR prices pays in EUR, and PayPal holds the funds in USD after conversion, or in EUR if the PayPal account is configured to hold a EUR balance. Currency conversion rates and PayPal's currency conversion fee (2.5–4% of the transaction value) are considered in the Nepal business's pricing calculation.

PayPal Integration for Specific Nepal Industries

Trekking and Adventure Tourism

Nepal trekking agencies accepting booking deposits from international clients through PayPal need an integration that handles partial payment at booking and a balance payment close to the trek date - a payment structure that a standard WooCommerce checkout does not implement as a single flow. WebApp Nepal builds trekking booking payment integrations where: the booking form captures the trek date, party size, and trek route; the application calculates the total trek price; the buyer is presented with a 30% deposit checkout through PayPal; the deposit payment is captured and the booking is confirmed; and the balance payment link is sent to the buyer 45 days before the trek through an automated email with a PayPal payment button for the remaining amount. The PayPal reference numbers for both the deposit and the balance payment are linked to the booking record in the agency's admin panel. Refund policy terms - communicated clearly at checkout and managed through PayPal's refund API for cancellations that occur within the refund window - are implemented to match the agency's actual booking policy.

Hotel and Hospitality

Nepal hotels and resorts accepting advance payment from international guests through PayPal need an integration that communicates room availability, booking dates, and guest details alongside the payment. WebApp Nepal integrates PayPal checkout into Nepal hotel booking inquiry and direct booking flows with: booking form capturing check-in and check-out dates, room type, and guest details; room rate calculation in USD or EUR for international guests; PayPal payment button for the advance deposit or full pre-payment; PayPal order creation with booking reference in the order description field so that the PayPal transaction record is tied to the booking; and booking confirmation email sent on payment capture. For hotels using property management systems (PMS), the PayPal payment record is cross-referenced against the PMS booking record by the reservations team using the booking reference in the PayPal transaction description.

Handicraft and Export E-Commerce

Nepal handicraft e-commerce businesses selling to international buyers - pashmina, thangka, metal craft, felt goods, Lokta paper products - benefit most from PayPal integration because the international handicraft buyer's trust in the seller depends significantly on the familiarity and protection of the payment method. PayPal's Purchase Protection covers eligible transactions, giving international buyers confidence that they have recourse if a shipment does not arrive or does not match the description. This protection exists independently of what the Nepal seller's own return policy says - it is backed by PayPal's platform. WebApp Nepal integrates PayPal into Nepal handicraft WooCommerce stores with the full product catalogue in PayPal-compatible currency, correct product weight data for international shipping cost calculation at checkout, and PayPal transaction records linked to WooCommerce orders for the seller's fulfilment workflow.

PayPal Integration Pricing in Nepal

PayPal integration by WebApp Nepal for a WooCommerce store - plugin configuration, sandbox testing, webhook setup, live mode validation, and documentation - costs NPR 25,000 to NPR 50,000. A custom PayPal integration for a non-WooCommerce Nepal application using the PayPal Orders API v2 with full webhook handling costs NPR 50,000 to NPR 1,00,000 depending on the complexity of the checkout flow (single payment, deposit plus balance, recurring payment). Multi-currency configuration alongside PayPal integration for Nepal exporters displaying prices in USD, EUR, and GBP costs an additional NPR 15,000 to NPR 30,000. PayPal's own transaction fees apply separately at 3.49–3.99% plus USD 0.49 per transaction for international payments received, which is separate from WebApp Nepal's configuration fee.

Frequently Asked Questions: PayPal Payment Gateway Integration in Nepal

Can Nepal businesses use PayPal?

Nepal businesses can use PayPal through a PayPal Business account registered in a supported country where the business has a legal entity - the United States, United Kingdom, Australia, Singapore, or India are common choices for Nepal exporters and tourism businesses. Nepal is not on PayPal's list of countries where residents can create accounts directly. Nepal businesses with foreign-registered entities hold the PayPal account in the foreign entity, receive payments to that account, and remit funds to Nepal through standard international transfer channels. WebApp Nepal advises Nepal clients on the entity and account structure appropriate to their business registration situation before beginning integration work.

What is the PayPal transaction fee for Nepal businesses?

PayPal's transaction fee for international payments received varies by the buyer's country and the PayPal account type, but typically ranges from 3.49% to 3.99% of the transaction amount plus a fixed fee of USD 0.49 per transaction for cross-border commercial transactions. For a USD 200 pashmina order, the PayPal fee is approximately USD 7.47 to USD 8.47, leaving USD 191.53 to USD 192.53 settled to the PayPal balance before any currency conversion. Currency conversion (if the seller receives in a different currency from the buyer's payment currency) adds 2.5–4% depending on the currency pair. These fees are separate from WebApp Nepal's integration development fees.

What is the PayPal Orders API v2 and why does WebApp Nepal use it?

The PayPal Orders API v2 is PayPal's current server-side API for creating and capturing payment transactions. WebApp Nepal uses it for all PayPal integrations because: it separates the order creation step (defining what is being paid for and how much) from the payment capture step (taking the money from the buyer's PayPal account or card), which is the correct architecture for secure payment processing; it supports all PayPal payment methods including Pay Later and Venmo for US buyers; it is the API that PayPal's Smart Payment Buttons SDK integrates with natively; and it is the API PayPal actively maintains and updates. The older PayPal Express Checkout API (PayPal v1) is deprecated. WebApp Nepal does not implement deprecated PayPal APIs for new integrations.

How does WebApp Nepal test PayPal integration before going live?

PayPal provides a sandbox environment - a complete PayPal testing platform where sandbox merchant accounts and sandbox buyer accounts transact without real money. WebApp Nepal tests every PayPal integration in sandbox mode with: successful payment flow (sandbox buyer completes payment, order status updates correctly, confirmation email sends), payment abandoned flow (buyer leaves PayPal without completing, order remains pending, no order status update), payment capture API failure simulation (verifying that the application handles capture errors gracefully without marking an order as paid), webhook delivery and verification (PayPal sandbox webhooks sent to the application's webhook endpoint, verified with signature check, order status updated correctly), and refund flow (refund issued from the PayPal sandbox dashboard, webhook received, order status updated to refunded). Only after all flows pass sandbox testing does the integration switch to live credentials for a final production validation with a real small-amount transaction.

Can PayPal be used for recurring or subscription payments for Nepal businesses?

Yes. PayPal Billing Agreements support recurring payment subscriptions - a Nepal SaaS business, an online learning platform, or a cooperative membership service can charge subscribers on a monthly or annual basis through PayPal's subscription API. The buyer agrees to the billing terms once, and PayPal charges their account on the defined schedule without requiring re-approval for each billing cycle. WebApp Nepal implements PayPal subscription integrations for Nepal applications with subscription plan creation (defining the billing cycle, amount, and currency), subscriber management (showing active subscriptions, cancelling subscriptions on buyer request), and webhook handling for subscription events (payment completed, payment failed, subscription cancelled).

What is PayPal Purchase Protection and why does it matter for Nepal sellers?

PayPal Purchase Protection allows buyers to file a dispute with PayPal if a physical product they ordered does not arrive or does not match the seller's description. PayPal investigates the dispute and may refund the buyer from the seller's PayPal balance if the claim is upheld. For Nepal sellers, this buyer protection is simultaneously a trust driver (international buyers are more willing to pay because they have PayPal recourse) and a risk to manage (disputes must be responded to with tracking information and product description evidence within PayPal's dispute window). Nepal handicraft sellers must provide accurate product descriptions, photograph-accurate product delivery, and international shipping with trackable courier services (DHL, FedEx, EMS) to defend against disputes. WebApp Nepal advises Nepal e-commerce clients on shipping and documentation practices that minimise dispute vulnerability alongside the technical PayPal integration.