---
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: 2025-07
api_name: payments-apps
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/2025-07/mutations/paymentSessionRedirect
  md: >-
    https://shopify.dev/docs/api/payments-apps/2025-07/mutations/paymentSessionRedirect.md
---

# 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/2025-07/scalars/ID)

  required

  The payment session ID.

* redirect​Url

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

  required

  The URL that Shopify will redirect the buyer to, for 3DS authentication. 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/2025-07/objects/PaymentSession)

  The updated payment session.

* user​Errors

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

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### paymentSessionRedirect reference

## Mutation Reference

```graphql
mutation paymentSessionRedirect($id: ID!, $redirectUrl: URL!) {
  paymentSessionRedirect(id: $id, redirectUrl: $redirectUrl) {
    paymentSession {
      # PaymentSession fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{
  "id": "gid://shopify/<objectName>/10079785100",
  "redirectUrl": "https://example.myshopify.com"
}
```