> ## 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. # Create credit product > Create a credit product. POST/credit/products Create a credit product. ## Request body | Fields | Description | | - | - | | token string Optional | Unique identifier of the credit product. **Allowable Values:** 36 char max | | card\_product\_tokens array of strings Required | One or more associated card product tokens. **Allowable Values:** Existing card product tokens | | name string Required | Name of the credit product. **Allowable Values:** 255 char max | | description string Optional | Description of the credit product. **Allowable Values:** 255 char max | | status string Optional | Status of the credit product. - `DRAFT` - The credit product is in the process of being created. - `PENDING_APPROVAL` - The credit product has been created and is awaiting approval. - `SENT_FOR_REVISION` - The credit product has been returned for revision. - `ACTIVE` - The credit product is active. - `REJECTED` - The credit product has been rejected; this status cannot be changed. - `ARCHIVED` - The previously active credit product has been archived. **Allowable Values:** `DRAFT`, `PENDING_APPROVAL`, `SENT_FOR_REVISION`, `ACTIVE`, `REJECTED`, `ARCHIVED` | | classification string Required | Specifies for whom the credit product is intended. - `CONSUMER` - The credit product is intended for individual consumers. - `SMALL_AND_MEDIUM_BUSINESS` - The credit product is intended for small and medium business. **Allowable Values:** `CONSUMER`, `SMALL_AND_MEDIUM_BUSINESS` | | product\_type string Required | Type of credit product. `REVOLVING` - Allows users to continuously borrow and pay debts up to the credit limit. **Allowable Values:** `REVOLVING` | | product\_sub\_type string Required | Subtype of the credit product type. - `CREDIT_CARD` - Card that enables the cardholder to make purchases on credit. - `SECURED_CARD` - Card backed by a user-funded deposit that enables the cardholder to make purchases on credit. **Allowable Values:** `CREDIT_CARD`, `SECURED_CARD` | | currency\_code string Required | Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:** `USD` | | credit\_line object Required | Contains information on the credit line range. **Allowable Values:** Existing `credit_line` object | | credit\_line.**min** decimal Required | Minimum credit limit. **Allowable Values:** 0–999999999999.99 | | credit\_line.**max** decimal Required | Maximum credit limit. **Allowable Values:** 0–999999999999.99 | | usage array of strings Required | One or more usage types for the credit product. **Allowable Values:** `PURCHASE` | | min\_payment\_percentage decimal Required | Minimum payment, expressed as a percentage of the total statement balance, due on the payment due day. **Allowable Values:** 0.0001–100 | | min\_payment\_flat\_amount decimal Required | Minimum payment, expressed as a flat amount, due on the payment due day. **Allowable Values:** 0.01 min | | min\_payment\_calculation object Optional | Contains information used to calculate the minimum payment amount. **Allowable Values:** Existing `min_payment_calculation` object | | min\_payment\_calculation.**include\_past\_due\_amount** boolean Required | Whether to include the past due amount when calculating the minimum payment. **Allowable Values:** `true`, `false` | | min\_payment\_calculation.**min\_payment\_percentage** object Required | Contains information used to calculate the minimum payment percentage. **Allowable Values:** Existing `min_payment_percentage` object | | min\_payment\_calculation.min\_payment\_percentage.**percentage\_of\_balance** decimal Required | Minimum payment, expressed as a percentage of the total statement balance, due on the payment due day. **Allowable Values:** 0.0001–100 | | min\_payment\_calculation.min\_payment\_percentage.**include\_fees\_charged** array of strings Required | One or more fee types to include when calculating the minimum payment. **Allowable Values:** `LATE_PAYMENT_FEE`, `RETURNED_PAYMENT_FEE`, `FOREIGN_TRANSACTION_FEE` | | min\_payment\_calculation.min\_payment\_percentage.**include\_all\_fees\_charged** boolean Optional | Whether to include all fees charged when calculating the minimum payments. **Allowable Values:** `true`, `false` | | min\_payment\_calculation.**min\_payment\_flat\_amount** decimal Required | Minimum payment, expressed as a flat amount, due on the payment due day. **Allowable Values:** 0.01 min | | payment\_allocation\_order array of strings Required | Ordered list of balance types to which payments are allocated, from first to last. **Allowable Values:** `INTEREST`, `FEES`, `PRINCIPAL` | | interest\_calculation object Required | Contains the configurations for interest calculation. **Allowable Values:** Existing `interest_calculation` object | | interest\_calculation.**method** string Required | Method of interest calculation. **Allowable Values:** `AVG_DAILY_BALANCE_WITH_NEW_TRANSACTIONS` | | interest\_calculation.**day\_count** string Required | Day-count convention. **Allowable Values:** `ACTUAL` | | interest\_calculation.**interest\_application** array of strings Required | One or more balance types on which interest is applied. **Allowable Values:** `PRINCIPAL`, `FEES`, `INTEREST` | | interest\_calculation.**minimum\_interest** decimal Required | When interest is applied, this value determines the minimum amount of interest that can be charged. **Allowable Values:** 0–999999999999.99 | | interest\_calculation.**interest\_on\_grace\_reactivation** string Required | Determines whether to charge or waive interest for the billing period when the balance is paid off. **Allowable Values:** `ACCRUE_FULL_CYCLE`, `ACCRUE_PAYMENT_DATE`, `WAIVE` | | interest\_calculation.**grace\_days\_application** string Required | Determines the last day of grace period based on which interest charges are calculated. **Allowable Values:** `NEXT_CYCLE_DATE` | | interest\_calculation.**exclude\_tran\_types** array of strings Optional | One or more transactions that are excluded from current billing period's interest charge, but included in next. **Allowable Values:** `LATE_PAYMENT_FEE`, `ANNUAL_FEE`, `MONTHLY_FEE`, `CASH_BACK_STATEMENT_CREDIT`, `RETURNED_PAYMENT_FEE`, `FOREIGN_TRANSACTION_FEE` | | config object Required | Contains information on configurations for billing cycle day, payment due day, and fees. **Allowable Values:** Existing `config` object | | config.**billing\_cycle\_day** integer Required | Day of the month when the billing cycle starts. **Allowable Values:** 1–28 | | config.**payment\_due\_day** integer Optional | Day of month the payment for the previous billing cycle is due. This field is deprecated. Use the `product.payment_due_interval` field instead. To retrieve `payment_due_interval`, see [Retrieve credit product, config.payment\_due\_interval](https://www.marqeta.com/docs/core-api/credit-products/retrieve-credit-product.md). **Allowable Values:** 31 | | config.**billing\_cycle\_frequency** string Optional | Frequency at which the account is billed. **Allowable Values:** `MONTHLY` | | config.**payment\_due\_interval** integer Optional | Specifies the payment due interval that is used to determine the payment due date for a billing cycle. A value of -1 indicates one day prior to the next billing cycle date. For consumer programs, a minimum gap of 21 days is required between when a statement is delivered and the payment due date. **Allowable Values:** -1 min Positive integers greater than 0; -1 is the default value | | config.**billing\_cycle\_day\_strategy** string Optional | Determines if the billing cycle day is manually set or determined dynamically during account creation based on cycling logic. **Allowable Values:** `MANUAL` | | config.**fees** array of strings Optional | One or more fee types. **Allowable Values:** `LATE_PAYMENT_FEE`, `RETURNED_PAYMENT_FEE`, `FOREIGN_TRANSACTION_FEE` | | config.**periodic\_fees** array of objects Optional | Contains one or more periodic fees. **Allowable Values:** One or more `periodic_fees` objects | | config.periodic\_fees\[].**frequency** string Required | How frequently the fee is charged. **Allowable Values:** `ANNUAL`, `MONTHLY` | | config.periodic\_fees\[].**number\_of\_days\_post\_activation** integer Required | Number of days after an account is activated that the initial fee is charged. For example, if the value in this field is `30`, then the initial fee is charged 30 days after an account is activated. **Allowable Values:** 1–1000 | ## Sample request body ```json JSON expandable lines wrap theme={null} { "card_product_tokens": [ "my_card_product1234" ], "name": "my_credit_product1234", "status": "ACTIVE", "classification": "CONSUMER", "product_type": "REVOLVING", "product_sub_type": "CREDIT_CARD", "currency_code": "USD", "credit_line": { "min": 25, "max": 200000 }, "usage": [ "PURCHASE" ], "min_payment_percentage": 1, "min_payment_flat_amount": 25, "min_payment_calculation": { "include_past_due_amount": true, "include_overlimit_amount": true, "min_payment_percentage": { "percentage_of_balance": 1, "include_interest_charged": false, "include_fees_charged": [ "LATE_PAYMENT_FEE" ] }, "min_payment_flat_amount": 25 }, "payment_allocation_order": [ "INTEREST", "FEES", "PRINCIPAL" ], "interest_calculation": { "method": "AVG_DAILY_BALANCE_WITH_NEW_TRANSACTIONS", "day_count": "ACTUAL", "interest_application": [ "PRINCIPAL", "FEES" ], "minimum_interest": 1, "interest_on_grace_reactivation": "ACCRUE_FULL_CYCLE", "grace_days_application": "NEXT_CYCLE_DATE", "exclude_tran_types": [ "ANNUAL_FEE", "LATE_PAYMENT_FEE", "CASH_BACK_STATEMENT_CREDIT" ] }, "config": { "billing_cycle_day": 1, "payment_due_day": 31, "fees": [ "LATE_PAYMENT_FEE" ], "periodic_fees": [] } } ``` ## Response body | Fields | Description | | - | - | | token string Conditionally returned | Unique identifier of the credit product. **Allowable Values:** 36 char max | | parent\_product\_token string Conditionally returned | Unique identifier of the parent credit product. **Allowable Values:** Existing credit product token | | card\_product\_tokens array of strings Conditionally returned | One or more associated card product tokens. **Allowable Values:** Existing card product tokens | | name string Conditionally returned | Name of the credit product. **Allowable Values:** 255 char max | | description string Conditionally returned | Description of the credit product. **Allowable Values:** 255 char max | | status string Conditionally returned | Status of the credit product. - `DRAFT` - The credit product is in the process of being created. - `PENDING_APPROVAL` - The credit product has been created and is awaiting approval. - `SENT_FOR_REVISION` - The credit product has been returned for revision. - `ACTIVE` - The credit product is active. - `REJECTED` - The credit product has been rejected; this status cannot be changed. - `ARCHIVED` - The previously active credit product has been archived. **Allowable Values:** `DRAFT`, `PENDING_APPROVAL`, `SENT_FOR_REVISION`, `ACTIVE`, `REJECTED`, `ARCHIVED` | | created\_time datetime Conditionally returned | Date and time when the credit product was created on Marqeta's credit platform, in UTC. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | | updated\_time datetime Conditionally returned | Date and time when the credit product was last updated on Marqeta's credit platform, in UTC. **Allowable Values:** Format: yyyy-MM-ddThh:mm:ssZ | | classification string Conditionally returned | Specifies for whom the credit product is intended. - `CONSUMER` - The credit product is intended for individual consumers. - `SMALL_AND_MEDIUM_BUSINESS` - The credit product is intended for small and medium business. **Allowable Values:** `CONSUMER`, `SMALL_AND_MEDIUM_BUSINESS` | | product\_type string Conditionally returned | Type of credit product. `REVOLVING` - Allows users to continuously borrow and pay debts up to the credit limit. **Allowable Values:** `REVOLVING` | | product\_sub\_type string Conditionally returned | Subtype of the credit product type. - `CREDIT_CARD` - Card that enables the cardholder to make purchases on credit. - `SECURED_CARD` - Card backed by a user-funded deposit that enables the cardholder to make purchases on credit. **Allowable Values:** `CREDIT_CARD`, `SECURED_CARD` | | currency\_code string Conditionally returned | Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:** `USD` | | credit\_line object Conditionally returned | Contains information on the credit line range. **Allowable Values:** Existing `credit_line` object | | credit\_line.**min** decimal Returned | Minimum credit limit. **Allowable Values:** 0–999999999999.99 | | credit\_line.**max** decimal Returned | Maximum credit limit. **Allowable Values:** 0–999999999999.99 | | usage array of strings Conditionally returned | One or more usage types for the credit product. **Allowable Values:** `PURCHASE` | | min\_payment\_percentage decimal Conditionally returned | Minimum payment, expressed as a percentage of the total statement balance, due on the payment due day. **Allowable Values:** 0.0001–100 | | min\_payment\_flat\_amount decimal Conditionally returned | Minimum payment, expressed as a flat amount, due on the payment due day. **Allowable Values:** 0.01 min | | min\_payment\_calculation object Conditionally returned | Contains information used to calculate the minimum payment amount. **Allowable Values:** Existing `min_payment_calculation` object | | min\_payment\_calculation.**include\_past\_due\_amount** boolean Returned | Whether to include the past due amount when calculating the minimum payment. **Allowable Values:** `true`, `false` | | min\_payment\_calculation.**min\_payment\_percentage** object Returned | Contains information used to calculate the minimum payment percentage. **Allowable Values:** Existing `min_payment_percentage` object | | min\_payment\_calculation.min\_payment\_percentage.**percentage\_of\_balance** decimal Returned | Minimum payment, expressed as a percentage of the total statement balance, due on the payment due day. **Allowable Values:** 0.0001–100 | | min\_payment\_calculation.min\_payment\_percentage.**include\_fees\_charged** array of strings Returned | One or more fee types to include when calculating the minimum payment. **Allowable Values:** `LATE_PAYMENT_FEE`, `RETURNED_PAYMENT_FEE`, `FOREIGN_TRANSACTION_FEE` | | min\_payment\_calculation.min\_payment\_percentage.**include\_all\_fees\_charged** boolean Conditionally returned | Whether to include all fees charged when calculating the minimum payments. **Allowable Values:** `true`, `false` | | min\_payment\_calculation.**min\_payment\_flat\_amount** decimal Returned | Minimum payment, expressed as a flat amount, due on the payment due day. **Allowable Values:** 0.01 min | | payment\_allocation\_order array of strings Conditionally returned | Ordered list of balance types to which payments are allocated, from first to last. **Allowable Values:** `INTEREST`, `FEES`, `PRINCIPAL` | | interest\_calculation object Conditionally returned | Contains the configurations for interest calculation. **Allowable Values:** Existing `interest_calculation` object | | interest\_calculation.**method** string Returned | Method of interest calculation. **Allowable Values:** `AVG_DAILY_BALANCE_WITH_NEW_TRANSACTIONS` | | interest\_calculation.**day\_count** string Returned | Day-count convention. **Allowable Values:** `ACTUAL` | | interest\_calculation.**interest\_application** array of strings Returned | One or more balance types on which interest is applied. **Allowable Values:** `PRINCIPAL`, `FEES`, `INTEREST` | | interest\_calculation.**minimum\_interest** decimal Returned | When interest is applied, this value determines the minimum amount of interest that can be charged. **Allowable Values:** 0–999999999999.99 | | interest\_calculation.**interest\_on\_grace\_reactivation** string Returned | Determines whether to charge or waive interest for the billing period when the balance is paid off. **Allowable Values:** `ACCRUE_FULL_CYCLE`, `ACCRUE_PAYMENT_DATE`, `WAIVE` | | interest\_calculation.**grace\_days\_application** string Returned | Determines the last day of grace period based on which interest charges are calculated. **Allowable Values:** `NEXT_CYCLE_DATE` | | interest\_calculation.**exclude\_tran\_types** array of strings Conditionally returned | One or more transactions that are excluded from current billing period's interest charge, but included in next. **Allowable Values:** `LATE_PAYMENT_FEE`, `ANNUAL_FEE`, `MONTHLY_FEE`, `CASH_BACK_STATEMENT_CREDIT`, `RETURNED_PAYMENT_FEE`, `FOREIGN_TRANSACTION_FEE` | | config object Conditionally returned | Contains information on configurations for billing cycle day, payment due day, and fees. **Allowable Values:** Existing `config` object | | config.**billing\_cycle\_day** integer Returned | Day of the month when the billing cycle starts. **Allowable Values:** 1–28 | | config.**payment\_due\_day** integer Conditionally returned | Day of month the payment for the previous billing cycle is due. This field is deprecated. Use the `product.payment_due_interval` field instead. To retrieve `payment_due_interval`, see [Retrieve credit product, config.payment\_due\_interval](https://www.marqeta.com/docs/core-api/credit-products/retrieve-credit-product.md). **Allowable Values:** 31 | | config.**billing\_cycle\_frequency** string Conditionally returned | Frequency at which the account is billed. **Allowable Values:** `MONTHLY` | | config.**payment\_due\_interval** integer Conditionally returned | Specifies the payment due interval that is used to determine the payment due date for a billing cycle. A value of -1 indicates one day prior to the next billing cycle date. For consumer programs, a minimum gap of 21 days is required between when a statement is delivered and the payment due date. **Allowable Values:** -1 min Positive integers greater than 0; -1 is the default value | | config.**billing\_cycle\_day\_strategy** string Conditionally returned | Determines if the billing cycle day is manually set or determined dynamically during account creation based on cycling logic. **Allowable Values:** `MANUAL` | | config.**fees** array of strings Conditionally returned | One or more fee types. **Allowable Values:** `LATE_PAYMENT_FEE`, `RETURNED_PAYMENT_FEE`, `FOREIGN_TRANSACTION_FEE` | | config.**periodic\_fees** array of objects Conditionally returned | Contains one or more periodic fees. **Allowable Values:** One or more `periodic_fees` objects | | config.periodic\_fees\[].**frequency** string Returned | How frequently the fee is charged. **Allowable Values:** `ANNUAL`, `MONTHLY` | | config.periodic\_fees\[].**number\_of\_days\_post\_activation** integer Returned | Number of days after an account is activated that the initial fee is charged. For example, if the value in this field is `30`, then the initial fee is charged 30 days after an account is activated. **Allowable Values:** 1–1000 | ## Sample response body ```json JSON expandable lines wrap theme={null} { "token": "my_credit_product_token1234", "card_product_tokens": [ "my_card_product1234" ], "name": "Gold Card", "description": "Description of credit product", "status": "ACTIVE", "created_time": "2021-09-03T19:03:21.035Z", "updated_time": "2021-09-03T19:03:21.035Z", "classification": "CONSUMER", "product_type": "REVOLVING", "product_sub_type": "CREDIT_CARD", "currency_code": "USD", "credit_line": { "min": 25, "max": 200000 }, "usage": [ "PURCHASE" ], "min_payment_percentage": 1, "min_payment_flat_amount": 25, "min_payment_calculation": { "include_past_due_amount": false, "include_overlimit_amount": false, "min_payment_percentage": { "percentage_of_balance": 1, "include_interest_charged": false, "include_fees_charged": [] }, "min_payment_flat_amount": 25 }, "payment_allocation_order": [ "INTEREST", "FEES", "PRINCIPAL" ], "interest_calculation": { "method": "AVG_DAILY_BALANCE_WITH_NEW_TRANSACTIONS", "day_count": "ACTUAL", "interest_application": [ "PRINCIPAL", "FEES" ], "minimum_interest": 1, "interest_on_grace_reactivation": "ACCRUE_FULL_CYCLE", "grace_days_application": "NEXT_CYCLE_DATE", "exclude_tran_types": [ "ANNUAL_FEE", "LATE_PAYMENT_FEE", "CASH_BACK_STATEMENT_CREDIT" ] }, "config": { "billing_cycle_day": 1, "payment_due_day": 31, "fees": [ "LATE_PAYMENT_FEE" ], "periodic_fees": [], "fees_config": [], "rewards_config": [] } } ``` ## Related topics - [Create credit product policy](https://www.marqeta.com/docs/core-api/credit-policies/product-policies/create-product.md) - [Credit Products Overview](https://www.marqeta.com/docs/core-api/credit-products.md) - [Credit Products in the Marqeta Dashboard](https://www.marqeta.com/docs/developer-guides/credit-products-dashboard.md) - [Credit Product Policies Overview](https://www.marqeta.com/docs/core-api/credit-policies/product-policies.md) - [Policies Overview](https://www.marqeta.com/docs/core-api/credit-policies.md)