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
- Node.js
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',
},
},
})
- Response
{
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.object
required
Dados do pagamento com cartão
Show Parâmetros do paymentMethod
Show Parâmetros do paymentMethod
string
required
Método de pagamento que será utilizado na cobrança
Com cartão de crédito sempre será
Com cartão de crédito sempre será
creditobject
required
Dados do cartão de crédito
Show Parâmetros do card
Show Parâmetros do card
string
required
Nome do portador do cartão
string
required
Número do cartão
string
required
Código de segurança do cartão
string
required
Data de validade do cartão
number
required
Número de parcelas
boolean
Vincula o cartão automaticamente com o customer
boolean
Define se a cobrança deve ser capturada automaticamente
string
Identificador único da cobrança do lado do cliente para conciliação futura
string
Identificador único da cobrança do lado do cliente utilizado para referenciar a cobrança do lado do provedor
string
Descrição da cobrança
string
Descrição da cobrança que irá aparecer na fatura do cartão
string
Moeda que será usada para a cobrança
uuid
ID do Customer que será usado na cobrança
object
Dados do cliente para criação e vinculação automática à cobrança
Show Parâmetros do customer
Show Parâmetros do customer
string
required
Nome do cliente
string
required
E-mail do cliente
string
required
Telefone do cliente
object
object
object
Dados para utilização das funcionalidades de antifraude
Show Parâmetros do fraudAnalysis
Show Parâmetros do fraudAnalysis
number
Valor em minutos de SLA máximo de análise do pedido
object
Dados do cliente
Show Parâmetros do customer
Show Parâmetros do customer
string
Nome do cliente
string
E-mail do cliente
string
Telefone do cliente
string
Número do documento do cliente
string
Tipo do documento cliente
string
Data de registro do cliente
object
Dados do endereço de entrega do cliente
object
Dados do endereço de cobrança do cliente
object
Dados do navegador do cliente
object
Dados dos itens do carrinho
Show Parâmetros do cart
Show Parâmetros do cart
array
required
Show Parâmetros do items
Show Parâmetros do items
string
required
Nome do produto
number
required
Quantidade do produto
string
required
Identificador único do item na loja
number
required
Preço de cada produto
string
required
Definição do índice de risco do produto
Os tipos suportados são:
Os tipos suportados são:
Low ou Highstring
Descrição do produto
string
Categoria do produto
string
Localidade onde ocorrerá o evento
string
Data do evento
number
Tipo do evento
string
Definição do gênero do evento
object
Dados do ingresso
object
Dados do aparelho do cliente
Show Parâmetros do device
Show Parâmetros do device
string
Nome do modelo do aparelho
string
Capacidade da memória RAM do aparelho
string
Capacidade de armazenamento do aparelho
number
Quantidade de armazenamento livre do aparelho
number
Resolução do aparelho
object
object
Dados dos atributos do aparelho
Show Parâmetros do vendorAttributes
Show Parâmetros do vendorAttributes
boolean
Aparelho possui flash na câmera
boolean
Aparelho pode realizar chamadas
boolean
Aparelho pode enviar SMS
boolean
Aparelho possui câmera de vídeo
number
Quantidade de CPUs do aparelho
boolean
Aparelho possui simulador
string
Linguagem do aparelho
string
Idioma do aparelho
string
Plataforma do sistema operacional
string
Nome do aparelho
string
Família do aparelho
boolean
Aparelho possui display de retina
boolean
Aparelho possui câmera
string
Modelo do aparelho
boolean
Aparelho possui câmera frontal
array
Dados para utilização da funcionalidade de Split
Show Parâmetros do splitRules
Show Parâmetros do splitRules
uuid
required
ID do Recebedor
boolean
required
Indica se o recebedor vinculado à regra será cobrado pelas taxas da transação
boolean
required
Indica se o recebedor atrelado assumirá os riscos de chargeback da transação
number
Porcentagem do valor da transação que será enviada ao recebedor
number
Valor que será enviado ao recebedor
object
Informações sobre as taxas que serão cobradas do recebedor, apenas para sellers com provedor Braspag
Show Parâmetros do fares
Show Parâmetros do fares
object
Dados para utilização da funcionalidade de 3DS
Show Parâmetros do threeDSecure
Show Parâmetros do threeDSecure
string
required
URL para redirecionamento da autenticação
string
required
URL de origem da requisição
object
required
Dados do navegador do cliente
Show Parâmetros do browser
Show Parâmetros do browser
string
required
O Accept do cabeçalho de requisição HTTP
number
required
A profundidade de cores da tela
boolean
required
Indica se o Java está habilitado
boolean
required
Indica se o JavaScript está habilitado
string
required
A linguagem utilizada pelo sistema do usuário
number
required
Altura da tela
number
required
Largura da tela
string
required
Diferença em minutos do deslocamento de fuso horário entre o UTC e a localidade atual
string
required
O User-Agent do cabeçalho de requisição HTTP
string
required
Endereço de IP do usuário
object
object
object
Dados adicionais para uso em condicionais dos Fluxos Inteligentes
Show Parâmetros do paymentFlow
Show Parâmetros do paymentFlow
object
Dados adicionais da cobrança enviados na criação da mesma
object
Dados para a rastreabilidade da cobrança
Show Parâmetros do appInfo
Show Parâmetros do appInfo
object