> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Program Gateway Funding Sources

> Use the /fundingsources/programgateway endpoint to create program gateway funding sources, which represent bank accounts from which funds are drawn for Gateway Just-in-Time (JIT) Funding transactions.

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-semibold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

Use the `/fundingsources/programgateway` endpoint to create a program gateway funding source.

A program gateway funding source represents a bank account from which funds are drawn for Gateway Just-in-Time (JIT) Funding transactions. For more information about JIT Funding, see [About Just-in-Time Funding](/developer-guides/about-jit-funding/).

In a sandbox environment, you can create a program gateway funding source that simulates funds for use in test transactions. In a production environment, you must work with a Marqeta representative to define the bank account from which the program gateway funding source draws funds.

<Note>
  **Note**\
  If you are using a third-party service to collect user funds, Marqeta and the issuing bank require specific reporting to ensure compliance with applicable rules and regulations. Contact Marqeta for more information.
</Note>

<h2 id="post_fundingsources_programgateway">
  Create program gateway source
</h2>

**Action:** `POST`\
**Endpoint:** `/fundingsources/programgateway`

{/* <EndpointCard
title="Creates a gateway program funding source"
path="/fundingsources/programgateway"
method="post"
/> */}

Creates a program gateway funding source. A program gateway funding source is a transaction relay that allows you to approve or decline transactions in real time.

<h3 id="_request_body">
  Request body
</h3>

| Fields                                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| active<br /><br />boolean<br /><br />Optional               | Indicates whether the program gateway funding source is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false`                                                                                                                                                                                                                                           |
| basic\_auth\_password<br /><br />string<br /><br />Required | Password for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />20–100 chars<br /><br />- Must contain at least one numeral<br />- Must contain at least one lowercase letter<br />- Must contain at least one uppercase letter<br />- Must contain at least one of these symbols: <code>@ # \$ % ! ^ & \* ( ) \ \_ + \~ \` - = \[ ] {} , ; : ' " , . / \< > ?</code>                  |
| basic\_auth\_username<br /><br />string<br /><br />Required | Username for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                                                             |
| custom\_header<br /><br />object<br /><br />Optional        | Additional custom information included in the HTTP header. For example, this might contain security information, along with Basic Authentication, when making a JIT Funding request. Custom headers also appear in the associated webhook’s notifications.<br /><br />**Allowable Values:**<br /><br />Up to three name-value pairs: 500 char max per name, 500 char max per value                               |
| name<br /><br />string<br /><br />Required                  | Name of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                                                               |
| timeout\_millis<br /><br />integer<br /><br />Optional      | Total timeout in milliseconds for gateway processing.<br /><br />**Allowable Values:**<br /><br />1000–3000<br /><br />**Default value:**<br />3000                                                                                                                                                                                                                                                              |
| token<br /><br />string<br /><br />Optional                 | Unique identifier of the program gateway funding source. If you do not include a token, the system will generate one automatically. As this token is necessary for use in other calls, we recommend that you define a simple and easy to remember string rather than letting the system generate a token for you. This value cannot be updated.<br /><br />**Allowable Values:**<br /><br />1–36 chars           |
| url<br /><br />string<br /><br />Required                   | URL of the gateway endpoint hosted in your environment, to which `POST` requests are submitted by the Marqeta platform.<br /><br />**Allowable Values:**<br /><br />250 char max<br /><br />Must be HTTPS                                                                                                                                                                                                        |
| use\_mtls<br /><br />boolean<br /><br />Optional            | Specifies whether or not to use mutual transport layer security (mTLS) authentication for the funding request.<br /><br />mTLS authentication is in the beta testing phase, and is not yet generally available. Contact your Marqeta representative for more information about using mTLS authentication.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false` |

