About PayPal Payments

Overview

PayPal is one of the most widely used digital wallets in the world. With Coinflow’s PayPal integration, merchants can let customers check out using their existing PayPal balance, linked bank accounts, or cards — without leaving your checkout flow. Upon a successful payment, merchants receive funds at their configured settlement location.

Coinflow offers three ways to accept PayPal, so you can pick the option that best matches how much control you want over the checkout experience:

How It Works

1. PayPal is enabled on your Coinflow account by the integrations team.
2. The customer initiates a PayPal payment from your checkout (via the prebuilt UI, the SDK button, or your own PayPal button).
3. The customer approves the payment in PayPal.
4. Coinflow creates the checkout order and returns a paymentId.
5. Coinflow settles the payment to your configured settlement location.
6. Your backend listens for Settled webhook events to confirm payment completion.

Choosing an Integration Path

• Prebuilt Checkout UI — If you already embed Coinflow’s hosted checkout (the CoinflowPurchase iframe), no code changes are needed. Once PayPal is enabled on your account, the PayPal button appears automatically alongside the other payment methods.
• CoinflowPayPalButton component — Use this when you have built your own checkout UI but want Coinflow to handle the PayPal order creation, approval overlay, and settlement. You drop a single React component where you want the button to render.
• Direct API integration — Use this when you want to render PayPal’s own button using the PayPal JS SDK and have full control over the experience. You fetch your paypalMerchantId from Coinflow, initialize the PayPal SDK, and call Coinflow’s PayPal checkout endpoints to create and capture the order.

See How To: Implement PayPal Payments for step-by-step instructions for each path.