---
updatedAt: 2025-11-13T16:36:24.000Z
agentTools:
  projectIndex: https://developers.bluesnap.com/v8976-JSON/llms.txt
---

# payByBankTranscation

Contains the information required to process a [Pay by Bank (Open Banking)](ref:pay-by-bank-open-banking) payment.

<Callout icon="🚧" theme="warn">
  **Beta Feature**

  Pay by Bank is currently in beta and not suitable for production environments.
</Callout>

## Request

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Property name
      </th>

      <th style={{ textAlign: "left" }}>
        Type
      </th>

      <th style={{ textAlign: "left" }}>
        Required
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        `cancelUrl`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        <span style={{ color: "#F37500", fontWeight: "bold" }}>required</span>
      </td>

      <td style={{ textAlign: "left" }}>
        URL where you redirect the shopper after they cancel the payment in their online banking portal.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `iban`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        <span style={{ color: "#F37500", fontWeight: "bold" }}>required</span>
      </td>

      <td style={{ textAlign: "left" }}>
        International Banking Account Number.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `ibanFirstFour`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        <span style={{ color: "#F37500", fontWeight: "bold" }}>required</span>
      </td>

      <td style={{ textAlign: "left" }}>
        First four digits of an International Banking Account Number (IBAN).
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `ibanLastFour`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        <span style={{ color: "#F37500", fontWeight: "bold" }}>required</span>
      </td>

      <td style={{ textAlign: "left" }}>
        Last four digits of an IBAN.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `returnUrl`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        <span style={{ color: "#F37500", fontWeight: "bold" }}>required</span>
      </td>

      <td style={{ textAlign: "left" }}>
        URL where you redirect the shopper after they authorize payment in their online banking portal.
      </td>
    </tr>
  </tbody>
</Table>

## Response

| Property Name   | Type     | Description                                                                                                                                                                                                                    |
| :-------------- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ibanFirstFour` | *string* | First four digits of the IBAN used in the transaction.                                                                                                                                                                         |
| `ibanLastFour`  | *string* | Last four digits of the IBAN used in the transaction.                                                                                                                                                                          |
| `payByBankUrl`  | *string* | URL that redirects the shopper to their banking portal where they can authenticate to their account and authorize payment. Each `payByBankUrl` contains a unique hosted page ID that is associated to the current transaction. |