<h3 id="_sample_request_body">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "my_pgfs_token",
  "basic_auth_username": "my_username",
  "basic_auth_password": "my_20-to-100-character_password",
  "url": "https://my_secure_domain.com/my_gateway",
  "name": "my_pgfs_name"
}
```

<h3 id="_response_body">
  Response body
</h3>

| Fields                                                       | Description                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account<br /><br />string<br /><br />Returned                | Bank account number.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                          |
| active<br /><br />boolean<br /><br />Conditionally returned  | Indicates whether the program gateway funding source is active. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                      |
| basic\_auth\_password<br /><br />string<br /><br />Returned  | Password for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />Existing `basic_auth` password                                                                                                                                                                                                                                              |
| basic\_auth\_username<br /><br />string<br /><br />Returned  | Username for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />Existing `basic_auth` username                                                                                                                                                                                                                                              |
| created\_time<br /><br />datetime<br /><br />Returned        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                            |
| custom\_header<br /><br />object<br /><br />Returned         | Additional custom information included in the HTTP header.<br /><br />**Allowable Values:**<br /><br />Up to three name-value pairs: 500 char max per name, 500 char max per value                                                                                                                                                                                    |
| last\_modified\_time<br /><br />datetime<br /><br />Returned | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                      |
| name<br /><br />string<br /><br />Returned                   | Name of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                    |
| timeout\_millis<br /><br />integer<br /><br />Returned       | Total timeout in milliseconds for gateway processing.<br /><br />**Allowable Values:**<br /><br />1000-3000                                                                                                                                                                                                                                                           |
| token<br /><br />string<br /><br />Returned                  | Unique identifier of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                                                                                                                                                                                                       |
| url<br /><br />string<br /><br />Returned                    | URL of the gateway endpoint hosted in your environment, to which `POST` requests are submitted by the Marqeta platform.<br /><br />**Allowable Values:**<br /><br />Existing URL                                                                                                                                                                                      |
| use\_mtls<br /><br />boolean<br /><br />Returned             | Specifies whether or not to use mutual transport layer security (mTLS) authentication for the funding request.<br /><br />mTLS authentication is in the beta testing phase, and is not yet generally available. Contact your Marqeta representative for more information about using mTLS authentication.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| version<br /><br />string<br /><br />Returned                | Program gateway funding source object version.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                               |

<h3 id="_sample_response_body">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "name": "my_pgfs_name",
  "active": true,
  "token": "my_pgfs_token",
  "account": "12.003.001.000155",
  "url": "https://my_secure_domain.com/my_gateway",
  "created_time": "2023-02-28T20:00:00Z",
  "last_modified_time": "2023-02-28T20:00:00Z",
  "basic_auth_username": "my_username",
  "basic_auth_password": "my_20-to-100-character_password",
  "use_mtls": false,
  "timeout_millis": 3000,
  "custom_header": {
    "my_header_name_1": "my_value_1",
    "my_header_name_2": "my_value_2",
    "my_header_name_3": "my_value_3"
  },
  "version": "2"
}
```

<h2 id="put_fundingsources_programgateway_custom_header_token">
  Update program gateway source custom headers
</h2>

**Action:** `PUT`\
**Endpoint:** `/fundingsources/programgateway/customheaders/{token}`

{/* <EndpointCard
title="Updates a specific gateway program funding source Custom headers"
path="/fundingsources/programgateway/customheaders/{token}"
method="put"
/> */}

Adds or updates custom HTTP headers for a specific program gateway funding source.

<h3 id="_url_path_parameters">
  URL path parameters
</h3>

| Fields                                      | Description                                                                                                                                        |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Required | Unique identifier of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />Existing program gateway funding source token |

<h3 id="_request_body_2">
  Request body
</h3>

| Fields                                               | Description                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| custom\_header<br /><br />object<br /><br />Optional | Additional custom information included in the HTTP header. For example, this might contain security information, along with Basic Authentication, when making a JIT Funding request. Custom headers also appear in the associated webhook’s notifications.<br /><br />**Allowable Values:**<br /><br />Up to three name-value pairs: 500 char max per name, 500 char max per value |

