Crie sessões para ter cobranças mais seguras e gerenciar Links de Pagamento.

​
Método

import { Malga } from 'malga'

const malga = new Malga({
  apiKey: '17a64c8f-a387-4682-bdd8-d280493715e0',
  clientId: 'd1d2b51a-0446-432a-b055-034518c2660e',
})

await malga.sessions.create({
  merchantId: '8cfef0d1-73af-4bdb-b6c4-09ad3fbfc7f1',
  amount: 100,
  dueDate: '2023-12-31T03:00:00.000Z',
  name: 'Link de Pagamento',
  paymentMethods: [
    { paymentType: 'credit', installments: 1 },
    { paymentType: 'drip' },
    { paymentType: 'nupay' },
    { paymentType: 'pix', expiresIn: 3600 },
    { paymentType: 'boleto', expiresDate: '2023-12-31' },
  ],
  items: [
    {
      name: 'Produto 1',
      unitPrice: 100,
      quantity: 1,
    },
  ],
})

{
	id: 'bbc9d986-b65e-48fe-b879-2e1df10aea87',
	name: 'Link de Pagamento',
	status: 'created',
	isActive: true,
	clientId: 'd1d2b51a-0446-432a-b055-034518c2660e',
	orderId: null,
	amount: 100,
	currency: 'BRL',
	capture: null,
	merchantId: '8cfef0d1-73af-4bdb-b6c4-09ad3fbfc7f1',
	dueDate: '2023-12-31T03:00:00.000Z',
	description: null,
	statementDescriptor: null,
	items: [
		{
			name: 'Produto 1',
			description: null,
			unitPrice: 100,
			quantity: 1,
			tangible: null
		}
	],
	paymentLink: '',
	paymentMethods: [
		{
			paymentType: 'pix',
			expiresIn: 500
		},
		{
			paymentType: 'credit',
			installments: 1,
			recurrence: null
		},
		{
			paymentType: 'boleto',
			expiresDate: '2023-12-31T00:00:00.000Z',
			instructions: null
		},
		{
			paymentType: 'drip',
			successRedirectUrl: null,
			cancelRedirectUrl: null
		},
    {
			paymentType: 'nupay',
			delayToAutoCancel: null,
			orderUrl: null,
			returnUrl: null,
			cancelUrl: null
		},
	],
	createdAt: '2023-01-31T00:00:00.000Z',
	updatedAt: '2023-01-31T00:00:00.000Z',
	publicKey: 'b8d59a73-fd16-4d6b-9e0f-9d7b2a8a7e6d',
}

​
Parâmetros

Lista de todos os parâmetros suportados pelo método.

​
merchantId
uuid
required

ID do Merchant que será usado na sessão

​
amount
number
required

Valor da sessão em centavos

​
dueDate
string
required

Data de expiração da sessão

​
name
string
required

Nome de identificação da sessão

​
paymentMethods
array
required

Dados dos métodos de pagamento disponíveis na sessão

​
items
array
required

Dados dos produtos da sessão

​
description
string

Descrição da sessão

​
statementDescriptor
string

Descrição da cobrança que irá aparecer na fatura do cartão

​
createLink
boolean

Define se deve criar um link para pagamento com a funcionalidade de Link de Pagamento

​
orderId
string

Identificador único da sessão do lado do cliente para conciliação futura

​
currency
string

Moeda que será usada para a sessão

​
isActive
boolean

Define se a sessão está ativa

​
capture
boolean

Define se a sessão deve ser capturada automaticamente