---
title: paymentSessionRedirect - Payments Apps API
description: >-
  Redirects the buyer to the given URL for the payment session.

  For example, Shopify will redirect the buyer to the URL where the 3DS
  authentication will take place

  for onsite payment with `credit_card` payment method.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionRedirect
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionRedirect.md
api_name: payments-apps
api_type: graphql
type: mutation
---

# payment​Session​Redirect

mutation

Requires `write_payment_sessions` access scope.

Redirects the buyer to the given URL for the payment session. For example, Shopify will redirect the buyer to the URL where the 3DS authentication will take place for onsite payment with `credit_card` payment method.

## Arguments

* id

  [ID!](https://shopify.dev/docs/api/payments-apps/latest/scalars/ID)

  required

  The payment session ID.

* redirect​Url

  [URL!](https://shopify.dev/docs/api/payments-apps/latest/scalars/URL)

  required

  The absolute HTTPS URL, including a host, that Shopify will redirect the buyer to for 3DS authentication. The URL must not contain ASCII control characters, spaces in the scheme or authority, or user information before the hostname, such as a username or password. Spaces in the path, query string, or fragment are allowed. Applicable to payments with the credit card payment method only.

***

## Payment​Session​Redirect​Payload returns

* payment​Session

  [Payment​Session](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSession)

  The updated payment session.

* user​Errors

  [\[Payment​Session​Redirect​User​Error!\]!](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionRedirectUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### paymentSessionRedirect reference