Payment services during a checkout authorization

Payment Services for Adobe Commerce and Magento Open Source is your turnkey self-service solution, including sandbox testing and a simple setup, for providing robust and secure payment processing for your Commerce websites.

These steps describe the flow of requests and responses required to complete a typical checkout authorization with Payment Services enabled.

Checkout workflow

1. Run the getPaymentConfig query to fetch the payment configuration needed to render details about PayPal components, such as hosted fields, smart buttons, and Apple Pay.

2. Commerce returns payment configuration information.

3. Run setPaymentMethodOnCart to set the payment method.

4. Adobe Commerce returns a Cart object.

5. Run createPaymentOrder to begin the authorization process.

6. Commerce forwards the request to PayPal.

7. PayPal returns an id value.

8. Adobe Commerce generates a order_id and forwards the value in the mp_order_id field and the PayPal response in the id field.

9. (Optional) If hosted fields and the Signifyd integration are enabled, run getPaymentOrder.

10. (Optional) Adobe Commerce returns details about the payment order.

11. Run placeOrder.

12. Commerce sends an authorization request to PayPal.

13. PayPal returns the result to Commerce.

14. Commerce creates an order.

setPaymentMethodOnCartInput object

For the PayPal Smart Buttons and Apple Pay payment methods, you do not need to run the setPaymentMethodOnCart mutation. The hosted fields payment method requires that you run the mutation only if one of the following conditions are true:

• You intend to vault a card by setting is_active_payment_token_enabler to true.

• You have a stored payment method checkout where you intend to use a stored card by setting a public_hash value.

In these cases, the payment_method object must contain a payment_services_paypal_hosted_fields object.

payment_services_paypal_hosted_fields object

The payment_services_paypal_hosted_fields can contain the following attributes:

setPaymentMethodOnCart mutation example

The following example shows the setPaymentMethodOnCart mutation constructed for the PayPal Hosted Fields payment method.

Request:

mutation {
    setPaymentMethodOnCart ( input: {
      cart_id: "uocGxUi5H97XFAMhY3s66q4aFYG3Bmdr",
      payment_method: {
        code: "payment_services_paypal_hosted_fields",
        payment_services_paypal_hosted_fields: {
          payment_source: "cc",
          payments_order_id: "mp-order-a4babd34-13d3-4ac0-b1b0-109bb7be1574",
          paypal_order_id: "9R90936863877801D",
          is_active_payment_token_enabler: true
        }
      }
    }
    ) {
       cart {
         id
         selected_payment_method {
           code
         }
       }
    }
  } 

Response:

{
  "data": {
    "setPaymentMethodOnCart": {
      "cart": {
        "id": "r8TKHa58b7Y8VaZHLyABNxrEdS8hJJTZ",
        "selected_payment_method": {
          "code": "payment_services_paypal_hosted_fields"
        }
      }
    }
  }
}