<h3 id="_sample_request_body_2">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "custom_header": {
    "my_header_name_1": "my_value_1",
    "my_header_name_2": "my_value_2",
    "my_header_name_3": "my_value_3"
  }
}
```

<h3 id="_response_body_2">
  Response body
</h3>

| Fields                                                       | Description                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account<br /><br />string<br /><br />Returned                | Bank account number.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                          |
| active<br /><br />boolean<br /><br />Conditionally returned  | Indicates whether the program gateway funding source is active. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                      |
| basic\_auth\_password<br /><br />string<br /><br />Returned  | Password for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />Existing `basic_auth` password                                                                                                                                                                                                                                              |
| basic\_auth\_username<br /><br />string<br /><br />Returned  | Username for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />Existing `basic_auth` username                                                                                                                                                                                                                                              |
| created\_time<br /><br />datetime<br /><br />Returned        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                            |
| custom\_header<br /><br />object<br /><br />Returned         | Additional custom information included in the HTTP header.<br /><br />**Allowable Values:**<br /><br />Up to three name-value pairs: 500 char max per name, 500 char max per value                                                                                                                                                                                    |
| last\_modified\_time<br /><br />datetime<br /><br />Returned | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                      |
| name<br /><br />string<br /><br />Returned                   | Name of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                    |
| timeout\_millis<br /><br />integer<br /><br />Returned       | Total timeout in milliseconds for gateway processing.<br /><br />**Allowable Values:**<br /><br />1000-3000                                                                                                                                                                                                                                                           |
| token<br /><br />string<br /><br />Returned                  | Unique identifier of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                                                                                                                                                                                                       |
| url<br /><br />string<br /><br />Returned                    | URL of the gateway endpoint hosted in your environment, to which `POST` requests are submitted by the Marqeta platform.<br /><br />**Allowable Values:**<br /><br />Existing URL                                                                                                                                                                                      |
| use\_mtls<br /><br />boolean<br /><br />Returned             | Specifies whether or not to use mutual transport layer security (mTLS) authentication for the funding request.<br /><br />mTLS authentication is in the beta testing phase, and is not yet generally available. Contact your Marqeta representative for more information about using mTLS authentication.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| version<br /><br />string<br /><br />Returned                | Program gateway funding source object version.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                               |

<h3 id="_sample_response_body_2">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "name": "my_pgfs_name",
  "active": true,
  "token": "my_pgfs_token",
  "account": "12.003.001.000155",
  "url": "https://my_secure_domain.com/my_gateway",
  "created_time": "2023-02-28T20:00:00Z",
  "last_modified_time": "2023-02-28T20:00:00Z",
  "basic_auth_username": "my_username",
  "basic_auth_password": "my_20-to-100-character_password",
  "use_mtls": false,
  "timeout_millis": 3000,
  "custom_header": {
    "my_header_name_1": "my_value_1",
    "my_header_name_2": "my_value_2",
    "my_header_name_3": "my_value_3"
  },
  "version": "2"
}
```

<h2 id="get_fundingsources_programgateway_token">
  Retrieve program gateway source
</h2>

**Action:** `GET`\
**Endpoint:** `/fundingsources/programgateway/{token}`

{/* <EndpointCard
title="Returns a gateway program funding source"
path="/fundingsources/programgateway/{token}"
method="get"
/> */}

Retrieves a specific program gateway funding source.

<h3 id="_url_path_parameters_2">
  URL path parameters
</h3>

| Fields                                      | Description                                                                                                                                        |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Required | Unique identifier of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />Existing program gateway funding source token |

<h3 id="_response_body_3">
  Response body
</h3>

