> ## 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.

# Reward Global Configurations

> Use the `/credit/rewards/configurations` endpoint to manage the global configurations for a reward program.

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>;
};

<Note>
  **Note**\
  This feature is currently in beta and subject to change. To learn more about the Beta program for this feature, contact your Marqeta representative.
</Note>

Use the `/credit/rewards/configurations` endpoint to manage the global configurations for a reward program. The global configurations for a reward account are defined in the reward policy on the reward account’s associated bundle.

<h2 id="retrieve_global_config">
  Retrieve global configurations
</h2>

**Action:** `GET`\
**Endpoint:** `/credit/rewards/configurations`

Retrieve global configuration by program short code.

<h3 id="_url_query_parameters">
  URL query parameters
</h3>

| Fields                                            | Description                                                                                        |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| bundleToken<br /><br />string<br /><br />Required | Unique identifier of the bundle.<br /><br />**Allowable Values:**<br /><br />Existing bundle token |

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

| Fields                                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Returned                       | Unique identifier of the global configuration.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                     |
| program\_short\_code<br /><br />string<br /><br />Returned        | Program short code.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                                                |
| accrual\_strategy<br /><br />string<br /><br />Returned           | Reward accrual strategy for program. If no accrual\_strategy is set, default is DEFAULT.<br /><br />- `DEFAULT` - The rewards accrued are based on typical transaction event types such as authorization clearings and refunds.<br />- `PAYMENT` - The rewards accrued are based on payment event types such as completed payments and returned payments.<br /><br />**Allowable Values:**<br /><br />`DEFAULT`, `PAYMENT` |
| settlement\_strategy<br /><br />string<br /><br />Returned        | Reward settlement strategy for program.<br /><br />- `LIVE` - The rewards accrued are posted to the reward account upon processing of the authorization clearing for the transaction.<br />- `STATEMENT` - The rewards accrued are posted to the reward account upon successful statement generation for the transactions.<br /><br />**Allowable Values:**<br /><br />`LIVE`, `STATEMENT`                                 |
| global\_rules<br /><br />array of strings<br /><br />Returned     | Rule description object to apply on a brand-wide level.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more global rules                                                                                                                                                                                                                                                                                |
| bundle\_token<br /><br />string<br /><br />Conditionally returned | Unique identifier of the bundle.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                                   |
| created\_time<br /><br />datetime<br /><br />Returned             | Date and time when the global configuration was created on the Marqeta platform, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                          |
| updated\_time<br /><br />datetime<br /><br />Returned             | Date and time when the global configuration was last updated on the Marqeta platform, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                     |

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

```json JSON lines wrap theme={null}
{
  "token": "ca8439c7-485f-4fa6-a099-2f77b57e3ce5",
  "program_short_code": "shortCodeValue",
  "accrual_strategy": "DEFAULT",
  "settlement_strategy": "STATEMENT",
  "global_rules": [
    "004d0fbb-8874-44ef-b222-c18de77e9acc",
    "f73877d3-7625-4737-883d-d27ab9f5f7e6"
  ],
  "bundle_token": "f0cf97cb-76f7-47a5-83e7-188b9e741cf9",
  "created_time": "2024-01-04T20:37:11Z",
  "updated_time": "2024-01-04T20:37:11Z"
}
```

<h2 id="update_global_config_rules">
  Modify global rules
</h2>

**Action:** `PUT`\
**Endpoint:** `/credit/rewards/configurations/rules`

Modify existing global rules for a reward program.

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

| Fields                                                        | Description                                                                                                                                 |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Required                   | Unique identifier of the global configuration.<br /><br />**Allowable Values:**<br /><br />36 char max                                      |
| global\_rules<br /><br />array of strings<br /><br />Optional | Rule description object to apply on a brand-wide level.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more global rules |

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

```json JSON lines wrap theme={null}
{
  "token": "ca8439c7-485f-4fa6-a099-2f77b57e3ce5",
  "global_rules": [
    "004d0fbb-8874-44ef-b222-c18de77e9acc",
    "f73877d3-7625-4737-883d-d27ab9f5f7e6"
  ]
}
```

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

| Fields                                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Returned                       | Unique identifier of the global configuration.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                     |
| program\_short\_code<br /><br />string<br /><br />Returned        | Program short code.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                                                |
| accrual\_strategy<br /><br />string<br /><br />Returned           | Reward accrual strategy for program. If no accrual\_strategy is set, default is DEFAULT.<br /><br />- `DEFAULT` - The rewards accrued are based on typical transaction event types such as authorization clearings and refunds.<br />- `PAYMENT` - The rewards accrued are based on payment event types such as completed payments and returned payments.<br /><br />**Allowable Values:**<br /><br />`DEFAULT`, `PAYMENT` |
| settlement\_strategy<br /><br />string<br /><br />Returned        | Reward settlement strategy for program.<br /><br />- `LIVE` - The rewards accrued are posted to the reward account upon processing of the authorization clearing for the transaction.<br />- `STATEMENT` - The rewards accrued are posted to the reward account upon successful statement generation for the transactions.<br /><br />**Allowable Values:**<br /><br />`LIVE`, `STATEMENT`                                 |
| global\_rules<br /><br />array of strings<br /><br />Returned     | Rule description object to apply on a brand-wide level.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more global rules                                                                                                                                                                                                                                                                                |
| bundle\_token<br /><br />string<br /><br />Conditionally returned | Unique identifier of the bundle.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                                   |
| created\_time<br /><br />datetime<br /><br />Returned             | Date and time when the global configuration was created on the Marqeta platform, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                          |
| updated\_time<br /><br />datetime<br /><br />Returned             | Date and time when the global configuration was last updated on the Marqeta platform, in UTC.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                                                                                     |

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

```json JSON lines wrap theme={null}
{
  "token": "ca8439c7-485f-4fa6-a099-2f77b57e3ce5",
  "program_short_code": "shortCodeValue",
  "accrual_strategy": "DEFAULT",
  "settlement_strategy": "LIVE",
  "global_rules": [
    "004d0fbb-8874-44ef-b222-c18de77e9acc",
    "f73877d3-7625-4737-883d-d27ab9f5f7e6"
  ],
  "created_time": "2024-01-04T20:37:11Z",
  "updated_time": "2024-01-04T20:37:11Z"
}
```


## Related topics

- [Account Rewards](/docs/core-api/credit-account-rewards.md)
- [About Reward Accounts](/docs/developer-guides/about-credit-reward-accounts.md)
- [Reward Accounts](/docs/core-api/credit-reward-accounts.md)
- [Reward Rules Management](/docs/core-api/credit-reward-rules-management.md)
- [Credit Products in the Marqeta Dashboard](/docs/developer-guides/credit-products-dashboard.md)