> ## Documentation Index > Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt > Use this file to discover all available pages before exploring further. # Create New Card > Creates a new card with the specified details. ## OpenAPI ````yaml /openapi/lynx.yaml post /v2/cards openapi: 3.0.1 info: title: Nayax Operational Lynx API version: v1 servers: - url: https://qa-lynx.nayax.com/operational security: - Authorization: [] paths: /v2/cards: post: tags: - Cards summary: Create New Card description: Creates a new card with the specified details. operationId: create-new-card requestBody: required: true description: The details of the card to be created. content: application/json: schema: $ref: '#/components/schemas/CardCreateDto' responses: '200': description: Card created successfully. content: application/json: schema: $ref: '#/components/schemas/CardGetDto' components: schemas: CardCreateDto: type: object description: >- Represents the data required to create a new card, including details, holder information, credit attributes, and limits. properties: CardDetails: $ref: '#/components/schemas/CardDetailsCreate' description: Detailed information about the card being created. CardHolderDetails: $ref: '#/components/schemas/CardHolderDetailsUpdate' description: Information about the cardholder. CardCreditAttributes: $ref: '#/components/schemas/CardCreditAttributes' description: >- Attributes related to the card's credit, such as currency and limits. CardCreditLimits: $ref: '#/components/schemas/CardCreditLimits' description: Credit limits associated with the card. CardDateRules: $ref: '#/components/schemas/CardDateRules' description: >- Date-related rules for the card, including activation and expiration dates. CardRevalueRewardRules: type: array items: $ref: '#/components/schemas/CardRevalueRewardRuleUpdate' nullable: true description: Rules for revalue rewards associated with the card. GroupLocationLimits: type: array items: $ref: '#/components/schemas/CardGroupLocationLimitUpdate' nullable: true description: Location-based limits for the card groups. additionalProperties: false CardGetDto: type: object description: >- Represents the comprehensive details of a card, including its attributes, limits, usage, and associated rewards and location limits. properties: CardDetails: $ref: '#/components/schemas/CardDetailsGet' description: Detailed information about the card. CardHolderDetails: $ref: '#/components/schemas/CardHolderDetailsGet' description: Information about the cardholder. CardCreditAttributes: $ref: '#/components/schemas/CardCreditAttributes' description: Credit attributes associated with the card. CardCreditLimits: $ref: '#/components/schemas/CardCreditLimits' description: Credit limits associated with the card. CardDateRules: $ref: '#/components/schemas/CardDateRules' description: Date-related rules applied to the card. CardCreditUsage: $ref: '#/components/schemas/CardCreditUsageGet' description: Information on the credit usage of the card. CardRevalueRewardRules: type: array nullable: true description: A list of revalue reward rules associated with the card. items: $ref: '#/components/schemas/CardRevalueRewardRuleGet' GroupLocationLimits: type: array nullable: true description: A list of location limits associated with the card's group. items: $ref: '#/components/schemas/CardGroupLocationLimitGet' additionalProperties: false CardDetailsCreate: type: object description: Represents the basic details required to create a card. properties: ActorID: type: integer format: int64 description: The unique identifier of the actor associated with the card. CardUniqueIdentifier: type: string nullable: true description: The unique identifier assigned to the card. CardDisplayNumber: type: string nullable: true description: The display number of the card. CardTypeID: type: integer format: int32 nullable: true description: The type identifier of the card. enum: - 31 - 33 - 34 - 30000616 x-enumDescriptions: '31': Technician card '33': Prepaid card '34': Refund card '30000616': Discount card PhysicalTypeID: type: integer format: int32 nullable: true description: The physical type identifier of the card. enum: - 30000528 - 30000529 - 30000530 - 30000531 - 943237560 x-enumDescriptions: '30000528': Swipe card '30000529': Contact Card '30000530': Contactless card '30000531': Contactless sticker '943237560': QR Code Notes: type: string nullable: true description: Any additional notes related to the card. Status: $ref: '#/components/schemas/ActiveInactiveEnum' type: integer format: int32 nullable: true description: The status identifier of the card. ExternalApplicationUserID: type: string nullable: true description: The external application user ID associated with the card. additionalProperties: false CardHolderDetailsUpdate: type: object description: Represents the details of the cardholder to be updated or created. properties: CardHolderName: type: string nullable: true description: The name of the cardholder. UserIdentity: type: string nullable: true description: The unique identity or user ID of the cardholder. CountryID: type: integer format: int32 nullable: true description: >- The country identifier associated with the cardholder. Use the [Get Countries](ref:get-countries) endpoint for a full list of available countries. MobileNumber: type: string nullable: true description: The mobile number of the cardholder. Email: type: string nullable: true description: The email address of the cardholder. MemberTypeID: type: integer format: int32 nullable: true description: The membership type identifier associated with the cardholder. enum: - 800 - 801 - 802 - 803 - 804 - 805 - 812 x-enumDescriptions: '800': Bronze '801': Silver '802': Gold '803': Platinum '804': Diamond '805': Emerald '812': Personal additionalProperties: false CardCreditAttributes: type: object description: >- Represents the credit attributes associated with a card, including currency, credit amounts, and revalue options. properties: CurrencyID: type: integer format: int32 nullable: true description: The identifier of the currency used for the card's credit. Credit: type: number format: double nullable: true description: The amount of credit available on the card. RevalueCredit: type: number format: double nullable: true description: The amount of credit added to the card during a revalue operation. CreditTypeMoneyBit: type: boolean nullable: true description: Indicates whether the credit type is money. CreditAccumulateBit: type: boolean nullable: true description: Indicates whether the credit on the card can accumulate over time. CreditSingleUseBit: type: boolean nullable: true description: Indicates whether the credit on the card is for single-use only. RevalueCashBit: type: boolean nullable: true description: Indicates whether the card can be revalued with cash. RevalueCreditCardBit: type: boolean nullable: true description: Indicates whether the card can be revalued with a credit card. AmountMonthlyReload: type: number format: double nullable: true description: The monthly reload amount for the card. TransactionsMonthlyReload: type: integer format: int32 nullable: true description: The number of transactions allowed per month for reloading the card. DiscountTypeBit: type: integer format: int32 nullable: true description: Indicates the type of discount applied to the card. DiscountValue: type: number format: double nullable: true description: The value of the discount applied to the card. additionalProperties: false CardCreditLimits: type: object description: >- Represents the credit limits associated with a card, including daily, weekly, and monthly limits. properties: AmountDailyLimit: type: number format: double nullable: true description: The daily limit on the amount of credit that can be used. AmountWeeklyLimit: type: number format: double nullable: true description: The weekly limit on the amount of credit that can be used. TransactionsDailyLimit: type: integer format: int32 nullable: true description: The daily limit on the number of transactions that can be performed. TransactionsWeeklyLimit: type: integer format: int32 nullable: true description: >- The weekly limit on the number of transactions that can be performed. AmountMonthlyLimit: type: number format: double nullable: true description: The monthly limit on the amount of credit that can be used. TransactionsMonthlyLimit: type: integer format: int32 nullable: true description: >- The monthly limit on the number of transactions that can be performed. DiscountTransactionsTotalLimit: type: integer format: int32 nullable: true description: The total limit on discount transactions. MaxRevalueAmountLimit: type: number format: double nullable: true description: The maximum limit for revalue amounts. WeekDayLimitEnabledBit: type: boolean description: Indicates whether weekday limits are enabled. WeekDayAmountLimit: type: string nullable: true description: The amount limit applied on specific weekdays. WeekDayTransactionLimit: type: string nullable: true description: The transaction limit applied on specific weekdays. additionalProperties: false CardDateRules: type: object description: >- Represents the date rules associated with a card, including activation, expiration, and single-use dates. properties: ActivationDate: type: string format: date-time nullable: true description: The date and time when the card becomes active. ExpirationDate: type: string format: date-time nullable: true description: The date and time when the card expires. RevalueExpirationDate: type: string format: date-time nullable: true description: The date and time when the revalue credit on the card expires. SetSingleUseDate: type: string format: date-time nullable: true description: The date and time when the card is set for single-use. RemoveSingleUseDate: type: string format: date-time nullable: true description: >- The date and time when the single-use restriction is removed from the card. additionalProperties: false CardRevalueRewardRuleUpdate: type: object description: Represents the rules for revalue rewards associated with a card. properties: RuleID: type: integer format: int32 description: The unique identifier of the reward rule. RewardActorID: type: integer format: int64 description: The unique identifier of the actor associated with the reward. Status: type: boolean description: The status of the reward rule (e.g., active or inactive). RevalueAmount: type: number format: double description: The amount required to trigger the reward. RewardValueTypeBit: type: boolean description: Indicates whether the reward is a fixed amount or percentage. RewardValue: type: number format: double description: The value of the reward. additionalProperties: false CardGroupLocationLimitUpdate: type: object description: >- Represents the location-based limits for a card group, including daily limits. properties: CardGroupEnabledBit: type: boolean description: Indicates whether the card group is enabled. GroupName: type: string nullable: true description: The name of the card group. CardGroupId: type: integer format: int64 description: The unique identifier of the card group. GroupDailyLimit: type: integer format: int32 nullable: true description: The daily limit for the card group. additionalProperties: false CardDetailsGet: type: object description: Represents the detailed information of a card. properties: CardID: type: integer format: int64 description: The unique identifier of the card. ActorID: type: integer format: int64 description: The unique identifier of the actor associated with the card. CardUniqueIdentifier: type: string nullable: true description: The unique identifier assigned to the card. CardDisplayNumber: type: string nullable: true description: The display number of the card. CardTypeID: type: integer format: int32 nullable: true description: The type identifier of the card. PhysicalTypeID: type: integer format: int32 nullable: true description: The physical type identifier of the card. Notes: type: string nullable: true description: Any additional notes associated with the card. Status: type: integer format: int32 nullable: true description: The current status of the card. ExternalApplicationUserID: type: string nullable: true description: The external application user ID associated with the card. CreatedBy: type: integer format: int64 nullable: true description: The identifier of the user who created the card. CreatedDT: type: string format: date-time nullable: true description: The date and time when the card was created. UpdatedBy: type: integer format: int64 nullable: true description: The identifier of the user who last updated the card. UpdatedDT: type: string format: date-time description: The date and time when the card was last updated. additionalProperties: false CardHolderDetailsGet: type: object description: >- Represents the details of the cardholder, including personal information and contact details. properties: CardHolderName: type: string nullable: true description: The name of the cardholder. UserIdentity: type: string nullable: true description: The unique identity or user ID of the cardholder. CountryID: type: integer format: int32 nullable: true description: The identifier of the country associated with the cardholder. MobileNumber: type: string nullable: true description: The mobile number of the cardholder. Email: type: string nullable: true description: The email address of the cardholder. MemberTypeID: type: integer format: int32 nullable: true description: >- The identifier representing the type of membership the cardholder has. ImageUrl: type: string nullable: true description: The URL of the cardholder's image. additionalProperties: false CardCreditUsageGet: type: object description: >- Represents the usage details of a card, including daily, weekly, monthly, and total usage amounts and transactions. properties: AmountDailyUsage: type: number format: double nullable: true description: The amount of credit used daily. AmountWeeklyUsage: type: number format: double nullable: true description: The amount of credit used weekly. TransactionsDailyUsage: type: number format: double nullable: true description: The number of transactions performed daily. TransactionsWeeklyUsage: type: number format: double nullable: true description: The number of transactions performed weekly. AmountMonthlyUsage: type: number format: double nullable: true description: The amount of credit used monthly. TransactionsMonthlyUsage: type: number format: double nullable: true description: The number of transactions performed monthly. AmountTotalUsage: type: number format: double nullable: true description: The total amount of credit used. TransactionsTotalUsage: type: number format: double nullable: true description: The total number of transactions performed. AmountCapture: type: number format: double nullable: true description: The amount of credit captured. TransactionsCapture: type: integer format: int32 nullable: true description: The number of transactions captured. CaptureDate: type: string format: date-time nullable: true description: The date and time of the last capture. additionalProperties: false CardRevalueRewardRuleGet: type: object description: >- Represents the revalue reward rule associated with a card, including reward details and status. properties: RuleID: type: integer format: int32 description: The unique identifier of the reward rule. RewardActorID: type: integer format: int64 description: The identifier of the actor receiving the reward. Status: type: boolean description: The current status of the reward rule. RevalueAmount: type: number format: double description: The amount required to trigger the reward. RewardValueTypeBit: type: boolean description: >- Indicates whether the reward value is a fixed amount or a percentage. RewardValue: type: number format: double description: The value of the reward. UpdatedDT: type: string format: date-time description: The date and time when the reward rule was last updated. UpdatedBy: type: integer format: int32 description: The identifier of the user who last updated the reward rule. additionalProperties: false CardGroupLocationLimitGet: type: object description: >- Represents the location limits associated with a card group, including daily limits and update information. properties: CardGroupEnabledBit: type: boolean description: Indicates whether the card group location limit is enabled. GroupName: type: string nullable: true description: The name of the card group. CardGroupId: type: integer format: int64 description: The unique identifier of the card group. GroupDailyLimit: type: integer format: int32 nullable: true description: The daily limit for the card group. UpdatedBy: type: integer format: int64 nullable: true description: The identifier of the user who last updated the location limit. LastUpdated: type: string format: date-time nullable: true description: The date and time when the location limit was last updated. additionalProperties: false ActiveInactiveEnum: enum: - 1 - 2 x-enumDescriptions: '1': Active '2': Inactive securitySchemes: Authorization: type: http scheme: bearer description: Enter your Bearer token. It's required to authenticate API requests. ````