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.

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.

  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:

Retorno da chamada de criação da chave pública:

Dados básicos de uma requisição de criação de card token

Dados básicos de um objeto cartão

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 o customer 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 como paymentSource 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

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