Documentação Malga API (0.5)
Download OpenAPI specification:Download
Os serviços de API da Malga são protegidos através de chaves de acesso. Você pode gerenciar suas chaves de acesso através do seu dashboard.
É importante armazenar suas chaves de maneira privada e segura uma vez que elas possuem privilégios de alteração na sua conta. Não compartilhe suas chaves, não deixe elas fixadas no seu código e nem armazene elas no seu servidor de controle de versão. Recomendamos utilizar variáveis de ambiente secretas para deixar a chave disponível para sua aplicação.
A Autenticação para todos os chamadas da API é feita através de headers HTTP, sendo necessário informar seu identificador de cliente na Malga e a chave secreta de acesso.
Identificador única da sua conta na Malga. Deve ser enviado no header obrigatóriamente em todas as requisições feitas a API.
Security Scheme Type | API Key |
---|---|
Header parameter name | X-Client-ID |
Sua chave de acesso a API. Funciona em par com o client-id devendo ser enviado no header obrigatóriamente em todas as requisições feitas a API.
Security Scheme Type | API Key |
---|---|
Header parameter name | X-Api-Key |
curl --location --request GET 'https://api.malga.io/v1/' \
--header 'X-Client-Id: <YOUR_CLIENT_ID>' \
--header 'X-Api-Key: <YOUR_SECRET_KEY>'
É possível criar chaves públicas de acesso temporária a API com escopo e tempo de expiração limitados.
Recomendamos o uso deste tipo de chave quando você tiver que expor a chave em uma aplicação client side.
Detalhe dos parâmetros da chamada de criação da chave pública:
scope | string Enum: "tokens" "charges" "cards" "webhooks" determina o escopo de endpoints que a chave terá acesso |
expires | number Default: 0 prazo de validade da chave em segundos a partir da criação, zero para não expirar |
{- "scope": "tokens",
- "expires": 0
}
Retorno da chamada de criação da chave pública:
scope | string Enum: "tokens" "charges" "cards" "webhooks" determina o escopo de endpoints que a chave terá acesso |
expires | number prazo de validade da chave em segundos a partir da criação, zero para não expirar |
clientId | string <uuid> identificador do cliente na Malga |
publicKey | string <uuid> chave pública criada |
{- "scope": "tokens",
- "expires": 0,
- "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
- "publicKey": "29f62ed2-b67a-44ba-84f5-217ecee94438"
}
Criar nova chave pública para uso no client-side
Authorizations:
Request Body schema: application/json
Creat authentication token
scope | string Enum: "tokens" "charges" "cards" "webhooks" determina o escopo de endpoints que a chave terá acesso |
expires | number Default: 0 prazo de validade da chave em segundos a partir da criação, zero para não expirar |
Responses
Request samples
- Payload
{- "scope": [
- "tokens"
], - "expires": 31104000
}
Response samples
- 201
- 400
- 500
{- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "publicKey": "<YOUR_PUBLIC_KEY>",
- "scope": [
- "tokens"
], - "expires": 31104000,
- "createdAt": "20200110 00:00:00"
}
Dados básicos de uma requisição de criação de card token
cardHolderName required | string Nome do portador do cartão |
cardNumber required | string Número do cartão (Sem espaços) |
cardCvv required | string Código de verificação |
cardExpirationDate required | string Mês e ano de validade no formato MM/YYYY |
{- "cardHolderName": "JOSE DAS NEVES",
- "cardNumber": "4019598346009339",
- "cardCvv": "123",
- "cardExpirationDate": "12/2026"
}
Criar novo token de cartão
Authorizations:
Request Body schema: application/json
Tokenize credit card
cardHolderName required | string Nome do portador do cartão |
cardNumber required | string Número do cartão (Sem espaços) |
cardCvv required | string Código de verificação |
cardExpirationDate required | string Mês e ano de validade no formato MM/YYYY |
Responses
Request samples
- Payload
- Python
{- "cardHolderName": "JOSE DAS NEVES",
- "cardNumber": "4019598346009339",
- "cardCvv": "123",
- "cardExpirationDate": "12/2026"
}
Response samples
- 201
- 400
- 500
{- "id": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000"
}
Dados básicos de um objeto cartão
id | string ID do cartão | ||||||||||||||||||||||||||||||||||||||||||
expirationMonth | string Data de expiração MM | ||||||||||||||||||||||||||||||||||||||||||
expirationYear | string Data de expiração YYYY | ||||||||||||||||||||||||||||||||||||||||||
brand | string Enum: "American Express" "Mastercard" "Visa" "Elo" "Discover" "JCB" "Diners" Bandeira | ||||||||||||||||||||||||||||||||||||||||||
cvvChecked | boolean Identifica se o CVV foi verificado | ||||||||||||||||||||||||||||||||||||||||||
fingerprint | string Hash de identificação única do cartão com base nos dados sensíveis | ||||||||||||||||||||||||||||||||||||||||||
first6digits | string Primeiros 6 digitos do cartão | ||||||||||||||||||||||||||||||||||||||||||
last4digits | string Últimos 4 digitos do cartão | ||||||||||||||||||||||||||||||||||||||||||
status | string Enum: "failed" "active" "pending" Status de validação dos dados cartões, failed (cartão inválido para uso), active (cartão válido para uso), pending (validação do cartão pendente, uso autorizado temporariamente) | ||||||||||||||||||||||||||||||||||||||||||
statusReason | string Contém uma string com um breve descritivo informando o motivo do status do cartão. Em alguns casos uma string vazia é retornada. | ||||||||||||||||||||||||||||||||||||||||||
createdAt | string Data de criação do cartão | ||||||||||||||||||||||||||||||||||||||||||
updatedAt | string Data de atualização do cartão | ||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||
|
{- "id": "string",
- "expirationMonth": "string",
- "expirationYear": "string",
- "brand": "American Express",
- "cvvChecked": true,
- "fingerprint": "string",
- "first6digits": "string",
- "last4digits": "string",
- "status": "failed",
- "statusReason": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "customer": {
- "id": "string",
- "createdAt": "string",
- "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
- "name": "string",
- "email": "string",
- "phoneNumber": "string",
- "document": {
- "type": "string",
- "number": "string",
- "country": "BR"
}, - "address": {
- "country": "string",
- "state": "string",
- "city": "string",
- "district": "string",
- "zipCode": "string",
- "street": "string",
- "streetNumber": "string",
- "complement": "string"
}
}
}
Criar novo cartão a partir de token
Authorizations:
Request Body schema: application/json
Create credit card
tokenId required | string <uuid> Identificador do token gerado |
merchantId | string <uuid> Caso queria validar o cartão via zero dollar, informe o merchantId que possui pelo menos 1 provedor com suporte a validação zero dollar. |
cvvCheck | boolean Mesmo informando o merchantId, é possível desabilitar a validação do cvv (zero dollar). Informe true para validar ou false para pular a validação. Caso você informe false, a verificação será pulada e o cartão será criado como pending necessitando validar via uma transação. |
Responses
Request samples
- Payload
- Python
{- "tokenId": "82aba896-9e37-45b6-aa90-d510c9050596"
}
Response samples
- 201
- 400
- 424
- 500
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "customerId": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "expirationMonth": "12",
- "expirationYear": "2026",
- "brand": "Visa",
- "cvvChecked": true,
- "fingerprint": "cbd4a441-c63c-4dee-ac6b-bfa7fa1df818",
- "first6digits": "401959",
- "last4digits": "9339",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "status": "active",
- "statusReason": ""
}
Listar cartões
Authorizations:
query Parameters
page | number número da página |
limit | number quantidade de itens por página |
Responses
Response Schema: application/json
object | |||||||||||
| |||||||||||
items | array |
Response samples
- 200
- 400
- 500
{- "meta": {
- "itemCount": 10,
- "totalItems": 20,
- "itemsPerPage": 10,
- "totalPages": 5,
- "currentPage": 2
}, - "items": [
- {
- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "customerId": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "expirationMonth": "12",
- "expirationYear": "2026",
- "brand": "Visa",
- "cvvChecked": true,
- "fingerprint": "cbd4a441-c63c-4dee-ac6b-bfa7fa1df818",
- "first6digits": "401959",
- "last4digits": "9339",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "status": "active"
}
]
}
Recuperar detalhes de cartão
Authorizations:
path Parameters
id required | string <uuid> ID do cartão |
Responses
Response Schema: application/json
id | string ID do cartão | ||||||||||||||||||||||||||||||||||||||||||
expirationMonth | string Data de expiração MM | ||||||||||||||||||||||||||||||||||||||||||
expirationYear | string Data de expiração YYYY | ||||||||||||||||||||||||||||||||||||||||||
brand | string Enum: "American Express" "Mastercard" "Visa" "Elo" "Discover" "JCB" "Diners" Bandeira | ||||||||||||||||||||||||||||||||||||||||||
cvvChecked | boolean Identifica se o CVV foi verificado | ||||||||||||||||||||||||||||||||||||||||||
fingerprint | string Hash de identificação única do cartão com base nos dados sensíveis | ||||||||||||||||||||||||||||||||||||||||||
first6digits | string Primeiros 6 digitos do cartão | ||||||||||||||||||||||||||||||||||||||||||
last4digits | string Últimos 4 digitos do cartão | ||||||||||||||||||||||||||||||||||||||||||
status | string Enum: "failed" "active" "pending" Status de validação dos dados cartões, failed (cartão inválido para uso), active (cartão válido para uso), pending (validação do cartão pendente, uso autorizado temporariamente) | ||||||||||||||||||||||||||||||||||||||||||
statusReason | string Contém uma string com um breve descritivo informando o motivo do status do cartão. Em alguns casos uma string vazia é retornada. | ||||||||||||||||||||||||||||||||||||||||||
createdAt | string Data de criação do cartão | ||||||||||||||||||||||||||||||||||||||||||
updatedAt | string Data de atualização do cartão | ||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||
|
Response samples
- 200
- 400
- 424
- 500
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "customerId": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "expirationMonth": "12",
- "expirationYear": "2026",
- "brand": "Visa",
- "cvvChecked": true,
- "fingerprint": "cbd4a441-c63c-4dee-ac6b-bfa7fa1df818",
- "first6digits": "401959",
- "last4digits": "9339",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "status": "active",
- "statusReason": ""
}
Através da API de customers
é possível realizar a criação, edição, listagem e exclusão de dados de compradores para uso nos serviços de tokenização de cartões, cobrança por PIX, Boleto, uso em análise de motores de anti fraude e recorrência.
A fim de manter maior integridade dos dados, as informações de email e documento (CPF/CNJP) são únicos para customers na sua conta Malga, não podendo existir dois compradores iguais.
Consulte a tabela de tipos de paises e documentos suportados para criação de customer
- Crie um
customer
informando os dados básicos de identificação e endereço - Crie um novo
token
de cartão a partir dos dados do portador - Crie um novo
card
a partir do token gerado e guarde o cardId gerado para associação futura com o customer - Associe o
card
criado com ocustomer
criado através do serviço de associação de cartão com comprador - Liste os cartões vinculados ao comprador através do serviço de listagem de cartões por customer
curl --location --request POST 'https://api.malga.io/v1/customers' \
--header 'X-Client-Id: <YOUR_CLIENT_ID>' \
--header 'X-Api-Key: <YOUR_SECRET_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Jose Bonifacio Da Silveira",
"phoneNumber": "21 98889999099",
"email": "jose@gmail.com",
"document": {
"number": "72912053013",
"type": "cpf",
"country": "BR"
},
"address": {
"country": "BR",
"state": "Rio de Janeiro",
"city": "Rio de Janeiro",
"district": "Leblon",
"zipCode": "25650-011",
"street": "Av Geraldo Cardoso",
"streetNumber": "205",
"complement": "Apto 203"
}
}'
- Crie um
customer
informando os dados básicos de identificação e endereço - Crie um novo
charge
informando comopaymentSource
o customer criado previamente, dessa forma iremos utilizar os dados do comprador para geração da cobrança.
Dados básicos de um objeto do tipo customer
id | string identificador do customer | ||||||||||||||||
createdAt | string data de criação | ||||||||||||||||
clientId | string <uuid> identificador do client | ||||||||||||||||
name | string nome do usuario | ||||||||||||||||
string email do usuario | |||||||||||||||||
phoneNumber | string telefones de contato do usuario | ||||||||||||||||
object | |||||||||||||||||
| |||||||||||||||||
object | |||||||||||||||||
|
{- "id": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "name": "Customer test",
- "email": "jose2@gmail.com",
- "document": {
- "number": "97055503019",
- "type": "cpf",
- "country": "BR"
}, - "phoneNumber": "21 98889999099",
- "address": {
- "country": "BR",
- "state": "Rio de Janeiro",
- "city": "Rio de Janeiro",
- "district": "Leblon",
- "zipCode": "25650011",
- "street": "Av Geraldo Cardoso",
- "streetNumber": "205",
- "complement": "Apto 203"
}
}
Criação de novo customer para cobrança
Authorizations:
Request Body schema: application/json
name required | string nome do usuario | ||||||||||||||||
email required | string email do usuario | ||||||||||||||||
phoneNumber required | string telefone de contato do usuario | ||||||||||||||||
required | object | ||||||||||||||||
| |||||||||||||||||
object | |||||||||||||||||
|
Responses
Request samples
- Payload
{- "name": "Customer test",
- "email": "jose2@gmail.com",
- "phoneNumber": "21 98889999099",
- "document": {
- "number": "97055503019",
- "type": "cpf",
- "country": "BR"
}, - "address": {
- "country": "BR",
- "state": "Rio de Janeiro",
- "city": "Rio de Janeiro",
- "district": "Leblon",
- "zipCode": "25650011",
- "street": "Av Geraldo Cardoso",
- "streetNumber": "205",
- "complement": "Apto 203"
}
}
Listagem de customers cadastrados
Authorizations:
query Parameters
page | number número da página |
limit | number quantidade de itens por página |
sort | string Enum: "ASC" "DESC" ordenação dos itens |
id | string identificador de um customer |
document.type | string tipo de documento |
document.number | string numero do documento |
Responses
Response Schema: application/json
object | |||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||||||
|
Response samples
- 200
- 400
- 500
{- "meta": {
- "itemCount": 10,
- "totalItems": 20,
- "itemsPerPage": 10,
- "totalPages": 5,
- "currentPage": 2
}, - "items": [
- {
- "id": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "name": "Customer test",
- "email": "jose2@gmail.com",
- "phoneNumber": "21 98889999099",
- "document": {
- "number": "97055503019",
- "type": "cpf",
- "country": "BR"
}, - "address": {
- "country": "BR",
- "state": "Rio de Janeiro",
- "city": "Rio de Janeiro",
- "district": "Leblon",
- "zipCode": "25650011",
- "street": "Av Geraldo Cardoso",
- "streetNumber": "205",
- "complement": "Apto 203"
}
}
]
}
Recuperar detalhes de customer
Authorizations:
path Parameters
id required | string <uuid> id do customers que deseja recuperar |
Responses
Response Schema: application/json
id | string identificador do customer | ||||||||||||||||
createdAt | string data de criação | ||||||||||||||||
clientId | string <uuid> identificador do client | ||||||||||||||||
name | string nome do usuario | ||||||||||||||||
string email do usuario | |||||||||||||||||
phoneNumber | string telefones de contato do usuario | ||||||||||||||||
object | |||||||||||||||||
| |||||||||||||||||
object | |||||||||||||||||
|
Response samples
- 200
- 400
- 500
{- "id": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "name": "Customer test",
- "email": "jose2@gmail.com",
- "document": {
- "number": "97055503019",
- "type": "cpf",
- "country": "BR"
}, - "phoneNumber": "21 98889999099",
- "address": {
- "country": "BR",
- "state": "Rio de Janeiro",
- "city": "Rio de Janeiro",
- "district": "Leblon",
- "zipCode": "25650011",
- "street": "Av Geraldo Cardoso",
- "streetNumber": "205",
- "complement": "Apto 203"
}
}
Atualizar customer pelo id
Authorizations:
path Parameters
id required | string <uuid> id do customers que deseja alterar |
Request Body schema: application/json
name | string nome do usuario | ||||||||||||||||
phoneNumber | string telefone de contato do usuario | ||||||||||||||||
object | |||||||||||||||||
|
Responses
Request samples
- Payload
{- "name": "string",
- "phoneNumber": "string",
- "address": {
- "country": "string",
- "state": "string",
- "city": "string",
- "district": "string",
- "zipCode": "string",
- "street": "string",
- "streetNumber": "string",
- "complement": "string"
}
}
Adicionar cartão de crédito ao customer
Authorizations:
path Parameters
customer_id required | string <uuid> id do customers que deseja alterar |
Request Body schema: application/json
cardId required | string Identificador do cartão a ser associado |
Responses
Request samples
- Payload
{- "cardId": "82aba896-9e37-45b6-aa90-d510c9050596"
}
Listagem dos cartões do customer
Authorizations:
path Parameters
customer_id required | string <uuid> id do customers que deseja alterar |
Responses
Response Schema: application/json
object | |||||||||||
| |||||||||||
items | array |
Response samples
- 200
{- "meta": {
- "itemCount": 10,
- "totalItems": 20,
- "itemsPerPage": 10,
- "totalPages": 5,
- "currentPage": 2
}, - "items": [
- {
- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "customerId": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "expirationMonth": "12",
- "expirationYear": "2026",
- "brand": "Visa",
- "cvvChecked": true,
- "fingerprint": "cbd4a441-c63c-4dee-ac6b-bfa7fa1df818",
- "first6digits": "401959",
- "last4digits": "9339",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "status": "active"
}
]
}
Para realizar uma cobrança deve criar um objeto charge
. É possível recuperar detalhes de transações individuais ou listar todas as cobranças realizadas em um determinado merchant
. Os charges
são identificados a partir de um id 'único'.
Dados básicos de um objeto do tipo charge
id | string identificador da transação | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId | string <uuid> identificador do cliente na Malga | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
merchantId | string <uuid> identificador do merchant id utilizado na transação | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customerId | string <uuid> identificador do customer id | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
description | string Descrição da cobrança para consulta futura | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
amount | number valor da transação em centavos, exemplo 100 para cobrar R$ 1,00 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
currency | string Default: "BRL" Identificador da moeda para processamento da cobrança, formato ISO 4217. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
statementDescriptor | string descrição a ser exibida na fatura do comprador | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
capture | boolean determina se a transação deve ser capturada automaticamente | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isDispute | boolean determina se a transação está em disputa | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status | string Enum: "pending" "pre_authorized" "authorized" "failed" "canceled" "voided" "refund_pending" "charged_back" status da transação na Malga | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
orderId | string Identificador único da cobrança do lado do cliente para conciliação futura | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PaymentMethodCardObject (object) or PaymentMethodPixObject (object) or PaymentMethodBoletoObject (object) or PaymentMethodNuPayObject (object) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
One of
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SourceTypeCardObject (object) or SourceTypeTokenObject (object) or SourceTypeCustomerObject (object) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
One of
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdAt | string Data de criação do cartão | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updatedAt | string Data de atualização do cartão | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Parâmetros adicionais para analise de fraude | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Campos adicionais para uso em condicionais dos fluxos inteligentes | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects (TransactionRequest) [ items ] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (3DSecure2Response) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "amount": 150,
- "currency": "BRL",
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "statementDescriptor": "LOJA JOAO",
- "description": "Descrição longa da cobrança",
- "capture": false,
- "isDispute": false,
- "status": "pre_authorized",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "cardId": "148d5db0-f1c3-439f-902d-f1f268086e1d"
}, - "transactionRequests": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
- "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
- "providerType": "STRIPE",
- "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
- "amount": 1500,
- "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
- "requestStatus": "success",
- "requestType": "authorization",
- "responseTs": "2633ms",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:42.212Z",
- "providerAuthorization": {
- "networkAuthorizationCode": "00",
- "networkResponseCode": ""
}
}
]
}
Realizar nova cobrança
Authorizations:
Request Body schema: application/json
merchantId required | string <uuid> Identificação do merchant id a ser utilizado | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
amount required | number Valor da transação em centavos, exemplo 100 para cobrar R$ 1,00 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
currency | string Default: "BRL" Identificador da moeda para processamento da cobrança, formato ISO 4217. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
statementDescriptor | string Descrição a ser exibida fatura do comprador | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
capture | boolean Default: false Determina se a transação deve ser capturada automaticamente | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
orderId | string Identificador único da cobrança do lado do cliente para conciliação futura | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
description | string Descrição da cobrança para consulta futura | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customerId | string <uuid> Identificador de comprador para consulta futura | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | PaymentMethodCard (object) or PaymentMethodPix (object) or PaymentMethodBoleto (object) or PaymentMethodNuPay (object) Define o método de cobrança | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
One of
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | SourceTypeCard (object) or SourceTypeCardOneShot (object) or SourceTypeToken (object) or SourceTypeCustomer (object) or SourceTypeCustomerOneShot (object) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
One of
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Parâmetros adicionais para analise de fraude, obrigatório quando anti-fraude ligado. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects (SplitRules) [ items ] Parâmetros adicionais para transacionar com Split | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Campos adicionais para uso em condicionais dos fluxos inteligentes | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Parâmetros adicionais para transacionar com 3D Secure 2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "merchantId": "7f8870a2-71c9-4ef0-a531-82000e00b7e1",
- "amount": 150,
- "currency": "BRL",
- "statementDescriptor": "LOJA JOAO",
- "description": "Descrição longa da cobrança",
- "capture": false,
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "card": {
- "cardNumber": "5261424250184574",
- "cardCvv": "321",
- "cardExpirationDate": "06/2028",
- "cardHolderName": "JOAO DA SILVA"
}
}
}
Response samples
- 201
- 400
- 500
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "amount": 150,
- "currency": "BRL",
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "statementDescriptor": "LOJA JOAO",
- "description": "Descrição longa da cobrança",
- "capture": false,
- "isDispute": false,
- "status": "pre_authorized",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "cardId": "148d5db0-f1c3-439f-902d-f1f268086e1d"
}, - "transactionRequests": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
- "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
- "providerType": "STRIPE",
- "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
- "amount": 1500,
- "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
- "requestStatus": "success",
- "requestType": "authorization",
- "responseTs": "2633ms",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:42.212Z",
- "providerAuthorization": {
- "networkAuthorizationCode": "00",
- "networkResponseCode": ""
}
}
]
}
Listar cobranças
Authorizations:
query Parameters
page | number numero da pagina ativa |
limit | number quantidade de registros por página 1-100 |
sort | string Enum: "ASC" "DESC" tipo de ordenação decrescente ou crescente |
merchantId | string <uuid> id do merchant processado na cobrança |
id | string <uuid> id da cobrança |
originalAmount | number valor em centavos da cobrança |
status | string Enum: "pending" "pre_authorized" "authorized" "voided" "refund_pending" "canceled" "charged_back" status da cobrança |
paymentType | string Enum: "credit" "pix" "boleto" tipo de pagamento |
orderId | string id da cobrança gerado pelo cliente |
created | string Example: created=2022-03-12T12:43:53 registros criados em uma data específica |
created.gt | string Example: created.gt=2022-03-12T12:43:53 registros com data maior que |
created.lt | string Example: created.lt=2022-03-12T12:43:53 registros com data menor que |
Responses
Response Schema: application/json
object | |||||||||||
| |||||||||||
items | array |
Response samples
- 200
- 400
- 500
{- "meta": {
- "itemCount": 10,
- "totalItems": 20,
- "itemsPerPage": 10,
- "totalPages": 5,
- "currentPage": 2
}, - "items": [
- {
- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "customerId": "82aba896-9e37-45b6-aa90-d510c9050596",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "amount": 150,
- "currency": "BRL",
- "statementDescriptor": "LOJA JOAO",
- "description": "Descrição longa da cobrança",
- "capture": false,
- "isDispute": false,
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "cardId": "148d5db0-f1c3-439f-902d-f1f268086e1d"
}, - "transactionRequests": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
- "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
- "providerType": "STRIPE",
- "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
- "amount": 1500,
- "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
- "requestStatus": "success",
- "requestType": "authorization",
- "responseTs": "2633ms",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:42.212Z",
- "providerAuthorization": {
- "networkAuthorizationCode": "00",
- "networkResponseCode": ""
}
}
]
}
]
}
Recuperar detalhes de cobrança
Authorizations:
path Parameters
id required | string <uuid> id da cobrança que deseja recuperar |
Responses
Response Schema: application/json
object | |||||||||||
| |||||||||||
items | array |
Response samples
- 200
- 400
- 500
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "amount": 150,
- "currency": "BRL",
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "statementDescriptor": "LOJA JOAO",
- "description": "Descrição longa da cobrança",
- "capture": false,
- "isDispute": false,
- "status": "pre_authorized",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "cardId": "148d5db0-f1c3-439f-902d-f1f268086e1d"
}, - "transactionRequests": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
- "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
- "providerType": "STRIPE",
- "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
- "amount": 1500,
- "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
- "requestStatus": "success",
- "requestType": "authorization",
- "responseTs": "2633ms",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:42.212Z",
- "providerAuthorization": {
- "networkAuthorizationCode": "00",
- "networkResponseCode": ""
}
}
]
}
Alterar o status de uma cobrança no ambiente de sandbox
Authorizations:
path Parameters
id required | string <uuid> id da cobrança que deseja alterar no sandbox |
Request Body schema: application/json
status | string Enum: "pending" "pre_authorized" "authorized" "failed" "canceled" "voided" "charged_back" "created" "processed" "capture_pending" "refund_pending" status da transação |
Responses
Response Schema: application/json
id | string identificador da transação | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId | string <uuid> identificador do cliente na Malga | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
merchantId | string <uuid> identificador do merchant id utilizado na transação | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customerId | string <uuid> identificador do customer id | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
description | string Descrição da cobrança para consulta futura | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
amount | number valor da transação em centavos, exemplo 100 para cobrar R$ 1,00 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
currency | string Default: "BRL" Identificador da moeda para processamento da cobrança, formato ISO 4217. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
statementDescriptor | string descrição a ser exibida na fatura do comprador | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
capture | boolean determina se a transação deve ser capturada automaticamente | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isDispute | boolean determina se a transação está em disputa | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status | string Enum: "pending" "pre_authorized" "authorized" "failed" "canceled" "voided" "refund_pending" "charged_back" status da transação na Malga | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
orderId | string Identificador único da cobrança do lado do cliente para conciliação futura | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PaymentMethodCardObject (object) or PaymentMethodPixObject (object) or PaymentMethodBoletoObject (object) or PaymentMethodNuPayObject (object) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
One of
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SourceTypeCardObject (object) or SourceTypeTokenObject (object) or SourceTypeCustomerObject (object) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
One of
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdAt | string Data de criação do cartão | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
updatedAt | string Data de atualização do cartão | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Parâmetros adicionais para analise de fraude | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Campos adicionais para uso em condicionais dos fluxos inteligentes | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects (TransactionRequest) [ items ] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (3DSecure2Response) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Request samples
- Payload
{- "status": "charged_back"
}
Response samples
- 200
- 400
- 500
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "amount": 150,
- "currency": "BRL",
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "statementDescriptor": "LOJA JOAO",
- "description": "Descrição longa da cobrança",
- "capture": false,
- "isDispute": false,
- "status": "pre_authorized",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "cardId": "148d5db0-f1c3-439f-902d-f1f268086e1d"
}, - "transactionRequests": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
- "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
- "providerType": "STRIPE",
- "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
- "amount": 1500,
- "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
- "requestStatus": "success",
- "requestType": "authorization",
- "responseTs": "2633ms",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:42.212Z",
- "providerAuthorization": {
- "networkAuthorizationCode": "00",
- "networkResponseCode": ""
}
}
]
}
Capturar cobrança pre-autorizada
Authorizations:
path Parameters
id required | string <uuid> id da cobrança que deseja capturar |
Request Body schema: application/json
amount | number valor da captura em centavos não podendo ser maior que o valor da transação, exemplo 100 para cobrar R$ 1,00 |
Responses
Request samples
- Payload
{- "amount": 150
}
Response samples
- 201
- 400
- 500
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "amount": 150,
- "currency": "BRL",
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "statementDescriptor": "LOJA JOAO",
- "description": "Descrição longa da cobrança",
- "capture": false,
- "isDispute": false,
- "status": "pre_authorized",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "cardId": "148d5db0-f1c3-439f-902d-f1f268086e1d"
}, - "transactionRequests": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
- "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
- "providerType": "STRIPE",
- "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
- "amount": 1500,
- "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
- "requestStatus": "success",
- "requestType": "authorization",
- "responseTs": "2633ms",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:42.212Z",
- "providerAuthorization": {
- "networkAuthorizationCode": "00",
- "networkResponseCode": ""
}
}
]
}
Estornar cobrança aprovada
Authorizations:
path Parameters
id required | string <uuid> id da cobrança que deseja estornar |
Request Body schema: application/json
amount | number valor do estorno em centavos não podendo ser maior que o valor da transação, exemplo 100 para cobrar R$ 1,00 |
delayToCompose | number número de dias para compor o valor a ser estornado. Utilizado apenas pela NuPay. |
Responses
Request samples
- Payload
{- "amount": 150
}
Response samples
- 201
- 400
- 500
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "amount": 150,
- "currency": "BRL",
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "statementDescriptor": "LOJA JOAO",
- "description": "Descrição longa da cobrança",
- "capture": false,
- "isDispute": false,
- "status": "pre_authorized",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "cardId": "148d5db0-f1c3-439f-902d-f1f268086e1d"
}, - "transactionRequests": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
- "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
- "providerType": "STRIPE",
- "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
- "amount": 1500,
- "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
- "requestStatus": "success",
- "requestType": "authorization",
- "responseTs": "2633ms",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:42.212Z",
- "providerAuthorization": {
- "networkAuthorizationCode": "00",
- "networkResponseCode": ""
}
}
]
}
Através da API de sessões é possível criar um pedido, composto por itens, métodos de pagamento e outros atributos, que pode ser pago através de um endpoint ou integrado ao MalgaCheckout.
- Crie uma
sessão
informando os dados básicos necessários - Utilize a
publicKey
retornada na criação ou recuperada na rota de detalhes noX-Api-Key
para autenticar o pagamento
Dados básicos de um objeto do tipo session
id | string Identificação da sessão a ser utilizada | ||||||||||
name | string Nome que identifica a sessão | ||||||||||
status | string Enum: "created" "paid" "canceled" "voided" Status da sessão | ||||||||||
isActive | boolean Determina se a sessão está ativa | ||||||||||
clientId | string Identificador do cliente na Malga | ||||||||||
orderId | string Identificador único da cobrança do lado do cliente para conciliação futura | ||||||||||
amount | number Valor da transação em centavos, exemplo 100 para cobrar R$ 1,00 | ||||||||||
currency | string Identificador da moeda para processamento da cobrança, formato ISO 4217. | ||||||||||
capture | boolean Determina se a transação deve ser capturada automaticamente | ||||||||||
merchantId | string Identificação do merchant id a ser utilizado | ||||||||||
dueDate | string Data de expiração de uma sessão | ||||||||||
description | string Descrição da sessão | ||||||||||
statementDescriptor | string Descrição a ser exibida fatura do comprador | ||||||||||
Array of objects (SessionItemObject) [ items ] Itens do pedido | |||||||||||
Array
| |||||||||||
paymentLink | string Link para acessar o Link de Pagamento desta sessão | ||||||||||
PaymentMethodCardObject (array) or PaymentMethodPixObject (array) or PaymentMethodBoletoObject (array) Métodos de pagamento disponíveis na sessão | |||||||||||
One of array | |||||||||||
createdAt | string Data de criação da sessão | ||||||||||
updatedAt | string Data da atualização da sessão | ||||||||||
publicKey | string Chave de acesso com escopo restrito, usada para pagar a sessão |
{- "id": "1b0c6960-702a-4074-95c2-eed2790c16a1",
- "name": "Nome da sessão",
- "status": "created",
- "isActive": true,
- "clientId": "1b0c6960-702a-4074-95c2-eed2790c16a1",
- "orderId": null,
- "amount": 100,
- "currency": "BRL",
- "capture": true,
- "merchantId": "69aea152-ba70-49a3-a31c-044ac1651146",
- "dueDate": "2022-10-25T09:28:45.000Z",
- "description": "Promoção Black Friday",
- "statementDescriptor": "LOJA JOAO",
- "paymentMethods": [
- {
- "paymentType": "credit",
- "installments": 1
}
], - "items": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "name": "Item 1",
- "description": "Descrição do item",
- "unitPrice": 10000,
- "quantity": 1,
- "tangible": false
}
], - "createdAt": "2022-10-25T09:28:45.000Z",
- "updatedAt": "2022-10-25T09:28:45.000Z",
- "publicKey": "1b0c6960-702a-4074-95c2-eed2790c16a1"
}
Criar nova sessão
Authorizations:
Request Body schema: application/json
orderId | string Identificador único da cobrança do lado do cliente para conciliação futura | ||||||||||
amount required | number Valor da transação em centavos, exemplo 100 para cobrar R$ 1,00 | ||||||||||
currency | string Default: "BRL" Identificador da moeda para processamento da cobrança, formato ISO 4217. | ||||||||||
isActive | boolean Determina se a sessão está ativa | ||||||||||
capture | boolean Determina se a transação deve ser capturada automaticamente | ||||||||||
merchantId required | string Identificação do merchant id a ser utilizado | ||||||||||
dueDate required | string Data de expiração de uma sessão | ||||||||||
name required | string Nome que identifica a sessão | ||||||||||
description | string Descrição da sessão | ||||||||||
statementDescriptor | string Descrição a ser exibida fatura do comprador | ||||||||||
createLink | boolean Determina se a sessão terá um Link de Pagamento | ||||||||||
required | PaymentMethodCardObject (object) or PaymentMethodPixObjectRequest (object) or PaymentMethodBoletoObjectRequest (object) Métodos de pagamento disponíveis na sessão | ||||||||||
Any of
| |||||||||||
required | Array of objects (SessionItemObject) [ items ] Itens do pedido | ||||||||||
Array
|
Responses
Request samples
- Payload
{- "amount": 100,
- "name": "Loja 1",
- "merchantId": "1b0c6960-702a-4074-95c2-eed2790c16a1",
- "dueDate": "2022-10-25T09:28:45.000Z",
- "paymentMethods": [
- {
- "paymentType": "pix",
- "expiresIn": 30
}
], - "items": [
- {
- "name": "Item 1",
- "description": "Item do carrinho",
- "unitPrice": 1000,
- "quantity": 1,
- "tangible": false
}
]
}
Response samples
- 201
{- "id": "c1db83fa-723c-4e1f-9722-bc19d1be6791",
- "name": "Pedido 1",
- "status": "created",
- "isActive": true,
- "clientId": "39d2d314-5412-431a-b34b-74f9f0fbe7e1",
- "orderId": "b84b7694-d22f-4083-bee7-c1274b16eb4a",
- "amount": 100,
- "currency": "BRL",
- "capture": true,
- "merchantId": "9930c8d9-a7a8-4039-9faf-3715ad87baf8",
- "dueDate": "2022-10-26T19:32:08.000Z",
- "description": "Pedido Black Friday",
- "statementDescriptor": "LOJA JOAO",
- "items": [
- {
- "name": "Item 1",
- "description": "Item do carrinho",
- "unitPrice": 1000,
- "quantity": 1,
- "tangible": false
}
], - "paymentMethods": [
- {
- "paymentType": "pix",
- "expiresIn": 30
}
], - "createdAt": "2022-10-25T22:49:06.588Z",
- "updatedAt": "2022-10-25T22:49:06.588Z",
- "publicKey": "8be71cdf-01dc-4b1a-823a-4c58be6e4cf1"
}
Recuperar detalhes de uma sessão
Authorizations:
path Parameters
id required | string <uuid> Identificação da sessão a ser recuperada |
Responses
Response samples
- 201
{- "id": "c1db83fa-723c-4e1f-9722-bc19d1be6791",
- "name": "Pedido 1",
- "status": "created",
- "isActive": true,
- "clientId": "39d2d314-5412-431a-b34b-74f9f0fbe7e1",
- "orderId": "b84b7694-d22f-4083-bee7-c1274b16eb4a",
- "amount": 100,
- "currency": "BRL",
- "capture": true,
- "merchantId": "9930c8d9-a7a8-4039-9faf-3715ad87baf8",
- "dueDate": "2022-10-26T19:32:08.000Z",
- "description": "Pedido Black Friday",
- "statementDescriptor": "LOJA JOAO",
- "items": [
- {
- "name": "Item 1",
- "description": "Item do carrinho",
- "unitPrice": 1000,
- "quantity": 1,
- "tangible": false
}
], - "paymentMethods": [
- {
- "paymentType": "pix",
- "expiresIn": 30
}
], - "createdAt": "2022-10-25T22:49:06.588Z",
- "updatedAt": "2022-10-25T22:49:06.588Z",
- "publicKey": "8be71cdf-01dc-4b1a-823a-4c58be6e4cf1"
}
Pagar uma sessão
Authorizations:
path Parameters
id required | string <uuid> Identificação da sessão a ser paga |
Request Body schema: application/json
customerId | string <uuid> Identificador de comprador para consulta futura | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | PaymentMethodCard (object) or PaymentMethodPix (object) or PaymentMethodBoleto (object) Define o método de cobrança | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
One of
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | SourceTypeCard (object) or SourceTypeCardOneShot (object) or SourceTypeToken (object) or SourceTypeCustomer (object) or SourceTypeCustomerOneShot (object) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
One of
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Parâmetros adicionais para analise de fraude, obrigatório quando anti-fraude ligado. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "card": {
- "cardNumber": "5261424250184574",
- "cardCvv": "321",
- "cardExpirationDate": "06/2028",
- "cardHolderName": "JOAO DA SILVA"
}
}
}
Response samples
- 201
{- "id": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "merchantId": "148d5db0-f1c3-439f-902d-f1f268086e1d",
- "description": "Descrição longa da cobrança",
- "orderId": "32c68ff7-902c-408b-b464-cf487c7cda97",
- "createdAt": "2012-06-30 23:59:59 +0000",
- "amount": 150,
- "originalAmount": 150,
- "currency": "BRL",
- "statementDescriptor": "LOJA JOAO",
- "status": "pending",
- "paymentMethod": {
- "paymentType": "credit",
- "installments": 1
}, - "paymentSource": {
- "sourceType": "card",
- "cardId": "148d5db0-f1c3-439f-902d-f1f268086e1d"
}, - "transactionRequests": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "idempotencyKey": "fafe857b176e45d6b12e32fcaf228996",
- "providerId": "2c3b57d8-ee43-4b19-bc8a-949a88c51df1",
- "providerType": "STRIPE",
- "transactionId": "ch_3JYE7MHjGFBGEeiP0lfTD3Ob",
- "amount": 1500,
- "authorizationNsu": "1cc8391c-f0d5-4b7a-9fcf-653cea26be13",
- "requestStatus": "success",
- "requestType": "authorization",
- "responseTs": "2633ms",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:42.212Z",
- "providerAuthorization": {
- "networkAuthorizationCode": "00",
- "networkResponseCode": ""
}
}
]
}
Recuperar o histórico da sessão
Authorizations:
path Parameters
id required | string <uuid> Identificação da sessão a ser recuperada |
Responses
Response samples
- 201
[- {
- "status": "created",
- "id": "82aba896-9e37-45b6-aa90-d510c9050596",
- "createdAt": "2022-11-11T16:35:38.870Z",
- "updatedAt": "2022-11-11T16:35:38.870Z"
}
]
Recupera sessão com os dados das configurações da empresa
Authorizations:
path Parameters
id required | string <uuid> Identificação da sessão a ser recuperada |
Responses
Response samples
- 201
{- "id": "1b0c6960-702a-4074-95c2-eed2790c16a1",
- "name": "Nome da sessão",
- "status": "created",
- "isActive": true,
- "clientId": "1b0c6960-702a-4074-95c2-eed2790c16a1",
- "orderId": null,
- "amount": 100,
- "currency": "BRL",
- "capture": true,
- "merchantId": "69aea152-ba70-49a3-a31c-044ac1651146",
- "dueDate": "2022-10-25T09:28:45.000Z",
- "description": "Promoção Black Friday",
- "statementDescriptor": "LOJA JOAO",
- "paymentMethods": [
- {
- "paymentType": "credit",
- "installments": 1
}
], - "items": [
- {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "name": "Item 1",
- "description": "Descrição do item",
- "unitPrice": 10000,
- "quantity": 1,
- "tangible": false
}
], - "createdAt": "2022-10-25T09:28:45.000Z",
- "updatedAt": "2022-10-25T09:28:45.000Z",
- "publicKey": "1b0c6960-702a-4074-95c2-eed2790c16a1",
- "settings": {
- "id": "78601913-a176-4d71-b7e8-abb6fc49a340",
- "email": "company@email.com",
- "phone": "5551996225566",
- "statementDescription": "LOJA JOAO",
- "mainColor": "#fff000",
- "secondaryColor": "#fff000",
- "attentionColor": "#333333",
- "errorColor": "#ff0000",
- "successColor": "#00FF00",
- "backgroundColor": "#fff000",
- "companyName": "Company Name",
- "clientId": "1b0c6960-702a-4074-95c2-eed2790c16a1",
- "documentNumber": "011001001001000010",
- "language": "pt_BR"
}
}
Para realizar uma cobrança com Split, antes é necessário criar um seller
. Os sellers
são identificados a partir de um id 'único'.
Através das APIs de sellers
é possível realizar a criação e configuração de recebedores que serão beneficiados em um Split. Uma recebedor, ou um seller
, é um cadastro de pessoa física ou jurídica para quem você tenha interesse em repassar automaticamente valores de uma determinada cobrança.
Observe que os campos owner
e business
são opcionais. Entretanto se o provider for Zoop e o campo business
for enviado, o owner
se torna obrigatório.
merchantId required | string identificação do merchant id a ser utilizado | ||||||||||||||||||||||||||||||||||||||
mcc required | number código de segmento do lojista no adquirente, solicite ao seu provedor caso não saiba qual o seu Merchant Category Code. | ||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
required | object | ||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
required | object | ||||||||||||||||||||||||||||||||||||||
|
{- "merchantId": "5616b19e-4d99-4bd3-b415-4990e5cab4f4",
- "mcc": 4040,
- "business": {
- "name": "Seller business test",
- "phoneNumber": "21 98889999099",
- "email": "seller@gmail.com",
- "openingDate": "27-01-1995",
- "document": {
- "number": "94938591000196",
- "type": "cnpj",
- "country": "BR"
}, - "address": {
- "country": "BR",
- "state": "Rio de Janeiro",
- "city": "Rio de Janeiro",
- "district": "Leblon",
- "zipCode": "25650011",
- "street": "Av Geraldo Cardoso",
- "streetNumber": "205",
- "complement": "Apto 203"
}, - "bankAccount": {
- "holderName": "Seller Name",
- "holderDocument": "36243319067",
- "bank": "077",
- "branchNumber": "492",
- "branchCheckDigit": "1",
- "accountNumber": "4929",
- "accountCheckDigit": "12",
- "type": "conta_corrente"
}
}, - "transferPolicy": {
- "transferDay": "5",
- "transferInterval": "monthly",
- "transferEnabled": true
}
}
Criar um novo recebedor
Authorizations:
Request Body schema: application/json
merchantId | string identificação do merchant | ||||||||||||||||||||||||||||||||||||||
mcc | string código de segmento do lojista no adquirente | ||||||||||||||||||||||||||||||||||||||
Array of objects (SellerProviders) [ items ] | |||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "merchantId": "5616b19e-4d99-4bd3-b415-4990e5cab4f4",
- "mcc": 4040,
- "business": {
- "name": "Seller business test",
- "phoneNumber": "21 98889999099",
- "email": "seller@gmail.com",
- "openingDate": "27-01-1995",
- "document": {
- "number": "94938591000196",
- "type": "cnpj",
- "country": "BR"
}, - "address": {
- "country": "BR",
- "state": "Rio de Janeiro",
- "city": "Rio de Janeiro",
- "district": "Leblon",
- "zipCode": "25650011",
- "street": "Av Geraldo Cardoso",
- "streetNumber": "205",
- "complement": "Apto 203"
}, - "bankAccount": {
- "holderName": "Seller Name",
- "holderDocument": "36243319067",
- "bank": "077",
- "branchNumber": "492",
- "branchCheckDigit": "1",
- "accountNumber": "4929",
- "accountCheckDigit": "12",
- "type": "conta_corrente"
}
}, - "transferPolicy": {
- "transferDay": "5",
- "transferInterval": "monthly",
- "transferEnabled": true
}
}
Response samples
- 201
- 400
- 500
{- "id": "ea115e44-7048-11ed-a1eb-0242ac120002",
- "merchantId": "5616b19e-4d99-4bd3-b415-4990e5cab4f4",
- "mcc": 4040,
- "providers": [
- {
- "id": "f218697a-7048-11ed-a1eb-0242ac120002",
- "providerType": "SANDBOX",
- "status": "active",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:39.536Z"
}
], - "business": {
- "name": "Seller test",
- "phoneNumber": "21 98889999099",
- "email": "seller@gmail.com",
- "openingDate": "27-01-1995",
- "document": {
- "number": "97055503019",
- "type": "cpf",
- "country": "BR"
}, - "address": {
- "country": "BR",
- "state": "Rio de Janeiro",
- "city": "Rio de Janeiro",
- "district": "Leblon",
- "zipCode": "25650011",
- "street": "Av Geraldo Cardoso",
- "streetNumber": "205",
- "complement": "Apto 203"
}, - "bankAccount": {
- "id": "242b9be8-cd60-461d-af27-f31e3d6e3fb7",
- "updateAT": "2023-02-28T18:00:00.573Z",
- "createdAt": "2023-02-28T18:00:00.573Z",
- "holderName": "Gustavo Gottardi",
- "holderDocument": "40413246884",
- "bank": "341",
- "branchNumber": "1578",
- "branchCheckDigit": "0",
- "accountNumber": "03661",
- "accountCheckDigit": "6",
- "type": "conta_corrente"
}, - "transferPolicy": {
- "transferDay": "5",
- "transferInterval": "monthly",
- "transferEnabled": true
}, - "metadata": null
}
}
Recuperar seller pelo id
Authorizations:
path Parameters
id required | string <uuid> id do seller |
Responses
Response Schema: application/json
merchantId | string identificação do merchant | ||||||||||||||||||||||||||||||||||||||
mcc | string código de segmento do lojista no adquirente | ||||||||||||||||||||||||||||||||||||||
Array of objects (SellerProviders) [ items ] | |||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
object | |||||||||||||||||||||||||||||||||||||||
|
Response samples
- 200
{- "id": "ea115e44-7048-11ed-a1eb-0242ac120002",
- "merchantId": "5616b19e-4d99-4bd3-b415-4990e5cab4f4",
- "mcc": 4040,
- "providers": [
- {
- "id": "f218697a-7048-11ed-a1eb-0242ac120002",
- "providerType": "SANDBOX",
- "status": "active",
- "createdAt": "2021-08-12T16:08:39.536Z",
- "updatedAt": "2021-08-12T16:08:39.536Z"
}
], - "business": {
- "name": "Seller test",
- "phoneNumber": "21 98889999099",
- "email": "seller@gmail.com",
- "openingDate": "27-01-1995",
- "document": {
- "number": "97055503019",
- "type": "cpf",
- "country": "BR"
}, - "address": {
- "country": "BR",
- "state": "Rio de Janeiro",
- "city": "Rio de Janeiro",
- "district": "Leblon",
- "zipCode": "25650011",
- "street": "Av Geraldo Cardoso",
- "streetNumber": "205",
- "complement": "Apto 203"
}, - "bankAccount": {
- "id": "242b9be8-cd60-461d-af27-f31e3d6e3fb7",
- "updateAT": "2023-02-28T18:00:00.573Z",
- "createdAt": "2023-02-28T18:00:00.573Z",
- "holderName": "Gustavo Gottardi",
- "holderDocument": "40413246884",
- "bank": "341",
- "branchNumber": "1578",
- "branchCheckDigit": "0",
- "accountNumber": "03661",
- "accountCheckDigit": "6",
- "type": "conta_corrente"
}, - "transferPolicy": {
- "transferDay": "5",
- "transferInterval": "monthly",
- "transferEnabled": true
}, - "metadata": null
}
}
A Malga utiliza o serviço de webhooks para notificar o seu sistema sobre os eventos ocorridos na nossa plataforma. Através de webhooks você consegue atualizar seu sistema sempre que um evento importante acontece, como a atualização de status de uma cobrança para confirmar ou cancelar um determinado pagamento.
Dados básicos de um objeto do tipo event:
id | string identificador único do evento, também enviado no header |
createdAt | string data de criação do evento |
object | string Tipo do objeto atualizado |
event | string Tipo do evento de atualização que ocorreu no objeto atualizado |
apiVersion | number Versão da api da Malga que seu webhook implementa |
data | object Dados do objeto alterado com base na definição do schema de cada objeto |
{- "id": "5616b19e-4d99-4bd3-b415-4990e5cab4f4",
- "apiVersion": "1.1",
- "object": "transaction",
- "event": "authorized",
- "createdAt": "2021-07-05T18:56:08.672Z",
- "data": {
- "id"": "242b9be8-cd60-461d-af27-f31e3d6e3fb7",
- "updatedAt"": "2021-07-05T18:56:08.247Z",
- "createdAt"": "2021-07-05T18:56:08.247Z",
- "amount"": 1500,
- "currency": "BRL",
- "originalAmount"": 1500,
- "installments"": 1,
- "clientId"": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "description"": null,
- "statementDescriptor"": "LOJA JOAO",
- "status"": "authorized",
- "capture"": true,
- "fee"": null,
- "feeAmount"": null
}
}
Criação de novo webhook para notificação
Authorizations:
Request Body schema: application/json
event required | string Evento que deseja receber notificações no seu webhook conforme descrito na seção Eventos suportados para notificação via webhooks. Deve ser criado um webhook para cada evento, podendo ser utilizado o wildcard |
endpoint required | string URL do seu sistema que deverá receber as notificações de evento |
version required | number Default: 1.1 Versão da api da Malga que seu webhook implementa |
status required | boolean Default: true Enum: true false Identifica se o webhooks está ativo ou não para receber notificações de evento da Malga |
Responses
Request samples
- Payload
{- "event": "transaction.authorized",
- "version": 1.1,
- "status": true
}
Response samples
- 201
{- "id": "31c142ad-4c30-4964-ba24-2df0f2bbb745",
- "event": "transaction.authorized",
- "version": 1.1,
- "publicKey": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAnFQSIT7Mwg5QLeJLAwhAJx9wS+XsQvnyph/Lz7AJyQA=\n-----END PUBLIC KEY-----\n",
- "status": true,
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2021-07-06T21:03:36.590Z",
- "updatedAt": "2021-07-06T21:03:36.590Z"
}
Listagem de webhooks cadastrados
Authorizations:
query Parameters
page | number número da página |
limit | number quantidade de itens por página |
Responses
Response Schema: application/json
object | |||||||||||||||||
| |||||||||||||||||
object | |||||||||||||||||
|
Response samples
- 200
- 400
- 500
{- "meta": {
- "itemCount": 10,
- "totalItems": 20,
- "itemsPerPage": 10,
- "totalPages": 5,
- "currentPage": 2
}, - "items": [
- {
- "id": "31c142ad-4c30-4964-ba24-2df0f2bbb745",
- "event": "transaction.authorized",
- "version": 1.1,
- "publicKey": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAnFQSIT7Mwg5QLeJLAwhAJx9wS+XsQvnyph/Lz7AJyQA=\n-----END PUBLIC KEY-----\n",
- "status": true,
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2021-07-06T21:03:36.590Z",
- "updatedAt": "2021-07-06T21:03:36.590Z"
}
]
}
Recuperar detalhes de webhook
Authorizations:
path Parameters
id required | string <uuid> id do webhook que deseja recuperar |
Responses
Response Schema: application/json
id | string identificador do webhook |
createdAt | string data de criação |
clientId | string <uuid> identificador do client |
event | string Tipo do evento que deseja receber notificações no seu webhook |
endpoint | string URL do seu sistema que deverá receber as notificações de evento |
version | number Default: 1.1 Versão da api da Malga que seu webhook implementa |
publicKey | string Chave pública ed25519 |
status | boolean Default: true Identifica se o webhooks está ativo ou não para receber notificações de evento da Malga |
Response samples
- 200
- 400
- 500
{- "id": "31c142ad-4c30-4964-ba24-2df0f2bbb745",
- "event": "transaction.authorized",
- "version": 1.1,
- "publicKey": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEAnFQSIT7Mwg5QLeJLAwhAJx9wS+XsQvnyph/Lz7AJyQA=\n-----END PUBLIC KEY-----\n",
- "status": true,
- "clientId": "cc0b1e41-2936-45c5-947f-93995ffcdc00",
- "createdAt": "2021-07-06T21:03:36.590Z",
- "updatedAt": "2021-07-06T21:03:36.590Z"
}
Atualizar webhook pelo id
Authorizations:
path Parameters
id required | string <uuid> id do webhook que deseja alterar |
Request Body schema: application/json
event required | string Evento que deseja receber notificações no seu webhook conforme descrito na seção Eventos suportados para notificação via webhooks. Deve ser criado um webhook para cada evento, podendo ser utilizado o wildcard |
endpoint required | string URL do seu sistema que deverá receber as notificações de evento |
version required | number Default: 1.1 Versão da api da Malga que seu webhook implementa |
status required | boolean Default: true Enum: true false Identifica se o webhooks está ativo ou não para receber notificações de evento da Malga |
Responses
Request samples
- Payload
{- "event": "string",
- "endpoint": "string",
- "version": 1.1,
- "status": true
}
Através das APIs de merchants
é possível realizar a criação e configuração de sub contas na Malga. Uma sub conta, ou um merchant
, é um cadastro de estabelecimento comercial que você tenha junto há um dos provedores de pagamentos integrados pela Malga. Uma vez que você tenha uma conta criada em um dos provedores aceitos, basta você solicitar suas credenciais de acesso ao parceiro e configurar seu cadastro na Malga.
No cadastro de merchant
é necessário informar o código da categoria mcc
do seu cadastro junto ao provedor, escolher um dos tipos de provedores suportados pela Malga, e definir a prioridade do provedor com suas credenciais de acesso à API do provedor.
O sistema de roteamento inteligente de transações da Malga foi desenvolvido de maneira a suportar o uso de múltiplos provedores por cadastro de estabelecimento. Usamos a prioridade definida no cadastro dos provedores para priorizar um determinado provedor em relação à outro, dessa forma você consegue gerenciar a ordem de provedores que será utilizado para fazer as retentativas.
Consulte a tabela de provedores aceitos para cadastro de credenciais
Consulte a tabela de código MCC para cadastro de Merchants
Dados básicos do objeto do tipo merchant
id | string dentificador do merchant | ||||||||||||||||||||||||
createdAt | string data de criação | ||||||||||||||||||||||||
clientId | string <uuid> identificador do client | ||||||||||||||||||||||||
mcc | string codigo mcc do cadatro do lojista no adquirente | ||||||||||||||||||||||||
status | string Enum: "active" "deleted" "pending" status do merchant | ||||||||||||||||||||||||
object (ProviderDto) | |||||||||||||||||||||||||
|
{- "id": "69aea152-ba70-49a3-a31c-044ac1651146",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "clientId": "523afbe7-36dc-4654-9dba-e7167d0e5e2d",
- "mcc": "4040",
- "status": true,
- "providers": [
- {
- "id": "72cc1ff1-5f6e-4eb2-9cc5-6a3a85525e4b",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "name": "PagSeguro",
- "priority": 1,
- "credentials": {
- "type": "PAGSEGURO",
- "token": "1B2B32530CA23412AB63843240F5633",
- "email": "email@gmail.com"
}
}, - {
- "id": "2cf5c350-ee26-4557-a47d-9efe1765df51",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "deletedAt": null,
- "idempotencyKey": null,
- "requestId": null,
- "name": "pagarme",
- "priority": 2,
- "credentials": {
- "type": "PAGARME",
- "apiKey": "ak_test_Kaa8pfXJ3WOUdCsMQiRYuV66rJZLuA"
}
}
]
}
Criação de novo merchant para cobrança
Authorizations:
Request Body schema: application/json
mcc required | string código de segmento do lojista no adquirente, solicite ao seu provedor caso não saiba qual o seu Merchant Category Code. | ||||||||||||||||||||||||
object (ProviderDto) | |||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "mcc": "4040",
- "status": true,
- "providers": [
- {
- "name": "PagSeguro",
- "priority": 1,
- "credentials": {
- "type": "PAGSEGURO",
- "token": "1B2B32530CA24641324AB63843240F5633",
- "email": "email@gmail.com"
}
}, - {
- "name": "pagarme",
- "priority": 2,
- "credentials": {
- "type": "PAGARME",
- "apiKey": "ak_test_Kaa8pf3142dCsMQiRYuV66rJZLuA"
}
}
]
}
Response samples
- 201
{- "id": "69aea152-ba70-49a3-a31c-044ac1651146",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "clientId": "523afbe7-36dc-4654-9dba-e7167d0e5e2d",
- "mcc": "4040",
- "status": true,
- "providers": [
- {
- "id": "72cc1ff1-5f6e-4eb2-9cc5-6a3a85525e4b",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "name": "PagSeguro",
- "priority": 1,
- "credentials": {
- "type": "PAGSEGURO",
- "token": "1B2B32530CA23412AB63843240F5633",
- "email": "email@gmail.com"
}
}, - {
- "id": "2cf5c350-ee26-4557-a47d-9efe1765df51",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "deletedAt": null,
- "idempotencyKey": null,
- "requestId": null,
- "name": "pagarme",
- "priority": 2,
- "credentials": {
- "type": "PAGARME",
- "apiKey": "ak_test_Kaa8pfXJ3WOUdCsMQiRYuV66rJZLuA"
}
}
]
}
Listagem de merchants cadastrados
Authorizations:
query Parameters
page | number número da página |
limit | number quantidade de itens por página |
Responses
Response Schema: application/json
object | |||||||||||||||||||||||
| |||||||||||||||||||||||
object | |||||||||||||||||||||||
|
Response samples
- 200
{- "meta": {
- "itemCount": 10,
- "totalItems": 20,
- "itemsPerPage": 10,
- "totalPages": 5,
- "currentPage": 2
}, - "items": [
- {
- "id": "69aea152-ba70-49a3-a31c-044ac1651146",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "clientId": "523afbe7-36dc-4654-9dba-e7167d0e5e2d",
- "mcc": "4040",
- "status": true,
- "providers": [
- {
- "id": "72cc1ff1-5f6e-4eb2-9cc5-6a3a85525e4b",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "name": "PagSeguro",
- "priority": 1,
- "credentials": {
- "type": "PAGSEGURO",
- "token": "1B2B32530CA2464F8AB63843240F5633",
- "email": "email@gmail.com"
}
}, - {
- "id": "2cf5c350-ee26-4557-a47d-9efe1765df51",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "deletedAt": null,
- "idempotencyKey": null,
- "requestId": null,
- "name": "pagarme",
- "priority": 2,
- "credentials": {
- "type": "PAGARME",
- "apiKey": "ak_test_Kaa8pfXJ3WOUdCsMQiRYuV66rJZLuA"
}
}
]
}
]
}
Recuperar detalhes de merchant pelo id
Authorizations:
path Parameters
id required | string <uuid> id do merchant |
Responses
Response Schema: application/json
id | string dentificador do merchant | ||||||||||||||||||||||||
createdAt | string data de criação | ||||||||||||||||||||||||
clientId | string <uuid> identificador do client | ||||||||||||||||||||||||
mcc | string codigo mcc do cadatro do lojista no adquirente | ||||||||||||||||||||||||
status | string Enum: "active" "deleted" "pending" status do merchant | ||||||||||||||||||||||||
object (ProviderDto) | |||||||||||||||||||||||||
|
Response samples
- 200
{- "id": "69aea152-ba70-49a3-a31c-044ac1651146",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "clientId": "523afbe7-36dc-4654-9dba-e7167d0e5e2d",
- "mcc": "4040",
- "status": true,
- "providers": [
- {
- "id": "72cc1ff1-5f6e-4eb2-9cc5-6a3a85525e4b",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "name": "PagSeguro",
- "priority": 1,
- "credentials": {
- "type": "PAGSEGURO",
- "token": "1B2B32530CA23412AB63843240F5633",
- "email": "email@gmail.com"
}
}, - {
- "id": "2cf5c350-ee26-4557-a47d-9efe1765df51",
- "updatedAt": "2021-03-12T15:57:20.239Z",
- "createdAt": "2021-03-12T15:57:20.239Z",
- "deletedAt": null,
- "idempotencyKey": null,
- "requestId": null,
- "name": "pagarme",
- "priority": 2,
- "credentials": {
- "type": "PAGARME",
- "apiKey": "ak_test_Kaa8pfXJ3WOUdCsMQiRYuV66rJZLuA"
}
}
]
}
Atualizar configurações de merchant
Authorizations:
path Parameters
id required | string <uuid> id do merchant |
Request Body schema: application/json
mcc | string código de segmento do lojista no adquirente formado por quatro números, solicite ao seu provedor caso não saiba qual o seu Merchant Category Code. |
Responses
Request samples
- Payload
{- "mcc": "string"
}
Através da API de flows
é possível recuperar detalhes de um Fluxo ou listar todas os Fluxos cadastrados em determinado clientId
.
Os fluxos inteligentes são um recurso disponibilizado pela Malga para gestão dos pagamentos, possibilitando a configuração e a inserção de regras e condicionais personalizados para processamento das cobranças. Para mais informações, consulte a documentação link.
Recuperar todos os fluxos paginado
Authorizations:
query Parameters
page | number número da página |
limit | number quantidade de itens por página |
merchantId | string usado para filtrar os fluxos por merchantId |
paymentMethod | string usado para filtrar os fluxos por método de pagamento |
Responses
Response Schema: application/json
Array of objects[ items ] | |||||||||||||||||
Array
| |||||||||||||||||
object | |||||||||||||||||
|
Response samples
- 200
- 400
- 500
{- "items": [
- {
- "id": "b4ced0dd-2136-4bce-a231-364e93554073",
- "paymentMethod": "credit",
- "clientId": "f1babb21-6a4c-323d-12db-69d3af407ee1",
- "merchants": [
- {
- "merchantId": "z1babb21-6a4c-987d-89db-11d3af737ee1"
}
], - "parentId": "g1babb21-6a4c-987d-89db-11d3af737ee1",
- "createdAt": "2023-03-22T20:45:06.020Z",
- "flow": {
- "version": "0.0.0",
- "root": [
- {
- "rule": "provider",
- "id": "z1babb21-6a4c-987d-89db-11d3af737ee1"
}
]
}, - "restoredFrom": "df601922-e024-6394-8f12-af21ec4218b1"
}
], - "meta": {
- "itemCount": 10,
- "totalItems": 20,
- "itemsPerPage": 10,
- "totalPages": 5,
- "currentPage": 2
}
}
Consultar um fluxo pelo id
Authorizations:
path Parameters
id required | string <uuid> flow id |
Responses
Response Schema: application/json
id | string identificador único do fluxo | ||
paymentMethod | string método de pagamento a qual aquele fluxo é relacionado | ||
clientId | string identificador do cliente dono do fluxo | ||
Array of objects[ items ] | |||
Array
| |||
parentId | string identificador do fluxo que originou o novo | ||
restoredFrom | string identificador do fluxo do qual este foi restaurado | ||
createdAt | string data e hora em que o fluxo foi criado (UTC) | ||
flow | object dados do fluxo que será cadastrado |
Response samples
- 200
- 500
{- "sumary": "Exemplo de resposta para busca de flow",
- "value": {
- "id": "b4ced0dd-2136-4bce-a231-364e93554073",
- "merchants": [
- {
- "merchantId": "z1babb21-6a4c-987d-89db-11d3af737ee1"
}
], - "paymentMethod": "credit",
- "clientId": "f1babb21-6a4c-323d-12db-69d3af407ee1",
- "parentId": "g1babb21-6a4c-987d-89db-11d3af737ee1",
- "createdAt": "2023-03-22T20:45:06.020Z",
- "flow": {
- "version": "0.0.0",
- "root": [
- {
- "rule": "provider",
- "id": "z1babb21-6a4c-987d-89db-11d3af737ee1"
}
]
}, - "restoredFrom": "df601922-e024-6394-8f12-af21ec4218b1"
}
}
Através da API Reports, é possível realizar a exportação das informações das transações processadas através da Malga em arquivo .csv, relacionadas à cobrança [charges], o pagamento [transaction], o link de pagamento [session] e cliente [customer] que realizou o pagamento
Exportar dados da base
Authorizations:
header Parameters
accept-language | string Default: en-US Enum: "en-US" "pt-BR" Idioma da exportação |
X-User-Timezone | string Default: America/Sao_Paulo Timezone local do cliente no formato tz database |
Request Body schema: application/json
sendTo | email E-mail para qual a exportação será enviada | ||||||||||||||||||
type | string Value: "transactions" Tabela de dados que será exportada | ||||||||||||||||||
fields | array Items Enum: "card_brand__brand" "card__number" "card__holder_name" "customer__client_id" "customer__name" "customer__email" "customer__phone_number" "customer__document_number" "customer__customer_adress_id" "customer_address__street" "customer_address__street_number" "customer_address__complement" "customer_address__zip_code" "customer_address__state" "customer_address__city" "customer_address__district" "customer_address__country" "nupay__payment_type" "provider__name" "session__id" "transaction__id" "transaction__currency" "transaction__created_at" "transaction__order_id" "transaction__merchant_id" "transaction__description" "transaction__original_amount" "transaction__amount" "transaction__installments" "transaction__status" "transaction__statement_descriptor" "transaction_request__created_at" "transaction_request__payment_method" "transaction_request__provider_id" Campos que serão exportados | ||||||||||||||||||
object Filtros que serão aplicados aos dados para a exportação | |||||||||||||||||||
|
Responses
Request samples
- Payload
{- "sendTo": "user@example.com",
- "type": "transactions",
- "fields": [
- "card_brand__brand",
- "card__holder_name"
], - "filters": {
- "transactionRequestPaymentMethod": [
- "pix"
], - "transactionStatus": [
- "authorized"
], - "transactionProviderId": "804ecc4d-2801-4873-9bd9-5846df12818e",
- "transactionId": "659fc737-0715-45c2-a0ef-d265aeb7633c",
- "transactionCreatedAt": {
- "gte": "2019-08-24T14:15:22Z",
- "lte": "2019-08-24T14:15:22Z"
}, - "transactionMerchantId": "c5ec17c6-4be7-42ba-8e07-b8b27d992bfd"
}
}
Response samples
- 201
- 400
- 500
{- "id": "3a4f49ca-f714-4ed5-b415-6556d87645f6",
- "clientId": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "email": "user@example.com",
- "language": "pt-BR",
- "status": "pending",
- "pagesCount": null,
- "files": null,
- "fields": [
- "transaction__id",
- "transaction__created_at",
- "transaction__status",
- "card_brand__brand"
], - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "expiredAt": "2019-08-24T14:15:22Z",
- "timezone": "America/Sao_Paulo",
- "filters": {
- "transactionRequestPaymentMethod": [
- "pix"
], - "transactionStatus": [
- "authorized"
], - "transactionProviderId": "804ecc4d-2801-4873-9bd9-5846df12818e",
- "transactionId": "659fc737-0715-45c2-a0ef-d265aeb7633c",
- "transactionCreatedAt": {
- "gte": "2019-08-24T14:15:22Z",
- "lte": "2019-08-24T14:15:22Z"
}, - "transactionMerchantId": "c5ec17c6-4be7-42ba-8e07-b8b27d992bfd"
}
}
Recuperar detalhes de uma exportação
Authorizations:
path Parameters
id required | string <uuid> Id da exportação |
Responses
Response Schema: application/json
id | string Id da exportação | ||||||||||||||||||
clientId | string Identificador do cliente na Malga | ||||||||||||||||||
email E-mail para qual a exportação foi enviada | |||||||||||||||||||
language | string Enum: "pt-BR" "en-US" Língua usada para montar a tabela de dados | ||||||||||||||||||
status | array Items Enum: "created" "pending" "processing" "uploaded" "sent" "opened" "expired" "error" "empty" | ||||||||||||||||||
pagesCount | number Número de arquivos gerados | ||||||||||||||||||
files | array Lista do nome dos arquivos gerados | ||||||||||||||||||
fields | array Items Enum: "card_brand__brand" "card__holder_name" "customer__client_id" "customer__name" "customer__email" "customer__phone_number" "customer__document_number" "customer__customer_adress_id" "customer_address__complement" "customer_address__zip_code" "customer_address__street" "customer_address__street_number" "customer_address__state" "customer_address__city" "customer_address__district" "customer_address__country" "nupay__payment_type" "transaction__id" "transaction__amount" "transaction__original_amount" "transaction__created_at" "transaction__currency" "transaction__description" "transaction__order_id" "transaction__merchant_id" "transaction_request__created_at" "transaction_request__payment_method" "transaction_request__provider_id" "transaction__installments" "transaction__status" "transaction_source__card_id" "transaction__statement_descriptor" "provider__name" "session__id" Lista de filtros que foram exportados | ||||||||||||||||||
createdAt | string <2023-04-01T00:00:00Z> Data da criação | ||||||||||||||||||
updatedAt | string <2023-04-01T00:01:00Z> Data da atualização | ||||||||||||||||||
expiredAt | string <2023-05-01T00:00:00Z> Data de expiração dos links para download dos arquivos | ||||||||||||||||||
timezone | string <America/Sao_Paulo> Timezone utilizado para as datas | ||||||||||||||||||
object Filtros que foram aplicados aos dados para a exportação | |||||||||||||||||||
|
Response samples
- 200
- 400
- 404
- 500
{- "id": "3a4f49ca-f714-4ed5-b415-6556d87645f6",
- "clientId": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "email": "user@example.com",
- "language": "pt-BR",
- "status": "sent",
- "pagesCount": 1,
- "fields": [
- "transaction__id",
- "transaction__created_at",
- "transaction__status",
- "card_brand__brand"
], - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "expiredAt": "2019-08-24T14:15:22Z",
- "timezone": "America/Sao_Paulo",
- "filters": {
- "transactionRequestPaymentMethod": [
- "pix"
], - "transactionStatus": [
- "authorized"
], - "transactionProviderId": "804ecc4d-2801-4873-9bd9-5846df12818e",
- "transactionId": "659fc737-0715-45c2-a0ef-d265aeb7633c",
- "transactionCreatedAt": {
- "gte": "2019-08-24T14:15:22Z",
- "lte": "2019-08-24T14:15:22Z"
}, - "transactionMerchantId": "c5ec17c6-4be7-42ba-8e07-b8b27d992bfd"
}
}
Fazer download de um arquivo
Os arquivos podem ser baixados durante um período de até 30 dias após a data de exportação. Depois desse período, os arquivos não estarão mais disponíveis para download.
Authorizations:
path Parameters
id required | string <uuid> Id da exportação |
pageNumber required | int Número da página |
Responses
Response Schema: application/csv
Response samples
- 200
- 307
- 400
- 404
- 410
- 500
Data da Criação, ID da Cobrança, ID do pedido, Subconta, Descrição, Data do Pagamento, Método de Pagamento, ID do provedor, Provedor, Moeda, Valor Original, Valor Final, Parcelas, Status, Descrição no Recibo, ID do Cliente, Nome, Email, Telefone, Documento, ID Endereço, Endereço, Número, Complemento, CEP, Estado, Cidade, Bairro, País
Provedor | Cartão | Boleto | Pix | Split | 3DS2 | Descrição |
---|---|---|---|---|---|---|
ADYEN |
SIM | SIM | SIM | NÃO | SIM | Adyen |
BB |
NÃO | NÃO | SIM | NÃO | NÃO | Banco do Brasil |
BRAINTREE |
SIM | NÃO | NÃO | NÃO | NÃO | Braintree |
BRASPAG |
SIM | NÃO | NÃO | SIM | NÃO | Braspag |
BS2_BOLETO |
NÃO | SIM | NÃO | NÃO | NÃO | Banco BS2 Boleto |
BS2 |
NÃO | NÃO | SIM | NÃO | NÃO | Banco BS2 Pix |
CIELO |
SIM | NÃO | NÃO | NÃO | NÃO | Cielo |
GETNET |
SIM | SIM | SIM | NÃO | NÃO | Getnet |
KLAP |
SIM | NÃO | NÃO | NÃO | NÃO | Klap |
MERCADO_PAGO |
SIM | SIM | SIM | NÃO | NÃO | Mercado pago |
PAGARME |
SIM | SIM | SIM | SIM | NÃO | Pagar.me |
PAGSEGURO |
SIM | NÃO | SIM | NÃO | NÃO | PagSeguro |
REDE |
SIM | NÃO | NÃO | NÃO | NÃO | Rede |
STRIPE |
SIM | SIM | NÃO | NÃO | NÃO | Stripe |
ZOOP |
SIM | SIM | SIM | SIM | NÃO | Zoop |
SANDBOX |
SIM | SIM | SIM | SIM | SIM | Simulador ambiente de teste |
Provedor | Realtime | Assíncrono | Descrição |
---|---|---|---|
CLEARSALE |
SIM | NÃO | Clearsale Realtime Decision e Behaviour Analytics |
DeclinedCode | ResponseMessage | O que fazer (ABECS) |
---|---|---|
card_not_supported | The card does not support this type of purchase | UTILIZE FUNÇÃO DÉBITO |
expired_card | The card expiration date is invalid | VERIFIQUE OS DADOS DO CARTÃO |
fraud_confirmed | The charge has been declined for confirmed fraud | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO - NÃO TENTE NOVAMENTE |
fraud_suspect | The charge has been declined for suspect it is fraudulent | CONTATE A CENTRAL DO SEU CARTÃO |
generic | The card has been declined for a unknown reason | CONTATE A CENTRAL DO SEU CARTÃO |
insufficient_funds | The card has insufficient funds | NÃO AUTORIZADA |
invalid_amount | The charge amount is not valid or exceeded maximum allowed | VALOR DA TRANSAÇÃO NÃO PERMITIDO - NÃO TENTE NOVAMENTE |
invalid_cvv | The security code is invalid | SENHA INVÁLIDA |
invalid_data | The card has been declined for invalid data | VERIFIQUE OS DADOS DO CARTÃO |
invalid_installment | The charge has been declined because invalid number of installments | PARCELAMENTO INVÁLIDO - NÃO TENTE NOVAMENTE |
invalid_merchant | The charge has been declined because merchant is not valid | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE |
invalid_merchant | The charge has been declined because merchant is not valid | CONTA ORIGEM INVÁLIDA - NÃO TENTE NOVAMENTE |
invalid_number | The card number is invalid | VERIFIQUE OS DADOS DO CARTÃO |
invalid_pin | The card has been declined because pin is invalid | SENHA INVÁLIDA - NÃO TENTE NOVAMENTE |
issuer_not_available | The card issuer could not be reached, charge not authorized | DADOS DO CARTÃO INVÁLIDO - NÃO TENTE NOVAMENTE |
lost_card | The card has been declined because the card is reported lost | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE |
not_permitted | The charge is not permited to the card | TRANSAÇÃO NÃO PERMITIDA PARA O CARTÃO- NÃO TENTE NOVAMENTE |
pickup_card | The card cannot be used to make this charges | CONTATE A CENTRAL DO SEU CARTÃO - NÃO TENTE NOVAMENTE |
pin_try_exceeded | The card has been declined because exceeded maximum pin tries | EXCEDIDAS TENTATIVAS DE SENHA.CONTATE A CENTRAL DO SEU CARTÃO |
restricted_card | The card cannot be used to make this charge | DESBLOQUEIE O CARTÃO |
security_violation | The card has been declined for a unknown reason | VERIFIQUE OS DADOS DO CARTÃO |
service_not_allowed | The card has been declined because do not support international charge | CARTÃO NÃO PERMITE TRANSAÇÃO INTERNACIONAL |
stolen_card | The card has been declined because the card is reported stolen | TRANSAÇÃO NÃO PERMITIDA - NÃO TENTE NOVAMENTE |
transaction_not_allowed | The card has been declined for a unknown reason | ERRO NO CARTÃO - NÃO TENTE NOVAMENTE |
try_again | The card has been declined for a unknown reason | REFAZER A TRANSAÇÃO |
MCC | Descrição |
---|---|
742 | VETERINARIA |
744 | Carefree Resorts |
763 | COOPERATIVA AGRÍCOLA |
780 | SERVIÇOS DE PAISAGISMO E HORTICULTURA |
1520 | EMPREITEIROS EM GERAL - COMERCIAL E RESIDENCIAL |
1711 | PREST. DE SERV. PARA AR COND., ENCANAMENTO E AQUEC. |
1731 | ELETRICISTAS E SERVIÇOS ELÉTRICOS |
1740 | PEDREIROS E SERVIÇOS DE INSTALAÇÃO |
1750 | MARCENEIROS E SERVIÇOS DE CARPINTARIA |
1761 | METALURGICOS |
1771 | EMPREITEIO PARA SERVIÇOS ESPECIALIZADO |
1799 | DEMAIS SVS DE REFORMA E CONSTRUÇÃO NÃO-CLASSIFICADOS |
2741 | EDITORAS - PUBLICAÇÕES E IMPRESSÕES |
2791 | TYPESETTING, PLATE MAKING AND RELATED SERVICES |
2842 | SERVIÇOS DE LIMPEZA E POLIMENTO |
4011 | TRANSPORTE FERROVIÁRIO DE CARGA |
4111 | TRANSPORTE LOCAL DE PASSAGEIROS, INCLUINDO BALSAS |
4112 | TRANSPORTE DE PASSAGEIROS EM TREM (LONGA DISTÂNCIA) |
4119 | AMBULANCIAS |
4121 | LIMUSINES E TÁXIS (TAXICABS AND LIMOUSINES) |
4131 | COMPANHIAS DE ONIBUS |
4214 | TRANSPORTE DE CARGA RODOVIÁRIO E ARMAZENAMENTO |
4215 | CORREIOS - AÉREO, TERRESTRE E TRANSITÓRIOS |
4225 | ARMAZENAM. PROD AGRÍCOLAS,MERCAD REFRIGERADAS,BENS DOMÉSTICO |
4411 | LINHAS DE CRUZEROS (CRUISE LINES) |
4457 | ALUGUEL E ARRENDAMENTO DE BARCOS, ESQUIS E IATES |
4468 | MARINAS, SERVIÇOS E FORNECEDORES |
4511 | OUTRAS CIAS AÉREAS |
4582 | AEROPORTOS E SERVIÇOS LIGADOS A AERONAVES |
4722 | AGÊNCIAS DE VIAGENS (TRAVEL AGENCIES) |
4723 | AGÊNCIAS DE VIAGEM TUI (TUI TRAVEL AGENCY) |
4784 | PEDÁGIOS |
4789 | SERVIÇOS DE TRANSPORTE |
4812 | TELEFONES E EQUIPAMENTOS DE TELECOMUN. |
4813 | SERVIÇOS DE TELEC.- CHAM. LOCAIS E LONGA DISTÂNCIA |
4814 | SERVIÇOS DE TELECOMUNICAÇÃO |
4816 | REDES DE COMPUTADORES / SERVIÇOS DE INFOR |