Crie cobranças com voucher e comece a transacionar com Malga.

Vouchers funcionam de forma similar aos cartões de crédito na Malga, dessa forma você tem acesso as funcionalidades de tokenização e armazenamento dos seus cartões.

Lembre-se que para gerenciar e armazenar dados de 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 voucher.

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',
  customerId: '2c48166b-51fe-4d8d-a450-1385df8a95b9',
  amount: 100,
  paymentMethod: {
    type: 'voucher',
    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: 'authorized',
	paymentMethod: {
		paymentType: 'voucher',
	},
	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.

merchantId
uuid
required

ID do Merchant que será usado na cobrança

amount
number
required

Valor da cobrança em centavos

paymentMethod
object
required

Dados do pagamento com voucher

orderId
string

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

providerReferenceKey
string

Identificador único da cobrança do lado do cliente utilizado para referenciar a cobrança do lado do provedor

description
string

Descrição da cobrança

statementDescriptor
string

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

currency
string

Moeda que será usada para a cobrança

customerId
uuid

ID do Customer que será usado na cobrança

customer
object

Dados do cliente para criação e vinculação automática à cobrança

splitRules
array

Dados para utilização da funcionalidade de Split

paymentFlow
object

Dados adicionais para uso em condicionais dos Fluxos Inteligentes

appInfo
object

Dados para a rastreabilidade da cobrança