> ## Documentation Index > Fetch the complete documentation index at: https://developer.finogates.com/llms.txt > Use this file to discover all available pages before exploring further. # Add a Card > Add a card for one of your users. The card starts as `pending_approval` and becomes `active` once Finogate approves it. Webhooks: `payment_method.card.added` now, then `payment_method.card.review_approved` or `.review_rejected`. Sandbox test numbers only. ## OpenAPI ````yaml POST /v1/platform/card-transfers/cards openapi: 3.1.0 info: title: Finogate Platform API v1 version: 0.1.0 servers: - url: https://api-sandbox.finogates.com description: Sandbox - url: https://api.finogates.com description: Production security: [] tags: - name: auth - name: users - name: payees - name: verification - name: bank accounts - name: card processing - name: digital-assets - name: international - name: fees - name: emails - name: email-templates - name: onboarding - name: Redirect URLs - name: pending-applications - name: feature requests - name: wallets - name: payments - name: document mailing - name: merchant onboarding - name: catalog - name: webhooks - name: screening - name: Platform - File Scanning - name: phone-numbers - name: sms - name: calls - name: listings - name: Card Transfers - name: Card Transfers (Sandbox) - name: Accounting - name: check payments - name: check designs - name: embed-tokens paths: /v1/platform/card-transfers/cards: post: tags: - Card Transfers (Sandbox) summary: Add a Card description: >- Add a card for one of your users. The card starts as `pending_approval` and becomes `active` once Finogate approves it. Webhooks: `payment_method.card.added` now, then `payment_method.card.review_approved` or `.review_rejected`. Sandbox test numbers only. operationId: add_card_v1_platform_card_transfers_cards_post requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SandboxCardCreate' responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CommonResponse_SandboxCardRead_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - _AuthenticatedBearer: [] components: schemas: SandboxCardCreate: properties: user_id: type: string format: uuid title: User Id description: The user the card belongs to. card_number: type: string maxLength: 23 minLength: 12 title: Card Number description: >- Any card number, 12 to 19 digits (spaces and dashes are ignored). In sandbox every card reads as a Visa and its transfers settle, except `4000000000000002`, whose transfers are declined. The number is never stored. examples: - '4111111111111111' exp_month: type: integer maximum: 12 minimum: 1 title: Exp Month description: Expiry month (1-12). examples: - 12 exp_year: type: integer maximum: 2100 minimum: 2000 title: Exp Year description: Expiry year, four digits. examples: - 2030 name_on_card: anyOf: - type: string - type: 'null' title: Name On Card description: >- Required. The cardholder's name as printed on the card, up to 120 characters. Shown beside the user's KYC name when Finogate reviews a transfer to the card. examples: - Jane A Doe cvv: anyOf: - type: string - type: 'null' title: Cvv description: >- Required. The card's security code (CVV / CVC), 3 or 4 digits. Used once to verify the card and never stored. In sandbox `000` fails the check (`card_cvv_mismatch`) and the card is not added. examples: - '123' type: object required: - user_id - card_number - exp_month - exp_year title: SandboxCardCreate description: Add a card for one of the platform's users. Sandbox test numbers only. CommonResponse_SandboxCardRead_: properties: status_code: type: integer title: Status Code description: HTTP status code for the response. data: $ref: '#/components/schemas/SandboxCardRead' description: Payload or error details. query_generated_time: type: integer title: Query Generated Time description: >- UTC timestamp (milliseconds since epoch) when response was generated. type: object required: - status_code - data - query_generated_time title: CommonResponse[SandboxCardRead] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SandboxCardRead: properties: card_id: type: string format: uuid title: Card Id description: Use this as `card_id` on transfers. user_id: type: string format: uuid title: User Id brand: anyOf: - type: string - type: 'null' title: Brand last4: anyOf: - type: string - type: 'null' title: Last4 name_on_card: anyOf: - type: string - type: 'null' title: Name On Card description: The name printed on the card. exp_month: anyOf: - type: integer - type: 'null' title: Exp Month exp_year: anyOf: - type: integer - type: 'null' title: Exp Year status: type: string title: Status description: >- `pending_approval` until Finogate approves the card, then `active`. A card awaiting approval can already move money: Finogate approves it together with its first transfer. `rejected` cards cannot be used. application_id: anyOf: - type: string format: uuid - type: 'null' title: Application Id description: The approval request for this card (pending applications). created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At type: object required: - card_id - user_id - status title: SandboxCardRead description: A card added for card transfers. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: _AuthenticatedBearer: type: oauth2 flows: password: scopes: {} tokenUrl: /v1/platform/auth/token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.