> ## Documentation Index > Fetch the complete documentation index at: https://docs.fincle.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Create card charge > Creates a credit card charge. The response is `200` for both authorized and declined charges, and the outcome is given in `data.status`. ## OpenAPI ````yaml /openapi.yaml post /card openapi: 3.0.3 info: title: Fincle API version: 1.0.0 description: >- Fincle payments API: charges by Pix, credit card and boleto, subscriptions, transactions, refunds, infractions, notifications and transfers. servers: - url: https://api.fincle.com.br description: Production server security: [] tags: - name: Authentication description: Issuance of the access token from the API key. - name: Charges description: Creation of charges by Pix, credit card and boleto. - name: Subscriptions description: Recurring billing on credit card. - name: Transactions description: Retrieval and refund of transactions. - name: Refunds description: Refund requests submitted by payers. - name: Infractions and MED description: Pix infraction reports and the amounts blocked as a result. - name: Webhooks description: Registration of notification endpoints and tracking of deliveries. - name: Balance and transfers description: Balance, statement, fees and transfer of the amounts received. paths: /card: post: tags: - Charges summary: Create card charge description: >- Creates a credit card charge. The response is `200` for both authorized and declined charges, and the outcome is given in `data.status`. operationId: createCardCharge parameters: - name: Idempotency-Key in: header required: false schema: type: string description: >- Idempotency key of the request. Repeating the request with the same key returns the transaction already recorded, without creating a new charge. A universally unique identifier (UUID) is recommended. requestBody: required: true content: application/json: schema: type: object properties: postbackUrl: type: string format: uri amountInCents: type: integer exclusiveMinimum: true minimum: 0 description: type: string card: type: object properties: cardToken: type: string installments: type: integer minimum: 1 maximum: 12 holderName: type: string minLength: 1 required: - cardToken additionalProperties: false items: type: array items: type: object properties: title: type: string tangible: type: boolean quantity: type: integer minimum: 1 maximum: 100000 amountInCents: type: integer minimum: 0 shippingAddress: type: object properties: street: type: string number: type: string neighborhood: type: string city: type: string state: type: string zipCode: type: string required: - street - number - neighborhood - city - state - zipCode additionalProperties: false required: - title - tangible - quantity - amountInCents additionalProperties: false customer: type: object properties: name: type: string email: type: string format: email documentType: type: string enum: - cpf - cnpj document: type: string phone: type: string instagram: type: string billingAddress: type: object properties: street: type: string number: type: string neighborhood: type: string city: type: string state: type: string zipCode: type: string required: - street - number - neighborhood - city - state - zipCode additionalProperties: false required: - documentType - document additionalProperties: false seller: type: object properties: name: type: string documentType: type: string enum: - cpf - cnpj document: type: string phone: type: string averageTicket: type: number address: type: object properties: street: type: string number: type: string neighborhood: type: string city: type: string state: type: string zipCode: type: string required: - street - number - neighborhood - city - state - zipCode additionalProperties: false required: - name - documentType - document additionalProperties: false required: - amountInCents - card - customer additionalProperties: false example: amountInCents: 19900 description: Invoice no. 2026/001042 postbackUrl: https://api.example.com/webhooks/fincle card: cardToken: tok_9f2c1a7b4d6e installments: 3 customer: name: Helena Martins Andrade email: helena.andrade@example.com documentType: cpf document: '31845792041' phone: '11932104567' responses: '200': description: Request processed successfully. content: application/json: schema: type: object properties: success: type: boolean message: type: string data: type: object properties: id: type: string card: type: object properties: token: type: string brand: type: string last4: type: string required: - token - brand - last4 additionalProperties: false status: type: string fees: type: number refuseReason: type: string nullable: true acquirerCode: type: string nullable: true acquirerMessage: type: string nullable: true required: - id - card - status - fees additionalProperties: false required: - success - message additionalProperties: false example: success: true message: Transação aprovada data: id: cmddiqpxo09zf1yju2kqkhgga card: token: tok_9f2c1a7b4d6e brand: visa last4: '1111' status: paid fees: 995 '400': description: Request rejected due to a validation failure or a business rule. content: application/json: schema: type: object properties: success: type: boolean message: type: string required: - success - message example: success: false message: Documento inválido para o tipo selecionado '401': description: Access token missing, invalid or expired. content: application/json: schema: type: object properties: success: type: boolean message: type: string required: - success - message example: success: false message: Não autorizado '429': description: >- Rate limit exceeded or, when the body contains `code: "BUYER_ATTEMPTS_EXCEEDED"`, payer temporarily prevented from using a card. content: application/json: schema: type: object properties: success: type: boolean message: type: string code: type: string blockedUntil: type: string nullable: true description: End of the block, in ISO 8601 UTC. retryAfterSeconds: type: integer nullable: true example: success: false message: >- Você atingiu o número máximo de tentativas de pagamento com cartão. Aguarde o fim do bloqueio para tentar novamente com cartão ou pague com Pix. code: BUYER_ATTEMPTS_EXCEEDED blockedUntil: '2026-11-12T18:30:00.000Z' retryAfterSeconds: 1800 security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.