> ## Documentation Index > Fetch the complete documentation index at: https://docs.malga.io/llms.txt > Use this file to discover all available pages before exploring further. # Criar cobrança com cartão de crédito > API SDK Documentação - Charges Crie cobranças com cartão de crédito e comece a transacionar com Malga. Lembre-se que para gerenciar e armazenar cartões diretamente no seu servidor é necessário o certificado PCI-DSS. Caso sua empresa não tenha o certificado, utilize a tokenização de cartão para a criação de cobranças com cartão de crédito. ### Método ```typescript theme={null} import { Malga } from 'malga' const malga = new Malga({ apiKey: '17a64c8f-a387-4682-bdd8-d280493715e0', clientId: 'd1d2b51a-0446-432a-b055-034518c2660e', }) await malga.charges.create({ merchantId: '8cfef0d1-73af-4bdb-b6c4-09ad3fbfc7f1', amount: 100, paymentMethod: { type: 'credit', installments: 1, card: { holderName: 'João da Silva', number: '5453881028277600', cvv: '170', expirationDate: '10/2030', }, }, }) ``` ```typescript theme={null} { id: 'e09ef791-1aaa-4b11-8173-698f2689a04d', clientId: 'd1d2b51a-0446-432a-b055-034518c2660e', merchantId: '8cfef0d1-73af-4bdb-b6c4-09ad3fbfc7f1', description: null, orderId: null, providerReferenceKey: null, createdAt: '2023-12-31T18:19:44.993Z', amount: 100, originalAmount: 100, currency: 'BRL', statementDescriptor: null, capture: false, isDispute: false, status: 'pre_authorized', paymentMethod: { installments: 1, paymentType: 'credit', }, paymentSource: { sourceType: 'card', cardId: '3db399d3-44c1-49fe-ab26-6fb00c161337', }, transactionRequests: [ { id: 'a6cc6bda-3f6d-4277-8ea2-e4bbd9166f16', createdAt: '2023-12-31T18:19:45.013Z', updatedAt: '2023-12-31T18:19:45.044Z', idempotencyKey: '3b42ede3-15a8-4d81-b6e9-54c5762776c6', providerId: '694f7eee-2966-4825-a847-65d070cbdece', providerType: 'SANDBOX', transactionId: '18242a4d-dd35-475f-b79b-5cbe8f9d1fea', amount: 100, authorizationCode: '123123', authorizationNsu: '123123', requestStatus: 'success', requestType: 'pre_authorization', responseTs: '11ms', providerAuthorization: { networkAuthorizationCode: '123123', networkResponseCode: '123123', } } ], appInfo: null } ``` ### Parâmetros Lista de todos os parâmetros suportados pelo método. Dados do pagamento com cartão Método de pagamento que será utilizado na cobrança
Com cartão de crédito sempre será credit Dados do cartão de crédito Nome do portador do cartão Número do cartão Código de segurança do cartão Data de validade do cartão Dados da validação de cartão com Zero Dollar ID do Merchant com pelo menos um provedor com suporte ao Zero Dollar Valide o CVV do cartão no momento da criação Número de parcelas Vincula o cartão automaticamente com o customer Define se a cobrança deve ser capturada automaticamente Identificador único da cobrança do lado do cliente para conciliação futura Identificador único da cobrança do lado do cliente utilizado para referenciar a cobrança do lado do provedor Descrição da cobrança Descrição da cobrança que irá aparecer na fatura do cartão Moeda que será usada para a cobrança ID do Customer que será usado na cobrança Dados do cliente para criação e vinculação automática à cobrança Nome do cliente E-mail do cliente Telefone do cliente Dados do documento do cliente Tipo do documento Número do documento País do documento Dados do endereço do cliente Cidade País Bairro Estado Nome da rua, avenida ou travessa Número da rua Código postal Complemento onde se localiza o endereço, caso exista Dados para utilização das funcionalidades de antifraude Valor em minutos de SLA máximo de análise do pedido Dados do cliente Nome do cliente E-mail do cliente Telefone do cliente Número do documento do cliente Tipo do documento cliente Data de registro do cliente Dados do endereço de entrega do cliente Cidade País Bairro Estado Nome da rua, avenida ou travessa Número da rua Código postal Complemento onde se localiza o endereço, caso exista Dados do endereço de cobrança do cliente Cidade País Bairro Estado Nome da rua, avenida ou travessa Número da rua Código postal Complemento onde se localiza o endereço, caso exista Dados do navegador do cliente Fingerprint gerado dos dados do navegador Indica se os cookies foram aceitados E-mail logado no navegador Nome do host do usuário Endereço de IP do usuário User-Agent do navegador Dados dos itens do carrinho Nome do produto Quantidade do produto Identificador único do item na loja Preço de cada produto Definição do índice de risco do produto

