Implement PayPal Express Checkout

Implement PayPal Express checkout to authorize, capture, purchase, and refund payments.

Prerequisites

Ensure that you have an Elastic Path Commerce Cloud account, and Client ID and Client Secret of your store available from Commerce Manager.
Get An access token.
Create an account in developer.paypal.com.
Configure products and gateway using Commerce Manager or API.
Onbaord PayPal Express Checkout. See Onboarding PayPal Express Checkout.

Procedure - Set up the Checkout Flow

Use the API to create a checkout flow. At minimum, you need the ability to setup and confirm the purchase and authorization workflow.

`Purchase` workflow

You can use any URL safe value you want for your cart IDs. If a cart does not already exist with that ID, it will be created the first time you add an item. If the request is successful, you will get a 201 response with all of the cart items that exist in the updated cart.

You can set up and confirm a purchase by doing the following:

Checkout using a customer object. For more information, see Checkout.

note

Ensure that you use a valid country code. The URL used in this call is http://localhost/v2/carts/{{cartID}}/checkout.

Use the following request example to set up purchase from PayPal Express Checkout gateway. For more information, see PayPal Express Checkout Payments.

    curl -X POST https://api.moltin.com/v2/orders/:orderId/payments \
        -H "Authorization: Bearer XXXX" \
        -d $'{
           "data" : {
           "gateway" : "paypal_express_checkout",
           "method" : "purchase",
           "options" : {
               "description": "Test description",
               "soft_descriptor": "integration test",
               "application_context": {
                   "brand_name": "TEST brand",
                   "locale": "en-US",
                   "landing_page": "LOGIN",
                   "shipping_preference": "SET_PROVIDED_ADDRESS",
                   "user_action": "PAY_NOW",
                   "return_url": "https://elasticpath.com",
                   "cancel_url": "https://elasticpath.com"
            }
        }
    }
}'

The following response example is returned:

200 OK

    "data": {
    "id": "4e772a38-7ca1-43a6-9c99-a136d2856bff",
    "type": "transaction",
    "reference": "4KT84175RH321931J",
    "gateway": "paypal_express_checkout",
    "amount": 10000,
    "refunded_amount": 0,
    "currency": "USD",
    "transaction_type": "purchase",
    "status": "pending",
    "relationships": {
        "order": {
            "data": {
                "type": "order",
                "id": "a2c3aeef-1ea1-4029-aa92-53091a548220"
            }
        }
    },
    "meta": {
        "display_price": {
            "amount": 10000,
            "currency": "USD",
            "formatted": "$100.00"
        },
        "display_refunded_amount": {
            "total": {
                "amount": 0,
                "currency": "USD",
                "formatted": "$0.00"
            }
        },
        "timestamps": {
            "created_at": "2022-03-10T22:04:44Z",
            "updated_at": "2022-03-10T22:04:45Z"
        }
    },
    "client_parameters": {
        "token": "",
        "redirect_url": "https://www.sandbox.paypal.com/checkoutnow?token=4KT84175RH321931J"
        }
    }
}

Copy the redirect_url from the previous step and open in a browser. If you are not redirected to the personal account, sign in to the developer.paypal.com with your Email ID and System Generated Password or Password that you changed to. See Accessing PayPal Developer Sandbox Accounts.
Click Pay Now to make the payment.

In postman, use the following request example to confirm the purchase.

   curl -X POST https://api.moltin.com/v2/orders/:orderId/transactions/:transactionId/confirm \
        -H "Authorization: Bearer XXXX" \
        -d $'{
           "data" : {
           "gateway" : "paypal_express_checkout",
      }
  }'

The following response is returned:

{
  "data": {
    "id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxx",
    "type": "transaction",
    "reference": "xxxxxxxxxxx",
    "gateway": "paypal_express_checkout",
    "amount": 10000,
    "refunded_amount": 0,
    "currency": "USD",
    "transaction_type": "purchase",
    "status": "complete",
    "relationships": {
        "order": {
            "data": {
                "type": "order",
                "id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxx"
            }
        }
    },
    "meta": {
        "display_price": {
            "amount": 10000,
            "currency": "USD",
            "formatted": "$100.00"
        },
        "display_refunded_amount": {
            "total": {
                "amount": 0,
                "currency": "USD",
                "formatted": "$0.00"
                }
        },
        "timestamps": {
            "created_at": "2020-05-12T23:28:11Z",
            "updated_at": "2020-05-12T23:29:11Z"
            }
        }
    }
}

