Criar cobrança com voucher

Crie cobranças com cartão voucher (vale-refeição e vale-alimentação) através da API SDK da Malga em Node.js ou PHP, com payload completo.

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 às 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

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

Show Parâmetros do paymentMethod

type · string · required

Método de pagamento que será utilizado na cobrança

Com voucher sempre será voucher

card · object · required

Dados do cartão

Show Parâmetros do card

holderName · string · required

Nome do portador do cartão

number · string · required

Número do cartão

cvv · string · required

Código de segurança do cartão

expirationDate · string · required

Data de validade do cartão

zeroDollar · object

Dados da validação de cartão com Zero Dollar

Show Parâmetros do zeroDollar

merchantId · uuid

ID do Merchant com pelo menos um provedor com suporte ao Zero Dollar

cvvCheck · boolean

Valide o CVV do cartão no momento da criação

items · array

Dados dos produtos do pedido

Show Parâmetros do items

id · string · required

Identificador único do produto

title · string · required

Nome do produto

unitPrice · number · required

Preço do produto

quantity · number · required

Quantidade do produto

linkCardToCustomer · boolean

Vincula o cartão automaticamente com o customer

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

Show Parâmetros do customer

name · string · required

Nome do cliente

email · string · required

E-mail do cliente

phoneNumber · string · required

Telefone do cliente

document · object

Dados do documento do cliente

Show Parâmetros do document

type · string · required

Tipo do documento

number · string · required

Número do documento

country · string

País do documento

address · object

Dados do endereço do cliente

Show Parâmetros do address

city · string · required

Cidade

country · string · required

País

district · string · required

Bairro

state · string · required

Estado

street · string · required

Nome da rua, avenida ou travessa

streetNumber · string · required

Número da rua

zipCode · string · required

Código postal

complement · string

Complemento onde se localiza o endereço, caso exista

splitRules · array

Dados para utilização da funcionalidade de Split

Show Parâmetros do splitRules

sellerId · uuid · required

ID do Recebedor

processingFee · boolean · required

Indica se o recebedor vinculado à regra será cobrado pelas taxas da transação

liable · boolean · required

Indica se o recebedor atrelado assumirá os riscos de chargeback da transação

percentage · number

Porcentagem do valor da transação que será enviada ao recebedor

amount · number

Valor que será enviado ao recebedor

fares · object

Informações sobre as taxas que serão cobradas do recebedor, apenas para sellers com provedor Braspag

Show Parâmetros do fares

mdr · number · required

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

fee · number · required

Indica valor em centavos a ser cobrado por transação capturada. É descontado no momento da “montagem” da agenda financeira

paymentFlow · object

Dados adicionais para uso em condicionais dos Fluxos Inteligentes

Show Parâmetros do paymentFlow

metadata · object

Dados adicionais da cobrança enviados na criação da mesma

appInfo · object

Dados para a rastreabilidade da cobrança

Show Parâmetros do appInfo

device · object

Dados sobre o dispositivo

Show Parâmetros do device

name · string · required

Nome do sistema operacional

version · string · required

Versão do sistema operacional

system · object

Dados sobre o sistema proprietário de captura do merchant

Show Parâmetros do system

name · string · required

Nome da empresa e/ou plataforma

version · string · required

Versão do software da plataforma