Tokenization SDK
API SDKs
- Introdução
- Getting started
- Documentação
- Introdução
- Auth
- Charges
- Criar cobrança com cartão de crédito
- Criar cobrança com boleto
- Criar cobrança com Drip
- Criar cobrança com NuPay
- Criar cobrança com PIX
- Criar cobrança com cartão armazenado
- Criar cobrança com session
- Criar cobrança com cartão tokenizado
- Criar cobrança com voucher
- Capturar cobrança
- Buscar cobrança
- Listar cobranças
- Estornar cobrança
- Cards
- Customers
- Sandbox
- Sellers
- Sessions
- Webhooks
- Exemplos
UI SDKs
- Introdução
- Checkout
- Checkout Full
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
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',
},
},
})
{
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
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 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 regisro do cliente
Dados do endereço de entrega do cliente
Dados do endereço de cobrança do cliente
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 aparelho do cliente
Nome do modelo do aparelho
Capacidade da memória RAM do aparelho
Capacidade da armazenamento do aparelho
Quantidade de armazenamento livre do aparelho
Resolução do aparelho
Dados dos atributos do aparelho
Aparelho possui flash na câmera
Aparelho pode realizar chamadas
Aparelho pode enviar SMS
Aparelho possui câmera de video
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 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á enviada 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 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
Was this page helpful?