# PayPal Checkout

**PayPal Check**, fomally known as PayPal Express Checkout, is an Addon Gateway Officially Supported by WooCommerce. 

## Installation & Setup

For installation, install & activate [**WooCommerce PayPal Checkout Payment Gateway**](https://wordpress.org/plugins/woocommerce-gateway-paypal-express-checkout/) from you wp-admin Dashboard.

You can enable or disable it in your _wp-admin_ Dashboard.

1.  Visit **WooCommerce** > **Settings**
2.  Click **Payments** tab
3.  **Toggle** the switch in _Enabled_ column
4.  Click **Save Changes**

For help setting up and configuring, please refer to [the user guide](https://docs.woocommerce.com/document/paypal-express-checkout/)

![](setup.png)

## Process Payment via REST API

| URL                              | HTTP   | payment_method |
| :------------------------------- | :----- | :------------- |
| `/wp-json/wc/v2/process_payment` | `POST` | `paypal-express`         |

### Request

**POST**: `/wp-json/wc/v2/process_payment`

```json
{
  "order_id": 65,
  "payment_method": "paypal-express",
  "ppec_token": ""
}
```

### Response

#### If the request was successful.

You will receive a response similar to the following.

```json
{
    "code": 200,
    "message": "Payment Successful.",
    "data": {
        "result": "success",
        "redirect": "http://localhost:8888/v/5.1/checkout/order-received/65/?key=wc_order_XXXXXXXXXXXXX"
    }
}
```

** With PayPal Standard, your customer will be redirected to PayPal's site to complete the payment. **

The `redirect` contains the url to **PayPal** site.

Once your customer completes the payment on paypal's site (or cancelled), they will be redirected back to your site, and only then, the order status will be updated from `pending` to `processing`. 

#### If the request failed.

You will receive a response similar to the following.

```json
{
    "code": 403,
    "message": "Order status is 'processing', meaning it had already received a successful payment. Duplicate payments to the order is not allowed. The allow status it is either 'pending' or 'failed'. ",
    "data": {
        "status": 400
    }
}
```

The `message` contains the error message and how to fix it.

## Summary

That's it! Easy right? Here's a quick summary.

1.  Send a REST API `POST` Request to `/wp-json/wc/v2/process_payment`
2.  Include a JSON Body with `order_id` and `process_payment` as 'paypal'
3.  Redirect your customer to PayPal site to complete payment.
4.  Once done, PayPal will redirect the customer back to your site.

## Next Step

There're a lot more Gateways that WC REST Payment support!

Check them out at [WC REST Payment Gateways here](../#supported-gateways)!