Os tipos suportados são: Low ou High Descrição do produto Categoria do produto Localidade onde ocorrerá o evento Data do evento Tipo do evento Definição do gênero do evento Dados do ingresso Quantidade total de ingressos à venda Quantidade de vezes que o evento será realizado na casa Taxa de conveniência Quantidade de ingressos com valor integral Quantidade de ingresso com desconto (meia entrada) Lote do ingresso Dados do endereço do evento Cidade País Bairro Estado Nome da rua, avenida ou travessa Número da rua Código postal Complemento onde se localiza o endereço, caso exista Dados do aparelho do cliente Nome do modelo do aparelho Capacidade da memória RAM do aparelho Capacidade de armazenamento do aparelho Quantidade de armazenamento livre do aparelho Resolução do aparelho Dados do sistema operacional do aparelho Tipo do sistema operacional Versão do sistema operacional Dados dos atributos do aparelho Aparelho possui flash na câmera Aparelho pode realizar chamadas Aparelho pode enviar SMS Aparelho possui câmera de vídeo Quantidade de CPUs do aparelho Aparelho possui simulador Linguagem do aparelho Idioma do aparelho Plataforma do sistema operacional Nome do aparelho Família do aparelho Aparelho possui display de retina Aparelho possui câmera Modelo do aparelho Aparelho possui câmera frontal Dados adicionais do aparelho Nome do atributo do fornecedor Valor do atributo do fornecedor Dados para utilização da funcionalidade de Split ID do Recebedor Indica se o recebedor vinculado à regra será cobrado pelas taxas da transação Indica se o recebedor atrelado assumirá os riscos de chargeback da transação Porcentagem do valor da transação que será enviada ao recebedor Valor que será enviado ao recebedor Informações sobre as taxas que serão cobradas do recebedor, apenas para sellers com provedor Braspag Indica o percentual a ser descontado do valor de uma transação, definido por produto (crédito/débito/boleto), bandeira e faixa de parcelamento Indica valor em centavos a ser cobrado por transação capturada. É descontado no momento da “montagem” da agenda financeira Dados para utilização da funcionalidade de 3DS URL para redirecionamento da autenticação URL de origem da requisição Dados do navegador do cliente O Accept do cabeçalho de requisição HTTP A profundidade de cores da tela Indica se o Java está habilitado Indica se o JavaScript está habilitado A linguagem utilizada pelo sistema do usuário Altura da tela Largura da tela Diferença em minutos do deslocamento de fuso horário entre o UTC e a localidade atual O User-Agent do cabeçalho de requisição HTTP Endereço de IP do usuário Dados do endereço de cobrança Cidade País Estado Nome da rua, avenida ou travessa Número da rua Código postal Dados do endereço de envio Cidade País Estado Nome da rua, avenida ou travessa Número da rua Código postal Dados do titular do cartão E-mail do titular do cartão Telefone do titular do cartão Dados adicionais para uso em condicionais dos Fluxos Inteligentes Dados adicionais da cobrança enviados na criação da mesma Dados para a rastreabilidade da cobrança Dados sobre o dispositivo Nome do sistema operacional Versão do sistema operacional Dados sobre o sistema proprietário de captura do merchant Nome da empresa e/ou plataforma Versão do software da plataforma