| Fields                                                       | Description                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account<br /><br />string<br /><br />Returned                | Bank account number.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                          |
| active<br /><br />boolean<br /><br />Conditionally returned  | Indicates whether the program gateway funding source is active. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                      |
| basic\_auth\_password<br /><br />string<br /><br />Returned  | Password for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />Existing `basic_auth` password                                                                                                                                                                                                                                              |
| basic\_auth\_username<br /><br />string<br /><br />Returned  | Username for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />Existing `basic_auth` username                                                                                                                                                                                                                                              |
| created\_time<br /><br />datetime<br /><br />Returned        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                            |
| custom\_header<br /><br />object<br /><br />Returned         | Additional custom information included in the HTTP header.<br /><br />**Allowable Values:**<br /><br />Up to three name-value pairs: 500 char max per name, 500 char max per value                                                                                                                                                                                    |
| last\_modified\_time<br /><br />datetime<br /><br />Returned | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                      |
| name<br /><br />string<br /><br />Returned                   | Name of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                    |
| timeout\_millis<br /><br />integer<br /><br />Returned       | Total timeout in milliseconds for gateway processing.<br /><br />**Allowable Values:**<br /><br />1000-3000                                                                                                                                                                                                                                                           |
| token<br /><br />string<br /><br />Returned                  | Unique identifier of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                                                                                                                                                                                                       |
| url<br /><br />string<br /><br />Returned                    | URL of the gateway endpoint hosted in your environment, to which `POST` requests are submitted by the Marqeta platform.<br /><br />**Allowable Values:**<br /><br />Existing URL                                                                                                                                                                                      |
| use\_mtls<br /><br />boolean<br /><br />Returned             | Specifies whether or not to use mutual transport layer security (mTLS) authentication for the funding request.<br /><br />mTLS authentication is in the beta testing phase, and is not yet generally available. Contact your Marqeta representative for more information about using mTLS authentication.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| version<br /><br />string<br /><br />Returned                | Program gateway funding source object version.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                               |

<h3 id="_sample_response_body_3">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "name": "my_pgfs_name",
  "active": true,
  "token": "my_pgfs_token",
  "account": "12.003.001.000155",
  "url": "https://my_secure_domain.com/my_gateway",
  "created_time": "2023-02-28T20:00:00Z",
  "last_modified_time": "2023-02-28T20:00:00Z",
  "basic_auth_username": "my_username",
  "basic_auth_password": "my_20-to-100-character_password",
  "use_mtls": false,
  "timeout_millis": 3000,
  "custom_header": {
    "my_header_name_1": "my_value_1",
    "my_header_name_2": "my_value_2",
    "my_header_name_3": "my_value_3"
  },
  "version": "2"
}
```

<h2 id="put_fundingsources_programgateway_token">
  Update program gateway source
</h2>

**Action:** `PUT`\
**Endpoint:** `/fundingsources/programgateway/{token}`

{/* <EndpointCard
title="Updates a specific gateway program funding source"
path="/fundingsources/programgateway/{token}"
method="put"
/> */}

Update a program gateway funding source.

<h3 id="_url_path_parameters_3">
  URL path parameters
</h3>

| Fields                                      | Description                                                                                                                                        |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Required | Unique identifier of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />Existing program gateway funding source token |

<h3 id="_request_body_3">
  Request body
</h3>

| Fields                                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| active<br /><br />boolean<br /><br />Optional               | Indicates whether the program gateway funding source is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false`                                                                                                                                                                                                                                           |
| basic\_auth\_password<br /><br />string<br /><br />Required | Password for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />20–100 chars<br /><br />- Must contain at least one numeral<br />- Must contain at least one lowercase letter<br />- Must contain at least one uppercase letter<br />- Must contain at least one of these symbols: <code>@ # \$ % ! ^ & \* ( ) \ \_ + \~ \` - = \[ ] {} , ; : ' " , . / \< > ?</code>                  |
| basic\_auth\_username<br /><br />string<br /><br />Required | Username for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                                                             |
| custom\_header<br /><br />object<br /><br />Optional        | Additional custom information included in the HTTP header. For example, this might contain security information, along with Basic Authentication, when making a JIT Funding request. Custom headers also appear in the associated webhook’s notifications.<br /><br />**Allowable Values:**<br /><br />Up to three name-value pairs: 500 char max per name, 500 char max per value                               |
| name<br /><br />string<br /><br />Optional                  | Name of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                                                               |
| timeout\_millis<br /><br />integer<br /><br />Optional      | Total timeout in milliseconds for gateway processing.<br /><br />**Allowable Values:**<br /><br />1000–3000<br /><br />**Default value:**<br />3000                                                                                                                                                                                                                                                              |
| url<br /><br />string<br /><br />Required                   | URL of the gateway endpoint hosted in your environment, to which `POST` requests are submitted by the Marqeta platform.<br /><br />**Allowable Values:**<br /><br />250 char max<br /><br />Must be HTTPS                                                                                                                                                                                                        |
| use\_mtls<br /><br />boolean<br /><br />Optional            | Specifies whether or not to use mutual transport layer security (mTLS) authentication for the funding request.<br /><br />mTLS authentication is in the beta testing phase, and is not yet generally available. Contact your Marqeta representative for more information about using mTLS authentication.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false` |

<h3 id="_sample_request_body_3">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "active": false,
  "url": "https://my_secure_domain.com/my_gateway",
  "basic_auth_username": "my_username",
  "basic_auth_password": "my_20-to-100-character_password"
}
```

