Adicionando o conector
Requisitos
- Este conector requer a versão V5 (2021-09-01) da API (também conhecida como Pagar.me 2.0)
- Você deve seguir este tutorial com o acesso de Administrador
Instruções
- Faça login em sua conta do Pagar.me com um usuário que possua acesso de Administrador
- Caso possua várias contas, na página de Empresas, selecione Empresas 2.0 > Produção > Sua conta
- Em sua conta, na lateral direita, clique em Configurações > Chaves
- Na página de Chaves, clique em Criar chave
- No modal que irá abrir, dê um nome para sua chave e em Acesso da chave escolha Personalizado e então clique em Avançar
- Na próxima tela, em Selecione os escopos faça o seguinte:
- Ative Transacional com permissão Somente leitura
- Ative Financeiro com permissão Somente leitura
- Ative Recebedores com permissão Somente leitura
- Clique em Criar chave
- Clique em Copiar chave secreta e depois Concluir
- Faça login na Kondado > clique em CRIAR + > Conector > Pagar.me > em Chave de API copie o valor obtido > clique em SALVAR
- IMPORTANTE: Caso utilize a funcionalidade de IPs permitidos, é necessário também seguir estas instruções
Integrações
Índice
Gráfico de relacionamento
Clique para ampliar
Clientes
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do cliente |
|
text |
[pt] Cidade. |
|
text |
[pt] País (Código do país no formato ISO 3166-1 alpha-2) (2 dígitos). |
|
timestamp |
[pt] Data de criação do endereço. |
|
text |
[pt] Identificador único do endereço. |
|
text |
[pt] Dados principais do endereço. Neste campo deve ser informado Número, Rua, Bairro, nesta ordem e separados por vírgula. |
|
text |
[pt] Dados complementares do endereço. Neste campo pode ser informado complemento, referências. |
|
text |
[pt] Estado (Código do estado no formato ISO 3166-2). |
|
text |
[pt] Status do endereço (ativo ou inativo). |
|
timestamp |
[pt] Data da última atualização do endereço. |
|
text |
[pt] Código Postal (CEP) (Apenas numérico). |
|
date |
[pt] Data de nascimento do cliente. Padrão mm/dd/aaaa. |
|
text |
[pt] Código de referência do cliente no sistema da loja. Máx: 52 caracteres. |
|
timestamp |
[pt] Data de criação do cliente no sistema. |
|
boolean |
[pt] Indica se o cliente está inadimplente. |
|
text |
[pt] CPF, CNPJ ou PASSPORT do cliente. Máx: 16 caracteres para CPF e CNPJ e Máx: 50 caracteres para PASSPORT. |
|
text |
[pt] Tipo de documento. Valores possíveis: CPF, CNPJ ou PASSPORT. |
|
text |
[pt] E-mail do cliente. Máx: 64 caracteres. |
|
text |
[pt] Nome do cliente. Máx: 64 caracteres. |
|
text |
[pt] Código do País do telefone residencial (Apenas numérico) |
|
text |
[pt] Código da área do telefone residencial (Apenas numérico). |
|
text |
[pt] Número do telefone residencial (Apenas numérico). |
|
text |
[pt] Código da área do telefone celular (Apenas numérico). |
|
text |
[pt] Código do País do telefone celular (Apenas numérico). |
|
text |
[pt] Código da área do telefone celular (Apenas numérico). |
|
text |
[pt] Tipo de cliente. Valores possíveis: individual (pessoa física) ou company (pessoa jurídica). Obrigatório, caso o document seja enviado. |
|
timestamp |
[pt] Data da última atualização dos dados do cliente. |
pagarme_customers_metadata
Clientes: cartões
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do cliente ao qual o cartão está associado. |
|
text |
[pt] Identificador único do cartão na API. |
|
text |
[pt] Bandeira do cartão. Valores possíveis: elo, mastercard, visa, amex, jcb, aura, hipercard, diners, unionpay, discover. |
|
timestamp |
[pt] Data e hora da criação do cartão |
|
text |
[pt] Mês de validade do cartão. |
|
text |
[pt] Ano de validade do cartão. |
|
text |
[pt] Os primeiros seis dígitos do número do cartão. |
|
text |
[pt] Nome do portador do cartão como impresso. Máx: 64 caracteres. |
|
text |
[pt] Os últimos quatro dígitos do número do cartão. |
|
text |
[pt] Status do cartão na API. Exemplo: ativo ou inativo. |
|
text |
[pt] Tipo do cartão. Exemplo: crédito ou débito. |
|
timestamp |
[pt] Data e hora da última atualização do cartão |
pagarme_customer_cards_metadata
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do cliente ao qual o cartão está associado. |
|
text |
[pt] Identificador único do cartão na API. |
|
text |
[pt] Chave do metadado. |
|
text |
[pt] Valor do metadado. |
Clientes: endereços
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Código do cliente. Formato: cus_XXXXXXXXXXXXXXXX. |
|
text |
[pt] Código do cliente. Formato: cus_XXXXXXXXXXXXXXXX. |
|
text |
[pt] Cidade do endereço. Máx: 64 caracteres. |
|
text |
[pt] Código do país no formato. |
|
timestamp |
[pt] Data e hora da criação. |
|
text |
[pt] Linha 1 do endereço. Deve conter Número, Rua e Bairro, nesta ordem e separados por vírgula. |
|
text |
[pt] Linha 2 do endereço. Complemento como Andar, Sala ou Apto. |
|
text |
[pt] Código do estado no formato. |
|
text |
[pt] Status na API. Exemplo: ativo ou inativo. |
|
timestamp |
[pt] Data e hora da última atualização. |
|
text |
[pt] CEP do endereço. Apenas numérico. |
pagarme_customer_addresses_metadata
Cobranças
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único da cobrança. |
|
float |
[pt] Valor total da cobrança. |
|
text |
[pt] Código da cobrança. |
|
timestamp |
[pt] Data e hora da criação da cobrança. |
|
text |
[pt] Moeda utilizada na cobrança. |
|
text |
[pt] Código de referência do cliente. |
|
timestamp |
[pt] Data e hora da criação do cliente. |
|
boolean |
[pt] Indica se o cliente está inadimplente. |
|
text |
[pt] Número do documento do cliente. |
|
text |
[pt] Tipo do documento do cliente. |
|
text |
[pt] E-mail do cliente. |
|
text |
[pt] Identificador único do cliente. |
|
text |
[pt] Nome do cliente. |
|
text |
[pt] Código do país do telefone residencial. |
|
text |
[pt] Número do telefone residencial. |
|
text |
[pt] Código de área do telefone residencial. |
|
text |
[pt] Tipo do cliente (pessoa física ou empresa). |
|
timestamp |
[pt] Data e hora da última atualização do cliente. |
|
text |
[pt] Identificador da cobrança no gateway de pagamento. |
|
text |
[pt] Mensagem do adquirente. |
|
text |
[pt] Nome do adquirente da transação. |
|
text |
[pt] NSU do adquirente. |
|
text |
[pt] Código de retorno do adquirente. |
|
text |
[pt] TID do adquirente. |
|
float |
[pt] Valor total da transação. |
|
text |
[pt] Identificador da bandeira do cartão. |
|
text |
[pt] Os últimos quatro dígitos do cartão. |
|
text |
[pt] Bandeira do cartão. |
|
text |
[pt] Nome do titular do cartão. |
|
text |
[pt] Mês de expiração do cartão. |
|
text |
[pt] Ano de expiração do cartão. |
|
text |
[pt] Status do cartão. |
|
text |
[pt] Tipo do cartão (crédito ou débito). |
|
timestamp |
[pt] Data e hora de criação do cartão. |
|
timestamp |
[pt] Data e hora da última atualização do cartão. |
|
text |
[pt] Os primeiros seis dígitos do cartão. |
|
timestamp |
[pt] Data e hora da criação da última transação. |
|
text |
[pt] Fonte de financiamento da transação. |
|
text |
[pt] Identificador da transação no gateway. |
|
text |
[pt] Identificador único da transação. |
|
float |
[pt] Número de parcelas da transação. |
|
text |
[pt] Tipo da operação da transação. |
|
text |
[pt] Descrição da transação exibida no extrato. |
|
text |
[pt] Status da transação. |
|
boolean |
[pt] Indica se a transação foi bem-sucedida. |
|
text |
[pt] Tipo da transação. |
|
timestamp |
[pt] Data e hora da última atualização da transação. |
|
float |
[pt] Valor total do pedido. |
|
boolean |
[pt] Indica se o pedido foi encerrado. |
|
timestamp |
[pt] Data e hora do fechamento do pedido. |
|
text |
[pt] Código do pedido. |
|
timestamp |
[pt] Data e hora da criação do pedido. |
|
text |
[pt] Moeda utilizada no pedido. |
|
text |
[pt] Identificador do cliente associado ao pedido. |
|
text |
[pt] Identificador único do pedido. |
|
text |
[pt] Status do pedido. |
|
timestamp |
[pt] Data e hora da última atualização do pedido. |
|
text |
[pt] Método de pagamento utilizado. |
|
text |
[pt] Status da cobrança. |
|
timestamp |
[pt] Data e hora da última atualização da cobrança. |
pagarme_last_transaction_metadata
Operações de saldo
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único da operação de saldo. |
|
float |
[pt] Valor total envolvido na operação de saldo. |
|
float |
[pt] Valor do saldo disponível após a operação. |
|
timestamp |
[pt] Data e hora da criação da operação de saldo. |
|
float |
[pt] Taxa cobrada na operação de saldo. |
|
float |
[pt] Valor total envolvido no objeto da operação de saldo. |
|
text |
[pt] Bandeira associada à operação de saldo. |
|
text |
[pt] Documento do destinatário da operação de saldo. |
|
text |
[pt] Tipo de documento do destinatário da operação de saldo. |
|
text |
[pt] Identificador do pagamento no motor externo associado à operação de saldo. |
|
text |
[pt] Identificador único do objeto relacionado à operação de saldo. |
|
text |
[pt] Identificador do arranjo de liquidação da operação de saldo. |
|
text |
[pt] Tipo do objeto relacionado à operação de saldo. |
|
text |
[pt] Produto relacionado à operação de saldo. |
|
text |
[pt] Tipo do objeto relacionado à operação de saldo. |
|
timestamp |
[pt] Tipo do objeto relacionado à operação de saldo. |
|
text |
[pt] Tipo do objeto relacionado à operação de saldo. |
|
text |
[pt] Tipo do objeto relacionado à operação de saldo. |
|
text |
[pt] Tipo do objeto relacionado à operação de saldo. |
|
text |
[pt] Tipo de destino da operação de saldo. |
|
float |
[pt] Taxa cobrada pela operação de saldo. |
|
text |
[pt] Identificador do destino da operação de saldo. |
|
text |
[pt] Tipo de origem da operação de saldo. |
|
text |
[pt] Identificador da origem da operação de saldo. |
|
timestamp |
[pt] Data estimada para a liquidação da operação de saldo. |
|
text |
[pt] Status atual da operação de saldo. |
|
text |
[pt] Dígito verificador da conta. |
|
text |
[pt] Número da conta. |
|
text |
[pt] Banco registrado. |
|
text |
[pt] Número da agência. |
|
timestamp |
[pt] Data de criação da conta. |
|
text |
[pt] Documento do titular. |
|
text |
[pt] Nome do titular. |
|
text |
[pt] Tipo de titularidade. |
|
text |
[pt] Tipo da conta. |
|
text |
[pt] Status da operação de saldo. |
|
text |
[pt] Tipo da operação de saldo. |
Pedidos
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do objeto na API. |
|
text |
[pt] Identificador único do cliente. |
|
float |
[pt] Valor total da transação. Padrão: 0. |
|
boolean |
[pt] Indica se a transação está encerrada. Padrão: true. |
|
timestamp |
[pt] Data e hora do fechamento da transação. |
|
text |
[pt] Código de referência do objeto. |
|
timestamp |
[pt] Data e hora da criação da transação. |
|
text |
[pt] Moeda da transação. |
|
text |
[pt] Identificador único do endereço. |
|
text |
[pt] Linha 1 do endereço. Número, Rua e Bairro. |
|
text |
[pt] Linha 2 do endereço. Complemento. |
|
text |
[pt] CEP do endereço. |
|
text |
[pt] Cidade do endereço. |
|
text |
[pt] Código do país do endereço. |
|
timestamp |
[pt] Data e hora da criação do endereço. |
|
text |
[pt] Código do estado do endereço. |
|
timestamp |
[pt] Data e hora da última atualização do endereço. |
|
text |
[pt] Status do endereço. |
|
text |
[pt] Código de referência do cliente. |
|
timestamp |
[pt] Data e hora da criação do cliente. |
|
boolean |
[pt] Indica se o cliente está inadimplente. Padrão: true. |
|
text |
[pt] Documento do cliente (CPF/CNPJ). |
|
text |
[pt] Tipo de documento do cliente. |
|
text |
[pt] E-mail do cliente. |
|
text |
[pt] Nome do cliente. |
|
text |
[pt] Código do país do telefone residencial. |
|
text |
[pt] Código da área do telefone residencial. |
|
text |
[pt] Número do telefone residencial. |
|
text |
[pt] Código do país do telefone celular. |
|
text |
[pt] Código da área do telefone celular. |
|
text |
[pt] Número do telefone celular. |
|
text |
[pt] Tipo de cliente (individual ou company). |
|
timestamp |
[pt] Data e hora da última atualização do cliente. |
|
text |
[pt] Status da transação. |
|
timestamp |
[pt] Data e hora da última atualização da transação. |
pagarme_orders_charges
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do objeto na API. |
|
text |
[pt] Identificador único da cobrança. |
|
text |
[pt] Identificador único do cliente da cobrança. |
|
float |
[pt] Valor total da cobrança. Padrão: 0. |
|
text |
[pt] Código da cobrança. |
|
timestamp |
[pt] Data e hora da criação da cobrança. |
|
text |
[pt] Moeda da cobrança. |
|
text |
[pt] Nome do cliente da cobrança. |
|
text |
[pt] E-mail do cliente da cobrança. |
|
text |
[pt] Código de referência do cliente da cobrança. |
|
text |
[pt] Documento do cliente da cobrança. |
|
text |
[pt] Tipo de documento do cliente da cobrança. |
|
text |
[pt] Tipo de cliente da cobrança (individual ou company). |
|
boolean |
[pt] Indica se o cliente da cobrança está inadimplente. Padrão: false. |
|
timestamp |
[pt] Data e hora da criação do cliente da cobrança. |
|
timestamp |
[pt] Data e hora da última atualização do cliente da cobrança. |
|
text |
[pt] Identificador único do endereço do cliente da cobrança. |
|
text |
[pt] Linha 1 do endereço do cliente da cobrança. Número, Rua e Bairro. |
|
text |
[pt] Linha 2 do endereço do cliente da cobrança. Complemento. |
|
text |
[pt] CEP do endereço do cliente da cobrança. |
|
text |
[pt] Cidade do endereço do cliente da cobrança. |
|
text |
[pt] Código do estado do endereço do cliente da cobrança. |
|
text |
[pt] Código do país do endereço do cliente da cobrança. |
|
text |
[pt] Status do endereço do cliente da cobrança. |
|
timestamp |
[pt] Data e hora da criação do endereço do cliente da cobrança. |
|
timestamp |
[pt] Data e hora da última atualização do endereço do cliente da cobrança. |
|
text |
[pt] Código do país do telefone residencial do cliente da cobrança. |
|
text |
[pt] Número do telefone residencial do cliente da cobrança. |
|
text |
[pt] Código da área do telefone residencial do cliente da cobrança. |
|
text |
[pt] Número do telefone celular do cliente da cobrança. |
|
text |
[pt] Código do país do telefone celular do cliente da cobrança. |
|
text |
[pt] Código da área do telefone celular do cliente da cobrança. |
|
text |
[pt] Identificador da transação no gateway de pagamento. |
|
text |
[pt] Identificador da bandeira do cartão. |
|
text |
[pt] Identificador único da transação. |
|
text |
[pt] Tipo da transação. |
|
text |
[pt] Identificador da transação no gateway. |
|
float |
[pt] Valor total da transação. |
|
text |
[pt] Status da transação. |
|
boolean |
[pt] Indica se a transação foi bem-sucedida. |
|
float |
[pt] Número de parcelas da transação. |
|
text |
[pt] Descrição que aparecerá no extrato bancário. |
|
text |
[pt] Nome do adquirente da transação. |
|
text |
[pt] TID do adquirente. |
|
text |
[pt] NSU do adquirente. |
|
text |
[pt] Mensagem do adquirente. |
|
text |
[pt] Código de retorno do adquirente. |
|
text |
[pt] Tipo da operação da transação. |
|
text |
[pt] Identificador único do cartão. |
|
text |
[pt] Os primeiros seis dígitos do cartão. |
|
text |
[pt] Os últimos quatro dígitos do cartão. |
|
text |
[pt] Bandeira do cartão. |
|
text |
[pt] Nome do titular do cartão. |
|
text |
[pt] Mês de expiração do cartão. |
|
text |
[pt] Ano de expiração do cartão. |
|
text |
[pt] Status do cartão. |
|
text |
[pt] Tipo do cartão (crédito ou débito). |
|
timestamp |
[pt] Data e hora de criação do cartão. |
|
timestamp |
[pt] Data e hora da última atualização do cartão. |
|
text |
[pt] Fonte de financiamento da transação. |
|
timestamp |
[pt] Data e hora da criação da última transação. |
|
timestamp |
[pt] Data e hora da última atualização da transação. |
|
text |
[pt] Código de resposta do gateway de pagamento. |
|
text |
[pt] Método de pagamento utilizado. |
|
text |
[pt] Status da cobrança. |
|
timestamp |
[pt] Data e hora da última atualização da cobrança. |
pagarme_orders_charges_last_transaction_metadata
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do objeto na API. |
|
text |
[pt] Chave do id de charge. |
|
text |
[pt] Chave do metadata. |
|
text |
[pt] Chave do id de last_transaction. |
|
text |
[pt] Valor do metadata. |
pagarme_orders_items
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do objeto na API. |
|
text |
[pt] Identificador único do item. |
|
float |
[pt] Valor do item. Padrão: 0. |
|
text |
||
timestamp |
[pt] Data e hora da criação do item. |
|
text |
[pt] Descrição do item. |
|
float |
[pt] Quantidade do item. Padrão: 0. |
|
text |
[pt] Status do item. |
|
text |
[pt] Tipo do item. |
|
timestamp |
[pt] Data e hora da última atualização do item. |
Recebedores
Objeto principal
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do recebedor na API. |
|
float |
[pt] Número de dias de atraso para a antecipação automática. |
|
boolean |
[pt] Indica se a antecipação automática está ativada. |
|
text |
[pt] Tipo de antecipação automática configurada. |
|
float |
[pt] Percentual do volume antecipado automaticamente. |
|
timestamp |
[pt] Data e hora da criação dos registros bancários do recebedor. |
|
text |
[pt] Dígito verificador da conta bancária. |
|
text |
[pt] Número da conta do recebedor. |
|
text |
[pt] Código do banco da conta bancária cadastrada. |
|
text |
[pt] Número da agência da conta bancária cadastrada. |
|
timestamp |
[pt] Data e hora da criação da conta do recebedor. |
|
text |
[pt] Documento do proprietário da conta bancária. |
|
text |
[pt] Nome do proprietário da conta bancária. |
|
text |
[pt] Tipo do proprietário da conta bancária. |
|
text |
[pt] Id da conta bancária do recebedor. |
|
text |
[pt] Status da conta bancária do recebedor. |
|
text |
[pt] Tipo da conta bancária do recebedor. |
|
timestamp |
[pt] Data e hora da última atualização do recebedor. |
|
text |
[pt] Documento do recebedor. |
|
text |
[pt] Status da verificação de identidade. |
|
text |
[pt] Motivo do status da verificação de identidade. |
|
text |
[pt] Nome do recebedor. |
|
text |
[pt] Forma de pagamento. |
|
text |
[pt] Nome do recebedor. |
|
text |
[pt] Documento do recebedor. |
|
text |
[pt] Email principal do recebedor. |
|
text |
[pt] Cidade do endereço principal do recebedor. |
|
text |
[pt] Complemento do endereço principal do recebedor. |
|
text |
[pt] Bairro do endereço principal do recebedor. |
|
text |
[pt] Estado do endereço principal do recebedor. |
|
text |
[pt] Rua do endereço principal do recebedor. |
|
text |
[pt] Número do endereço principal do recebedor. |
|
text |
[pt] CEP do endereço principal do recebedor. |
|
text |
[pt] URL do site . |
|
text |
[pt] Nome . |
|
text |
[pt] . |
|
text |
[pt] Status do recebedor. |
|
float |
[pt] Dia da transferência. |
|
boolean |
[pt] Indica se a transferência automática de saldo está habilitada. |
|
text |
[pt] Intervalo das transferências automáticas. |
|
text |
[pt] Tipo do recebedor. |
|
timestamp |
[pt] Data e hora da última atualização do recebedor. |
pagarme_recipients_gateway_recipients
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do gateway na API. |
|
text |
[pt] Identificador do destinatário no gateway de pagamento. |
|
timestamp |
[pt] Data e hora da criação do destinatário no gateway de pagamento. |
|
text |
[pt] Nome do gateway de pagamento associado ao destinatário. |
|
text |
[pt] Status do gateway do recipiente. |
|
timestamp |
[pt] Data e hora da última atualização do gateway do recipiente. |
pagarme_recipient_metadata
Recebíveis
Campo | Tipo | |
---|---|---|
text |
[pt] Identificador único do recebível. |
|
timestamp |
[pt] Data e hora do repasse do recebível ao destinatário. |
|
float |
[pt] Valor total do recebível. |
|
float |
[pt] Taxa de antecipação do recebível. |
|
text |
[pt] Identificador da cobrança associada ao recebível. |
|
timestamp |
[pt] Data e hora da criação do recebível. |
|
float |
[pt] Taxa cobrada sobre o recebível. |
|
float |
[pt] Taxa de cobertura contra fraudes aplicada ao recebível. |
|
text |
[pt] Identificador da transação no gateway associada ao recebível. |
|
float |
[pt] Número da parcela do recebível. |
|
timestamp |
[pt] Data e hora prevista para o pagamento do recebível. |
|
text |
[pt] Método de pagamento utilizado para o recebível. |
|
text |
[pt] Identificador do destinatário do recebível. |
|
text |
[pt] Status do recebível. |
|
text |
[pt] Tipo do recebível. |
Notas
IPs permitidos
Caso utilize bloqueio de IP em sua conta, faça o seguinte:
- Na barra lateral, acesse CONFIGURAÇÕES > Conta
- Na página de Conta, vá para a seção Conta e clique em Editar
- Encontre a seção IPs permitidos e inclua todos os IPs listados aqui (lembre-se de não incluir o “/32”)
- Ao finalizar clique em Salvar alterações
Descrição dos campos
Devido à ausência de descrição de alguns campos na documentação da API, parte das descrições foi gerada com inteligência artificial com exemplos dos valores retornados
Beta
Este conector está em modo beta - nos avise se encontrar um resultado inesperado