Payment Services vaulted card workflow

The following diagram shows the workflow of a checkout authorization using a vaulted card.

1. Use the customerPaymentTokens query to retrieve the payment tokens the customer stored in the vault.

2. Commerce returns an array of payment tokens.

3. The client integration renders the token information, and the customer selects a payment method.

   When the customer selects a stored payment method, the client integration uses the setPaymentMethodOnCart mutation to set the payment method to payment_services_paypal_vault.

4. Commerce returns a Cart object.

5. Run placeOrder.

6. Commerce sends an authorization request to PayPal.

7. PayPal returns the result to Commerce.

8. Commerce creates an order.

Additional Payment information

When you set the payment method to Payment Services vaulted card in the setPaymentMethodOnCart mutation, you must supply a value for the public_hash field. Run the customerPaymentTokens query to retrieve the value.

This public_hash comes from the customerPaymentTokens query.

payment_services_paypal_vault attributes

The setPaymentMethodOnCart mutation has a payment_services_paypal_vault object that contains the following attributes:

Example usage

The following example shows the setPaymentMethodOnCart mutation constructed for the Payment Services vaulted card workflow.

Request:

Copy
mutation {
    setPaymentMethodOnCart ( input: {
        cart_id: "uocGxUi5H97XFAMhY3s66q4aFYG3Bmdr",
        payment_method: {
            code: "payment_services_paypal_vault",
            payment_services_paypal_vault: {
                payment_source: "vault",
                payments_order_id: "mp-order-a4babd34-13d3-4ac0-b1b0-109bb7be1574",
                paypal_order_id: "9R90936863877801D",
                public_hash: "shew83bdbd83y2bdjbwb2ib2ds"
            }
        }
    }
    ) {
        cart {
            id
            selected_payment_method {
                code
            }
        }
    }
}
Copied to your clipboard
mutation {
    setPaymentMethodOnCart ( input: {
        cart_id: "uocGxUi5H97XFAMhY3s66q4aFYG3Bmdr",
        payment_method: {
            code: "payment_services_paypal_vault",
            payment_services_paypal_vault: {
                payment_source: "vault",
                payments_order_id: "mp-order-a4babd34-13d3-4ac0-b1b0-109bb7be1574",
                paypal_order_id: "9R90936863877801D",
                public_hash: "shew83bdbd83y2bdjbwb2ib2ds"
            }
        }
    }
    ) {
        cart {
            id
            selected_payment_method {
                code
            }
        }
    }
}

Response:

Copy
{
  "data": {
    "setPaymentMethodOnCart": {
      "cart": {
        "id": "r8TKHa58b7Y8VaZHLyABNxrEdS8hJJTZ",
        "selected_payment_method": {
          "code": "payment_services_paypal_vault"
        }
      }
    }
  }
}
Copied to your clipboard
{
  "data": {
    "setPaymentMethodOnCart": {
      "cart": {
        "id": "r8TKHa58b7Y8VaZHLyABNxrEdS8hJJTZ",
        "selected_payment_method": {
          "code": "payment_services_paypal_vault"
        }
      }
    }
  }
}

Last updated 2/18/2025

Was this helpful?

Yes

No