<h3 id="_response_body_4">
  Response body
</h3>

| Fields                                                       | Description                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account<br /><br />string<br /><br />Returned                | Bank account number.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                          |
| active<br /><br />boolean<br /><br />Conditionally returned  | Indicates whether the program gateway funding source is active. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                      |
| basic\_auth\_password<br /><br />string<br /><br />Returned  | Password for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />Existing `basic_auth` password                                                                                                                                                                                                                                              |
| basic\_auth\_username<br /><br />string<br /><br />Returned  | Username for authenticating your environment.<br /><br />**Allowable Values:**<br /><br />Existing `basic_auth` username                                                                                                                                                                                                                                              |
| created\_time<br /><br />datetime<br /><br />Returned        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                            |
| custom\_header<br /><br />object<br /><br />Returned         | Additional custom information included in the HTTP header.<br /><br />**Allowable Values:**<br /><br />Up to three name-value pairs: 500 char max per name, 500 char max per value                                                                                                                                                                                    |
| last\_modified\_time<br /><br />datetime<br /><br />Returned | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                      |
| name<br /><br />string<br /><br />Returned                   | Name of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                    |
| timeout\_millis<br /><br />integer<br /><br />Returned       | Total timeout in milliseconds for gateway processing.<br /><br />**Allowable Values:**<br /><br />1000-3000                                                                                                                                                                                                                                                           |
| token<br /><br />string<br /><br />Returned                  | Unique identifier of the program gateway funding source.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                                                                                                                                                                                                       |
| url<br /><br />string<br /><br />Returned                    | URL of the gateway endpoint hosted in your environment, to which `POST` requests are submitted by the Marqeta platform.<br /><br />**Allowable Values:**<br /><br />Existing URL                                                                                                                                                                                      |
| use\_mtls<br /><br />boolean<br /><br />Returned             | Specifies whether or not to use mutual transport layer security (mTLS) authentication for the funding request.<br /><br />mTLS authentication is in the beta testing phase, and is not yet generally available. Contact your Marqeta representative for more information about using mTLS authentication.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| version<br /><br />string<br /><br />Returned                | Program gateway funding source object version.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                               |

<h3 id="_sample_response_body_4">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "name": "my_pgfs_name",
  "active": false,
  "token": "my_pgfs_token",
  "account": "12.003.001.000155",
  "url": "https://my_secure_domain.com/my_gateway",
  "created_time": "2023-02-28T20:00:00Z",
  "last_modified_time": "2023-02-28T20:00:00Z",
  "basic_auth_username": "my_username",
  "basic_auth_password": "my_20-to-100-character_password",
  "use_mtls": false,
  "timeout_millis": 3000,
  "custom_header": {
    "my_header_name_1": "my_value_1",
    "my_header_name_2": "my_value_2",
    "my_header_name_3": "my_value_3"
  },
  "version": "2"
}
```