Go to Commerce Manager.
Go to Orders, and find the order. The payment status shows Paid and under the Transaction, the status shows Complete.

`Authorization` workflow

You can use any URL safe value you want for your cart IDs. If a cart doesn’t already exist with that ID, it will be created the first time you add an item. If the request is successful, you will get a 201 response with all of the cart items that exist in the updated cart.

You can set up the authorization and capture the payment by doing the following:

Checkout using a customer object. For more information, see Checkout.

note

Ensure that you use a valid country code. The URL used in this call is http://localhost/v2/carts/{{cartID}}/checkout.

Use the following request example to setup authorization from PayPal Express Checkout gateway. For more information, see PayPal Express Checkout Payments.

   curl -X POST https://api.moltin.com/v2/orders/:orderId/payments \
        -H "Authorization: Bearer XXXX" \
        -d $'{
           "data" : {
           "gateway" : "paypal_express_checkout",
           "method" : "authorize",
           "options" : {
               "description": "Test description",
               "soft_descriptor": "integration test",
               "application_context": {
                   "brand_name": "TEST brand",
                   "locale": "en-US",
                   "landing_page": "LOGIN",
                   "shipping_preference": "SET_PROVIDED_ADDRESS",
                   "user_action": "PAY_NOW",
                   "return_url": "https://elasticpath.com",
                   "cancel_url": "https://elasticpath.com"
            }
        }
    }
}'

The following response is returned:

   {
     "data": {
         "id": "367933ca-35f5-4283-b599-0b7a85a002f1",
         "type": "transaction",
         "reference": "3L516367V9884024E",
         "gateway": "paypal_express_checkout",
         "amount": 10000,
         "refunded_amount": 0,
         "currency": "USD",
         "transaction_type": "authorize",
         "status": "pending",
         "relationships": {
             "order": {
                 "data": {
                     "type": "order",
                     "id": "a7e7dd2f-daed-4010-9432-0d88a6f5c74f"
                 }
             }
         },
         "meta": {
             "display_price": {
                 "amount": 10000,
                 "currency": "USD",
                 "formatted": "$100.00"
             },
             "display_refunded_amount": {
                 "total": {
                     "amount": 0,
                     "currency": "USD",
                     "formatted": "$0.00"
                 }
             },
             "timestamps": {
                 "created_at": "2022-03-10T19:26:34Z",
                 "updated_at": "2022-03-10T19:26:35Z"
             }
         },
         "client_parameters": {
             "redirect_url": "https://www.sandbox.paypal.com/checkoutnow?token=3L516367V9884024E"
         }
     }
 }

Copy the redirect_url from the previous step and open in a browser. If you are not redirected to the personal account, sign in to developer.paypal.com with your Email ID and System Generated Password or Password that you changed to. See Accessing PayPal Developer Sandbox Accounts.
Click Pay Now to make the payment.

In postman, use the following request example to confirm the payment.

   curl -X POST https://api.moltin.com/v2/orders/:orderId/transactions/:transactionId/confirm \
        -H "Authorization: Bearer XXXX" \
        -d $'{
           "data" : {
           "gateway" : "paypal_express_checkout",
       }
   }'

Capture the authorized funds. See Capture a Transaction.
Go to Commerce Manager.
Go to Orders, and find the order. The payment status shows Paid, and the Transaction status shows Complete.

`Refund` workflow

You can refund the paid order. See Refund a Payment.

Commerce Cloud

Customers

Product Experience Manager (EP PXM)

Products and Catalogs (V2)

Currencies and Taxes

Promotions

Carts

Orders

Payments

Integrations

Custom Data

Accounts

Test

Personal Data

Implement PayPal Express Checkout

Prerequisites

Procedure - Set up the Checkout Flow

`Purchase` workflow

note

`Authorization` workflow

note

`Refund` workflow

Further reading

Prerequisites

Procedure - Set up the Checkout Flow

Purchase workflow

note

Authorization workflow

note

Refund workflow

Further reading

`Purchase` workflow

`Authorization` workflow

`Refund` workflow